# luangitdev/monitoramento-e-logs-com-docker architecture

> Architecture diagram of the GitHub repository luangitdev/monitoramento-e-logs-com-docker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luangitdev/monitoramento-e-logs-com-docker
- Repository: https://github.com/luangitdev/monitoramento-e-logs-com-docker

## Overview

##### 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)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Docker Network"  
        direction TB
        subgraph "Application Layer"
            direction LR
            Client["Client/User"]:::client
            Flask["Flask App\n(port 5000)"]:::app
        end
        subgraph "Metrics Layer"
            direction LR
            Prometheus["Prometheus\n(scrape :9090)"]:::metrics
            Grafana["Grafana\n(port 3000)"]:::metrics
        end
        subgraph "Logging Layer"
            direction LR
            Logstash["Logstash"]:::logging
            Elasticsearch["Elasticsearch\n(port 9200)"]:::logging
            Kibana["Kibana\n(port 5601)"]:::logging
        end
    end

    Client -->|"HTTP GET /"| Flask
    Prometheus -->|"HTTP GET /metrics"| Flask
    Flask -->|"expose /metrics"| Prometheus
    Grafana -->|"query Prometheus"| Prometheus
    Flask -->|"write logs to app.log"| Logstash
    Logstash -->|"bulk API"| Elasticsearch
    Kibana -->|"search logs"| Elasticsearch

    %% Configuration file attachments
    PrometheusConfig["prometheus.yml"]:::config
    LogstashConfig["logstash.conf"]:::config
    DockerComposeConf["docker-compose.yml"]:::config
    README["README.md"]:::config

    PrometheusConfig -.-> Prometheus
    LogstashConfig -.-> Logstash
    DockerComposeConf -.-> Client
    DockerComposeConf -.-> Flask
    DockerComposeConf -.-> Prometheus
    DockerComposeConf -.-> Grafana
    DockerComposeConf -.-> Logstash
    DockerComposeConf -.-> Elasticsearch
    DockerComposeConf -.-> Kibana
    README -.-> Client

    %% Click Events
    click Flask "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/app.py"
    click Flask "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/requirements.txt"
    click Flask "https://github.com/luangitdev/monitoramento-e-logs-com-docker/tree/main/Dockerfile"
    click Prometheus "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/prometheus.yml"
    click Prometheus "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/docker-compose.yml"
    click Grafana "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/docker-compose.yml"
    click Logstash "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/logstash.conf"
    click Logstash "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/docker-compose.yml"
    click Elasticsearch "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/docker-compose.yml"
    click Kibana "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/docker-compose.yml"
    click DockerComposeConf "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/docker-compose.yml"
    click README "https://github.com/luangitdev/monitoramento-e-logs-com-docker/blob/main/README.md"

    %% Styles
    classDef client fill:#CFD8DC,stroke:#455A64,color:#263238
    classDef app fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1
    classDef metrics fill:#C8E6C9,stroke:#1B5E20,color:#1B5E20
    classDef logging fill:#FFE0B2,stroke:#E65100,color:#E65100
    classDef config fill:#ECEFF1,stroke:#90A4AE,stroke-dasharray: 4 2,color:#37474F
    classDef default stroke:#888,stroke-width:1px;color:#000000
```
