Demonstração
Implementação de referência
A implementação de referência da observabilidade com Grafana fica 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 os datasources do Grafana (datasources.yml).
Essas configurações são consumidas pelo arquivo 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 Executando a aplicação):
docker compose -f compose-grafana.yml up --build- UI do Grafana: http://localhost:3000 — credenciais padrão
admin/admin - A API da aplicação: http://localhost:18000/docs
O que observar: spans HTTP por requisição, chamadas de LLM do LangChain aninhadas com uso de tokens, instruções do SQLAlchemy e logs da aplicação no Loki. O que é instrumentado e por quê: o guia de observabilidade.
Observação: esta implementação é apenas uma referência. Em um cenário real de produção, leve em conta as configurações de privacidade e segurança — autenticação, autorização e criptografia.