DocumentaciónAide

Ce que l'APM peut superviser

Couverture de l'APM par langage et plateforme avec l'agent APM, avec le SDK et avec eBPF, versions minimales, ce qui n'est pas couvert et que faire des systèmes hérités.

Sur cette page

L'APM reçoit la télémétrie d'OpenTelemetry. Une application peut l'envoyer de trois façons ; cette page indique ce que couvre chacune, à partir de quelle version et ce qu'elle ne voit pas.

Façon

Fonctionnement

Quand l'utiliser

Agent APM

Il s'installe sur le serveur et met en place l'instrumentation automatique du langage en une commande. Voir Agents APM

Serveurs Linux ou Windows avec Java, .NET, Node.js ou Python. C'est l'option recommandée

SDK avec jeton

L'application envoie directement à ARGUNIS avec un jeton d'ingestion. Voir Instrumenter une application serveur

Langages sans agent (PHP, Go, Ruby), conteneurs, clouds et navigateur

eBPF

L'agent APM observe l'application depuis le système d'exploitation, sans la toucher. Voir Agents APM, section « Observer une application sans l'instrumenter »

Linux, pour les programmes impossibles à instrumenter : binaires sans code source, anciennes versions ou langages sans agent

Avec l'agent APM

L'instrumentation automatique voit les requêtes que reçoit l'application (spans serveur), celles qu'elle envoie à d'autres services et bases de données, ses erreurs avec le détail de l'exception, ainsi que les métriques et journaux de son runtime.

Langage

Version minimale

Système

Frameworks et bibliothèques principaux

Java (et Kotlin)

Java 8

Linux (service systemd) et Windows (service Windows)

Spring et Spring Boot, Jakarta EE et Servlet, Tomcat, JBoss/WildFly, WebSphere, JDBC (Oracle, SQL Server, PostgreSQL, DB2…), JMS, Kafka, clients HTTP

.NET Framework

4.6.2

Windows (service Windows et IIS)

ASP.NET sous IIS, WCF, HttpClient et WebRequest sortants, SQL Server

.NET (Core)

