DocumentaciónAjuda

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 OTEL_SERVICE_NAME do processo)

O que não é coberto

  • .NET Framework com HttpListener: os servidores feitos com HttpListener (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.

Relacionado

Pesquisar em Argunis Monitoring

Digite pelo menos 2 letras para pesquisar em Argunis Monitoring.

↑↓ navegar · Enter abrir · Esc fechar