> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Observability

> Monitore métricas, logs e traces do Midaz com OpenTelemetry, Client Collectors e a stack de observabilidade gerenciada da Lerian com Prometheus, Loki, Tempo e Grafana.

A observabilidade no **Midaz** permite monitorar métricas, logs e traces nos seus ambientes onde você fez o deploy.

O Midaz coleta telemetria com o **framework OpenTelemetry**. Um **Client Collector** na sua infraestrutura processa esses dados. O collector então os encaminha com segurança para a stack gerenciada da Lerian: Prometheus, Loki, Tempo e Grafana.

## Como funciona

***

O Midaz usa um **modelo de observabilidade dual**:

* **Lado do cliente**: para desenvolvimento local, a configuração do collector fica em `components/infra/grafana/otelcol-config.yaml`, montada como somente leitura no container all-in-one Grafana/OTel incluído. Ela define os processors, filtros e exporters do collector. Para produção e BYOC, configure os valores do subchart `otel-collector-lerian`.
* **Lado da Lerian**: a Lerian opera a stack gerenciada de collector e armazenamento. A Lerian a mantém segura e consistente.

<Note>
  A configuração do collector incluído mascara chaves sensíveis conhecidas (credenciais, tokens, `legalDocument`, `accountAlias`) nos corpos de log e no atributo de span `app.request.payload`. O mascaramento acontece no collector, então ele se aplica depois que a telemetria sai do processo da aplicação. Os exporters de desenvolvimento local incluídos rodam com TLS desabilitado (`insecure: true`). Habilite o TLS nos exporters do collector para qualquer deploy que não seja local.
</Note>

## Principais benefícios

***

* Visão unificada de métricas, logs e traces no Grafana
* Construído sobre os padrões do OpenTelemetry
* Grafana pré-configurado e operado pela Lerian
* Roteamento seguro e isolamento por tenant

<Tip>
  Veja [**Infra Tools → Observability**](/pt/platform/observability) para configuração avançada, configuração do collector e personalização de processors.
</Tip>