.NET 6 ; OpenTelemetry prend officiellement en charge les versions maintenues par Microsoft (aujourd'hui .NET 8 et suivantes)

Linux (glibc ou musl, x64 ou arm64) et Windows (service Windows et IIS)

ASP.NET Core, HttpClient, SQL Server, Entity Framework Core, gRPC

Node.js

Node.js 18.19 (applications ESM, 20.6)

Linux (service systemd)

http, Express, Fastify, NestJS, pg, mysql, MongoDB, Redis, fetch, gRPC, Kafka

Python

Python 3.9

Linux (service systemd)

Django, Flask, FastAPI, Celery, requests, psycopg, SQLAlchemy, Redis

Sous Windows, l'agent instrumente .NET et Java. Une application Node.js ou Python sous Windows s'instrumente avec le SDK et un jeton. Sous IIS, seuls les sites .NET sont instrumentés.

Avec le SDK et un jeton

Langage ou plateforme

Version minimale

Ce qu'il couvre

PHP

PHP 8.0

Laravel, Symfony, Slim, WordPress, PDO, curl et Guzzle, avec l'extension officielle

Go

Les versions de Go maintenues par OpenTelemetry (les deux dernières)

net/http, gRPC et database/sql ; en Go, on ajoute quelques lignes au démarrage

Ruby

Celle qu'exige la gem officielle d'OpenTelemetry

Rails, Sinatra, Sidekiq, ActiveRecord, Net::HTTP, Redis

Java, .NET, Node.js et Python

Les mêmes que dans le tableau précédent

Comme avec l'agent, en envoyant directement à ARGUNIS (utile dans les conteneurs et les services cloud)

Navigateur (Angular ou tout site web)

Navigateurs actuels

Chargement de page, fetch et XHR, reliés à la trace du back-end

Clouds et conteneurs

—

AWS, Azure, Google Cloud, Railway, Kubernetes et Docker, avec les mêmes SDK. Voir Instrumenter dans les clouds et conteneurs

Avec eBPF (Linux)

eBPF voit le trafic qui entre dans l'application et en sort, quel que soit le langage dans lequel elle est écrite.

Quoi

Détail

Prérequis

Linux x64 ou arm64 avec un noyau 5.8 ou supérieur (ou Red Hat Enterprise Linux 8 et dérivés) qui expose BTF, comme Ubuntu 20.10+, Debian 11+ et RHEL 8.2+ ; avec l'agent APM installé

Requêtes

HTTP 1.x et 2, et gRPC, reçues et envoyées, même chiffrées avec les bibliothèques TLS du système

Bases de données et files

MySQL, PostgreSQL, SQL Server, Redis, MongoDB 5.0+, Couchbase, Memcached, Kafka, MQTT, NATS, AMQP 1.0

Go

En plus, au niveau bibliothèque : net/http, gRPC, database/sql, Gin, gorilla/mux, go-redis, kafka-go et sarama (Go 1.17+)

Nom du service

Celui de l'exécutable (ou le OTEL_SERVICE_NAME du processus)

Ce qui n'est pas couvert

  • .NET Framework avec HttpListener : les serveurs construits avec HttpListener (par exemple, un service Windows qui traite lui-même le HTTP) ne génèrent pas de spans serveur. ASP.NET sous IIS, WCF, le HTTP sortant et SQL sont bien visibles (vérifié en laboratoire). Pour mesurer ces requêtes, instrumentez l'appelant ou ajoutez des spans avec le SDK.

  • Java sous IIS et Node.js ou Python sous Windows avec l'agent : non ; utilisez le SDK avec un jeton.

  • Avec eBPF :

    • Il voit les requêtes et leurs appels, mais pas ce qui se passe dans le code : ni les fonctions, ni le détail des exceptions, ni les métriques propres à l'application.

    • Les traces eBPF ne sont pas reliées entre services (chaque service apparaît avec ses requêtes et dépendances, sans la trace de bout en bout).

    • Il ne voit pas les requêtes HTTPS chiffrées par l'application Java elle-même : pour Java, utilisez l'agent.

    • Il n'existe pas sous Windows ni sur les noyaux Linux antérieurs à 5.8 (sauf RHEL 8).

  • Applications déjà instrumentées : eBPF les ignore pour ne pas les dupliquer.

  • Langages sans auto-instrumentation : C, C++, Rust et similaires sous Linux, avec eBPF ou avec des spans envoyés à la main en OTLP ; Delphi, Visual Basic 6 et autres sous Windows, avec des spans à la main ou en mesurant de l'extérieur.

Systèmes hérités

Système

Pourquoi il n'a pas d'instrumentation automatique

Alternative

Java 6 et 7

L'agent officiel d'OpenTelemetry exige Java 8 ou supérieur

Sous Linux, eBPF (requêtes HTTP, JDBC vers MySQL, PostgreSQL ou SQL Server). Sinon, instrumentez l'appelant et mesurez ses services web depuis Applications

PHP 5 et 7

L'extension officielle exige PHP 8.0 ou supérieur

Sous Linux, eBPF sur le serveur web et PHP-FPM (requêtes et requêtes vers la base)

.NET Framework antérieur à 4.6.2

L'instrumentation officielle exige la version 4.6.2 ou supérieure, et eBPF n'existe pas sous Windows

Instrumentez l'appelant (un autre service ou un proxy) et mesurez ses services web depuis Applications ; les journaux, avec le Collector

COBOL, RPG, CL et autres

Ils n'ont pas de runtime instrumentable

On instrumente l'appelant, on utilise eBPF sur un Linux passerelle, on envoie des spans à la main en OTLP/HTTP et les journaux avec le Collector. Voir Instrumenter sur IBM i et les systèmes hérités

Réseaux fermés ou qui ne parlent que gRPC

Ils ne sortent pas sur Internet ou n'utilisent pas OTLP/HTTP

L'OpenTelemetry Collector dans le réseau du client comme passerelle vers ARGUNIS

En cas de doute, commencez par l'agent APM avec le langage de l'application. Si ce n'est pas possible, eBPF sous Linux. Pour ce qui reste, mesurez de l'extérieur : supervision des services web dans Applications et journaux avec le Collector.

Voir aussi

Rechercher dans Argunis Monitoring

Saisissez au moins 2 caractères pour rechercher dans Argunis Monitoring.

↑↓ naviguer · Enter ouvrir · Esc fermer