Qué se puede monitorear con el APM
Cobertura del APM por lenguaje y plataforma con el agente APM, con el SDK y con eBPF, versiones mínimas, lo que no se cubre y qué hacer con sistemas legados.
En esta página
El APM recibe telemetría de OpenTelemetry. Una aplicación puede llegar de tres formas, y esta página dice qué cubre cada una, desde qué versión y qué no alcanza a ver.
Forma | Cómo funciona | Cuándo usarla |
|---|---|---|
Agente APM | Se instala en el servidor y deja la instrumentación automática del lenguaje con un comando. Ver Agentes APM | Servidores Linux o Windows con Java, .NET, Node.js o Python. Es la opción recomendada |
SDK con token | La aplicación envía directo a ARGUNIS con un token de ingesta. Ver Instrumentar una aplicación de servidor | Lenguajes sin agente (PHP, Go, Ruby), contenedores, nubes y navegador |
eBPF | El agente APM observa la aplicación desde el sistema operativo, sin tocarla. Ver Agentes APM, sección «Observar una aplicación sin instrumentarla» | Linux, para programas que no se pueden instrumentar: binarios sin código fuente, versiones antiguas o lenguajes sin agente |
Con el agente APM
La instrumentación automática ve las peticiones que recibe la aplicación (spans de servidor), las que hace a otros servicios y bases de datos, sus errores con el detalle de la excepción, y las métricas y logs de su runtime.
Lenguaje | Versión mínima | Sistema | Frameworks y librerías principales |
|---|---|---|---|
Java (y Kotlin) | Java 8 | Linux (servicio systemd) y Windows (servicio de Windows) | Spring y Spring Boot, Jakarta EE y Servlet, Tomcat, JBoss/WildFly, WebSphere, JDBC (Oracle, SQL Server, PostgreSQL, DB2…), JMS, Kafka, clientes HTTP |
.NET Framework | 4.6.2 | Windows (servicio de Windows e IIS) | ASP.NET en IIS, WCF, HttpClient y WebRequest salientes, SQL Server |
.NET (Core) | .NET 6; OpenTelemetry da soporte oficial a las versiones que Microsoft mantiene (hoy .NET 8 y posteriores) | Linux (glibc o musl, x64 o arm64) y Windows (servicio de Windows e IIS) | ASP.NET Core, HttpClient, SQL Server, Entity Framework Core, gRPC |
Node.js | Node.js 18.19 (aplicaciones ESM, 20.6) | Linux (servicio systemd) | http, Express, Fastify, NestJS, pg, mysql, MongoDB, Redis, fetch, gRPC, Kafka |
Python | Python 3.9 | Linux (servicio systemd) | Django, Flask, FastAPI, Celery, requests, psycopg, SQLAlchemy, Redis |
En Windows el agente instrumenta .NET y Java. Una aplicación Node.js o Python en Windows se instrumenta con el SDK y un token. En IIS solo se instrumentan sitios .NET.
Con el SDK y un token
Lenguaje o plataforma | Versión mínima | Qué cubre |
|---|---|---|
PHP | PHP 8.0 | Laravel, Symfony, Slim, WordPress, PDO, curl y Guzzle, con la extensión oficial |
Go | Las versiones de Go que mantiene OpenTelemetry (las dos últimas) | net/http, gRPC y database/sql; en Go se agregan unas líneas al arrancar |
Ruby | La que pide la gema oficial de OpenTelemetry | Rails, Sinatra, Sidekiq, ActiveRecord, Net::HTTP, Redis |
Java, .NET, Node.js y Python | Las mismas de la tabla anterior | Igual que con el agente, enviando directo a ARGUNIS (útil en contenedores y servicios en la nube) |
Navegador (Angular o cualquier web) | Navegadores actuales | Carga de página, fetch y XHR, unidos a la traza del back-end |
Nubes y contenedores | — | AWS, Azure, Google Cloud, Railway, Kubernetes y Docker, con los mismos SDK. Ver Instrumentar en nubes y contenedores |
Con eBPF (Linux)
eBPF ve el tráfico que entra y sale de la aplicación, sin importar en qué lenguaje está escrita.
Qué | Detalle |
|---|---|
Requisitos | Linux x64 o arm64 con kernel 5.8 o superior (o Red Hat Enterprise Linux 8 y derivados) que exponga BTF, como Ubuntu 20.10+, Debian 11+ y RHEL 8.2+; con el agente APM instalado |
Peticiones | HTTP 1.x y 2, y gRPC, recibidas y enviadas, también cifradas con las librerías TLS del sistema |
Bases de datos y colas | MySQL, PostgreSQL, SQL Server, Redis, MongoDB 5.0+, Couchbase, Memcached, Kafka, MQTT, NATS, AMQP 1.0 |
Go | Además, a nivel de librería: net/http, gRPC, database/sql, Gin, gorilla/mux, go-redis, kafka-go y sarama (Go 1.17+) |
Nombre del servicio | El del ejecutable (o el |
Lo que no se cubre
.NET Framework con
HttpListener: los servidores hechos conHttpListener(por ejemplo, un servicio de Windows que atiende HTTP por su cuenta) no generan spans de servidor. Sí se ven ASP.NET en IIS, WCF, el HTTP saliente y SQL (comprobado en el laboratorio). Para medir esas peticiones, instrumenta a quien las llama o agrega spans con el SDK.Java en IIS y Node.js o Python en Windows con el agente: no; usa el SDK con un token.
Con eBPF:
Ve las peticiones y sus llamadas, pero no lo que pasa dentro del código: ni funciones, ni el detalle de las excepciones, ni métricas propias de la aplicación.
Las trazas de eBPF no se unen entre servicios (cada servicio aparece con sus peticiones y dependencias, sin la traza de punta a punta).
No ve las peticiones HTTPS que cifra la propia aplicación Java: para Java usa el agente.
No existe en Windows ni en kernels Linux anteriores a 5.8 (salvo RHEL 8).
Aplicaciones ya instrumentadas: eBPF las salta para no duplicarlas.
Lenguajes sin auto-instrumentación: C, C++, Rust y similares en Linux, con eBPF o con spans enviados a mano por OTLP; Delphi, Visual Basic 6 y otros de Windows, con spans a mano o midiendo desde fuera.
Sistemas legados
Sistema | Por qué no tiene instrumentación automática | Alternativa |
|---|---|---|
Java 6 y 7 | El agente oficial de OpenTelemetry pide Java 8 o superior | En Linux, eBPF (peticiones HTTP, JDBC hacia MySQL, PostgreSQL o SQL Server). Si no, instrumenta a quien la llama y mide sus servicios web desde Aplicaciones |
PHP 5 y 7 | La extensión oficial pide PHP 8.0 o superior | En Linux, eBPF sobre el servidor web y PHP-FPM (peticiones y consultas a la base) |
.NET Framework anterior a 4.6.2 | La instrumentación oficial pide 4.6.2 o superior, y eBPF no existe en Windows | Instrumenta a quien la llama (otro servicio o un proxy) y mide sus servicios web desde Aplicaciones; los logs, con el Collector |
COBOL, RPG, CL y otros | No tienen un runtime que se pueda instrumentar | Se instrumenta a quien los llama, se usa eBPF en un Linux puente, se envían spans a mano por OTLP/HTTP y los logs con el Collector. Ver Instrumentar en IBM i y sistemas legados |
Redes cerradas o que solo hablan gRPC | No salen a internet o no usan OTLP/HTTP | El OpenTelemetry Collector en la red del cliente como puente hacia ARGUNIS |
Si dudas, empieza por el agente APM con el lenguaje de la aplicación. Si no se puede, eBPF en Linux. Para lo que quede afuera, mide desde fuera: monitoreo de servicios web en Aplicaciones y logs con el Collector.