monitoring/ — observabilidade do workspace local com OpenTelemetry Collector, Prometheus, Loki, Tempo, Grafana e cAdvisor; como ativar, ligar a telemetria e usar o Grafana.
A stack Monitoring dá observabilidade a todo o workspace: métricas, logs e traces dos serviços e dos teus projetos, num só Grafana. É opcional e arranca depois da stack principal.
| Compose | Ambiente |
|---|---|
monitoring/igrp-monitoring-compose.yaml | monitoring/.env_monitoring |
Serviços
| Serviço | Papel |
|---|---|
otel-collector | Recebe a telemetria das aplicações (OTLP: gRPC 4317, HTTP 4318) e encaminha-a |
prometheus | Métricas |
loki | Logs |
tempo | Traces — e métricas derivadas dos spans, incluindo o service graph |
cadvisor | Métricas dos contentores Docker (CPU, memória, rede) |
grafana | Painéis sobre os três — em /grafana |
aplicações ──OTLP──▶ otel-collector ──▶ Prometheus (métricas)
├─▶ Loki (logs)
└─▶ Tempo (traces)
cAdvisor ─────────────────────────────▶ Prometheus
Grafana ◀── consulta os trêsAtivar e arrancar
Escolhe Monitoring ao criar o workspace, ou acrescenta-a depois em Serviços → Docker → Add Stack → Monitoring Stack. Arranca e para pelo grupo Monitoring em Serviços → Visão Geral.
Ligar a telemetria das aplicações
Desligada por defeito
Sem esta stack não há collector, por isso as aplicações vêm com a telemetria desligada. Com a stack a correr, só o cAdvisor envia dados até ligares cada serviço.
As aplicações Spring controlam a telemetria por OTEL_DISABLED; o endpoint do collector já vem configurado. Para ligar, passa a variável a false no env-file e reinicia o serviço:
| Serviço | Variável | Ficheiro |
|---|---|---|
| Access Management | ACCESS_MANAGEMENT_OTEL_DISABLED | .env |
| Process Management API | PROCESS_MANAGEMENT_OTEL_DISABLED | process/.env_process |
| Process Studio API | PROCESS_STUDIO_OTEL_DISABLED | process/.env_process |
| Os teus backends Spring Boot | OTEL_DISABLED (gerado em todos os projetos, com OTEL_EXPORTER_OTLP_ENDPOINT já apontado ao collector) | env-file do projeto em projects/<projeto>/ |
O endpoint é sempre http://<slug>-otel-collector:4318.
Grafana
Abre http://<slug>:<porta>/grafana. As credenciais de administração estão em monitoring/.env_monitoring (GRAFANA_ADMIN_USER / GRAFANA_ADMIN_PASSWORD). Os datasources — Prometheus, Loki e Tempo — são provisionados automaticamente; não há nada a configurar para começar a explorar.
A configuração de cada componente está em monitoring/monitoring/ (collector/, prometheus/, tempo/, grafana/provisioning/).
Última atualização: