O que você pode observar em aplicações instrumentadas

Uma aplicação instrumentada pode enviar métricas, logs e traces ao Elven Observability. Em conjunto, esses sinais ajudam a acompanhar o comportamento agregado do serviço e a consultar eventos e requisições individuais.

A cobertura depende da linguagem, das bibliotecas e da configuração da instrumentação. A coleta automática não representa necessariamente todos os componentes ou regras de negócio da aplicação. Consulte o guia da tecnologia utilizada para identificar a cobertura e os sinais disponíveis.

Métricas da aplicação

As métricas permitem acompanhar valores agregados ao longo do tempo. Conforme a instrumentação, podem incluir:

volume e taxa de requisições;
latência das operações;
quantidade ou proporção de erros;
métricas de runtime e processo, como memória, CPU ou coleta de lixo;
sinais de dependências instrumentadas, como banco de dados, cache ou clientes HTTP.

Para organizar a leitura, os Golden Signals agrupam tráfego, erros, latência e saturação. Nem toda aplicação terá uma série para cada categoria, e o nome da métrica varia por tecnologia.

Logs estruturados

Logs registram mensagens e eventos da aplicação. Quando enviados de forma estruturada, podem incluir atributos que ajudam a filtrar e interpretar o registro. Os campos disponíveis dependem do logger, do formato e dos atributos configurados.

Quando há contexto de trace associado, um log pode levar ao trace da requisição correspondente. Veja Logs para explorar filtros, registros estruturados e correlação.

Traces distribuídos

Traces mostram uma requisição ao longo dos serviços e operações que foram instrumentados. Cada etapa aparece como um span com nome e duração. A cobertura depende das bibliotecas automáticas e da instrumentação manual habilitadas.

Um trace pode mostrar chamadas HTTP, operações de banco ou outras dependências quando esses componentes estiverem instrumentados. Etapas não capturadas não aparecem no trace. Veja Traces para explorar a lista, os filtros e a visualização waterfall.

Como combinar os sinais

Use um dashboard de métricas para identificar a tendência e delimitar o serviço e o período.
Consulte logs do mesmo serviço e intervalo para encontrar mensagens relacionadas.
Abra traces associados aos logs para percorrer os spans daquela requisição.
Compare os dados usando os atributos comuns disponíveis, como nome de serviço, ambiente ou identificador de trace.

Os atributos e a correlação dependem dos dados enviados. A ausência de um campo ou sinal pode indicar que ele não é produzido ou encaminhado pela instrumentação daquele serviço.

Guias por tecnologia

Consulte Integração e Instrumentação para escolher o guia aplicável. As coberturas de traces, métricas e logs são específicas de cada tecnologia.