How luangitdev/monitoramento-e-logs-com-docker works
Project type and purpose
• This is not a classic “frontend-backend” app but an end-to-end observability demo: a simple Flask web service instrumented for metrics and logging, orchestrated alongside Prometheus, Grafana, Elasticsearch, Logstash and Kibana using Docker Compose.
File structure
• app.py & requirements.txt – the Flask service, instrumented by prometheus-flask-exporter, writing logs to app.log
• prometheus.yml – scrape configuration for Prometheus to pull metrics from Flask
• logstash.conf – pipeline that reads app.log and ships it to Elasticsearch
• Dockerfile & docker-compose.yml – build and orchestrate six containers (Flask, Prometheus, Grafana, Elasticsearch, Logstash, Kibana)
• README.md – describes the workflow, target ports, and manual setup steps in Grafana/Kibana
README for additional insights
• Metrics pipeline: Flask → /metrics → Prometheus → Grafana
• Logs pipeline: Flask writes to app.log → Logstash → Elasticsearch → Kibana
• All services run on a single Docker network defined by docker-compose
a. Main components:
• Client/User (browser or API consumer)
• Flask Application Container
• Prometheus Container
• Grafana Container
• Logstash Container
• Elasticsearch Container
• Kibana Container
• (Implicit) Docker Engine / Docker Compose orchestrator
b. Relationships & data flows:
• Client → HTTP → Flask app (port 5000)
• Flask app exposes /metrics → Prometheus scrapes it (port 9090)
• Grafana queries Prometheus as data source
• Flask writes logs to volume-mounted app.log → Logstash tail-reads it → forwards to Elasticsearch (bulk API)
• Kibana queries Elasticsearch index (docker-logs)
c. Architectural patterns & design principles:
• Micro-services style: each concern lives in its own container
• Separation of concerns: metrics vs. logs pipelines
• Immutable, declarative infrastructure (Docker Compose)
• Standard observability stack
d. Key technologies/frameworks to annotate:
• Docker & Docker Compose (orchestration layer)
• Flask + prometheus-flask-exporter (instrumentation)
• Prometheus (time-series DB)
• Grafana (metrics visualization)
• Logstash (log ingestion pipeline)
• Elasticsearch (document store & search)
• Kibana (log visualization)
Elements
– Blue for the application container
– Green for metrics components
– Orange for log-processing components
– Gray for orchestration (Docker)