O que pode ser monitorado com o APM
Cobertura do APM por linguagem e plataforma com o agente APM, com o SDK e com eBPF, versões mínimas, o que não é coberto e o que fazer com sistemas legados.
Nesta página
O APM recebe telemetria do OpenTelemetry. Uma aplicação pode chegar de três formas, e esta página diz o que cada uma cobre, a partir de qual versão e o que ela não consegue ver.
Forma | Como funciona | Quando usar |
|---|---|---|
Agente APM | É instalado no servidor e deixa a instrumentação automática da linguagem pronta com um comando. Veja Agentes APM | Servidores Linux ou Windows com Java, .NET, Node.js ou Python. É a opção recomendada |
SDK com token | A aplicação envia direto ao ARGUNIS com um token de ingestão. Veja Instrumentar uma aplicação de servidor | Linguagens sem agente (PHP, Go, Ruby), contêineres, nuvens e navegador |
eBPF | O agente APM observa a aplicação a partir do sistema operacional, sem mexer nela. Veja Agentes APM, seção «Observar uma aplicação sem instrumentá-la» | Linux, para programas que não podem ser instrumentados: binários sem código-fonte, versões antigas ou linguagens sem agente |
Com o agente APM
A instrumentação automática vê as requisições que a aplicação recebe (spans de servidor), as que ela faz a outros serviços e bancos de dados, seus erros com o detalhe da exceção, e as métricas e logs do seu runtime.
Linguagem | Versão mínima | Sistema | Frameworks e bibliotecas principais |
|---|---|---|---|
Java (e Kotlin) | Java 8 | Linux (serviço systemd) e Windows (serviço do Windows) | Spring e Spring Boot, Jakarta EE e Servlet, Tomcat, JBoss/WildFly, WebSphere, JDBC (Oracle, SQL Server, PostgreSQL, DB2…), JMS, Kafka, clientes HTTP |
.NET Framework | 4.6.2 | Windows (serviço do Windows e IIS) | ASP.NET no IIS, WCF, HttpClient e WebRequest de saída, SQL Server |
.NET (Core) | .NET 6; o OpenTelemetry dá suporte oficial às versões que a Microsoft mantém (hoje .NET 8 e posteriores) | Linux (glibc ou musl, x64 ou arm64) e Windows (serviço do Windows e IIS) | ASP.NET Core, HttpClient, SQL Server, Entity Framework Core, gRPC |
Node.js | Node.js 18.19 (aplicações ESM, 20.6) | Linux (serviço systemd) | http, Express, Fastify, NestJS, pg, mysql, MongoDB, Redis, fetch, gRPC, Kafka |
Python | Python 3.9 | Linux (serviço systemd) | Django, Flask, FastAPI, Celery, requests, psycopg, SQLAlchemy, Redis |
No Windows, o agente instrumenta .NET e Java. Uma aplicação Node.js ou Python no Windows é instrumentada com o SDK e um token. No IIS, só sites .NET são instrumentados.
Com o SDK e um token
Linguagem ou plataforma | Versão mínima | O que cobre |
|---|---|---|
PHP | PHP 8.0 | Laravel, Symfony, Slim, WordPress, PDO, curl e Guzzle, com a extensão oficial |
Go | As versões do Go que o OpenTelemetry mantém (as duas últimas) | net/http, gRPC e database/sql; em Go, adicionam-se algumas linhas na inicialização |
Ruby | A que a gem oficial do OpenTelemetry pede | Rails, Sinatra, Sidekiq, ActiveRecord, Net::HTTP, Redis |
Java, .NET, Node.js e Python | As mesmas da tabela anterior | Igual ao agente, enviando direto ao ARGUNIS (útil em contêineres e serviços na nuvem) |
Navegador (Angular ou qualquer web) | Navegadores atuais | Carregamento de página, fetch e XHR, unidos ao trace do back-end |
Nuvens e contêineres | — | AWS, Azure, Google Cloud, Railway, Kubernetes e Docker, com os mesmos SDKs. Veja Instrumentar em nuvens e contêineres |
Com eBPF (Linux)
O eBPF vê o tráfego que entra e sai da aplicação, não importa em que linguagem ela esteja escrita.
O quê | Detalhe |
|---|---|
Requisitos | Linux x64 ou arm64 com kernel 5.8 ou superior (ou Red Hat Enterprise Linux 8 e derivados) que exponha BTF, como Ubuntu 20.10+, Debian 11+ e RHEL 8.2+; com o agente APM instalado |
Requisições | HTTP 1.x e 2, e gRPC, recebidas e enviadas, também criptografadas com as bibliotecas TLS do sistema |
Bancos de dados e filas | MySQL, PostgreSQL, SQL Server, Redis, MongoDB 5.0+, Couchbase, Memcached, Kafka, MQTT, NATS, AMQP 1.0 |
Go | Além disso, no nível de biblioteca: net/http, gRPC, database/sql, Gin, gorilla/mux, go-redis, kafka-go e sarama (Go 1.17+) |
Nome do serviço | O do executável (ou o |
O que não é coberto
.NET Framework com
HttpListener: os servidores feitos comHttpListener(por exemplo, um serviço do Windows que atende HTTP por conta própria) não geram spans de servidor. São vistos o ASP.NET no IIS, o WCF, o HTTP de saída e o SQL (comprovado em laboratório). Para medir essas requisições, instrumente quem as chama ou adicione spans com o SDK.Java no IIS e Node.js ou Python no Windows com o agente: não; use o SDK com um token.
Com eBPF:
Ele vê as requisições e suas chamadas, mas não o que acontece dentro do código: nem funções, nem o detalhe das exceções, nem métricas próprias da aplicação.
Os traces do eBPF não se unem entre serviços (cada serviço aparece com suas requisições e dependências, sem o trace de ponta a ponta).
Ele não vê as requisições HTTPS que a própria aplicação Java criptografa: para Java, use o agente.
Não existe no Windows nem em kernels Linux anteriores ao 5.8 (exceto RHEL 8).
Aplicações já instrumentadas: o eBPF as pula para não duplicá-las.
Linguagens sem instrumentação automática: C, C++, Rust e similares no Linux, com eBPF ou com spans enviados manualmente por OTLP; Delphi, Visual Basic 6 e outras do Windows, com spans manuais ou medindo de fora.
Sistemas legados
Sistema | Por que não tem instrumentação automática | Alternativa |
|---|---|---|
Java 6 e 7 | O agente oficial do OpenTelemetry pede Java 8 ou superior | No Linux, eBPF (requisições HTTP, JDBC para MySQL, PostgreSQL ou SQL Server). Se não, instrumente quem a chama e meça seus serviços web em Aplicações |
PHP 5 e 7 | A extensão oficial pede PHP 8.0 ou superior | No Linux, eBPF sobre o servidor web e o PHP-FPM (requisições e consultas ao banco) |
.NET Framework anterior ao 4.6.2 | A instrumentação oficial pede 4.6.2 ou superior, e o eBPF não existe no Windows | Instrumente quem a chama (outro serviço ou um proxy) e meça seus serviços web em Aplicações; os logs, com o Collector |
COBOL, RPG, CL e outros | Não têm um runtime que possa ser instrumentado | Instrumenta-se quem os chama, usa-se eBPF em um Linux intermediário, enviam-se spans manualmente por OTLP/HTTP e os logs com o Collector. Veja Instrumentar em IBM i e sistemas legados |
Redes fechadas ou que só falam gRPC | Não saem para a internet ou não usam OTLP/HTTP | O OpenTelemetry Collector na rede do cliente como ponte para o ARGUNIS |
Na dúvida, comece pelo agente APM com a linguagem da aplicação. Se não for possível, eBPF no Linux. Para o que ficar de fora, meça de fora: monitoramento de serviços web em Aplicações e logs com o Collector.