DocumentaciónAyuda

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 OTEL_SERVICE_NAME del proceso)

Lo que no se cubre

  • .NET Framework con HttpListener: los servidores hechos con HttpListener (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.

Relacionado

Buscar en Argunis Monitoring

Escribe al menos 2 letras para buscar en Argunis Monitoring.

↑↓ moverse · Enter abrir · Esc cerrar