Demonstração
Implementação de referência
A implementação de referência da observabilidade com Grafana encontra-se no diretório
otel/grafana/: a configuração do OpenTelemetry Collector (otel-config.yml), a
configuração de scrape do Prometheus (prometheus.yml), o armazenamento de traces do
Tempo (tempo.yml) e as fontes de dados do Grafana (datasources.yml).
Estas definições são consumidas pelo ficheiro compose-grafana.yml, que inicia a
aplicação com a stack completa — OpenTelemetry Collector (OTLP em :4317/:4318),
Prometheus, Tempo, Loki e Grafana.
Execute-o e abra os dashboards (consulte Executar a aplicação):
docker compose -f compose-grafana.yml up --build- UI do Grafana: http://localhost:3000 — credenciais
predefinidas
admin/admin - API da aplicação: http://localhost:18000/docs
O que observar: spans HTTP por pedido, chamadas LLM do LangChain aninhadas com utilização de tokens, instruções SQLAlchemy e registos da aplicação no Loki. O que é instrumentado e porquê: o guia de observabilidade.
Nota: esta implementação é apenas uma referência. Num cenário real de produção, tenha em conta as definições de privacidade e segurança — autenticação, autorização e encriptação.