Configuration de l'instrumentation HTTP

Capture des en-têtes de requête et de réponse HTTP

Suivant la convention sémantique, vous pouvez configurer l’agent pour capturer les en-têtes HTTP prédéfinis comme attributs de span. Utilisez les propriétés suivantes pour définir les en-têtes HTTP que vous souhaitez capturer :

System property: otel.instrumentation.http.client.capture-request-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_CLIENT_CAPTURE_REQUEST_HEADERS

Description: Une liste de noms d'en-têtes HTTP séparés par des virgules. Les instrumentations du client HTTP captureront les valeurs des en-têtes de requête HTTP pour tous les noms d'en-têtes configurés.

System property: otel.instrumentation.http.client.capture-response-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_CLIENT_CAPTURE_RESPONSE_HEADERS

Description: Une liste de noms d'en-têtes HTTP séparés par des virgules. Les instrumentations du client HTTP captureront les valeurs des en-têtes de réponse HTTP pour tous les noms d'en-têtes configurés.

System property: otel.instrumentation.http.server.capture-request-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_REQUEST_HEADERS

Description: Une liste de noms d'en-têtes HTTP séparés par des virgules. Les instrumentations du serveur HTTP captureront les valeurs des en-têtes de requête HTTP pour tous les noms d'en-têtes configurés.

System property: otel.instrumentation.http.server.capture-response-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_RESPONSE_HEADERS

Description: Une liste de noms d'en-têtes HTTP séparés par des virgules. Les instrumentations du serveur HTTP captureront les valeurs des en-têtes de réponse HTTP pour tous les noms d'en-têtes configurés.

Ces options de configuration sont supportées par toutes les instrumentations de client et de serveur HTTP.

Note : Les noms de propriété/variable d’environnement listés dans le tableau sont encore expérimentaux, et sont donc susceptibles de changer.

Capture des paramètres de requête de servlet

Vous pouvez configurer l’agent pour capturer les paramètres de requête HTTP prédéfinis comme attributs de span pour les requêtes qui sont gérées par l’API Servlet. Utilisez la propriété suivante pour définir les paramètres de requête de servlet que vous souhaitez capturer :

System property: otel.instrumentation.servlet.experimental.capture-request-parametersEnvironment variable: OTEL_INSTRUMENTATION_SERVLET_EXPERIMENTAL_CAPTURE_REQUEST_PARAMETERS

Description: Une liste de noms de paramètres de requête séparés par des virgules.

Note : Les noms de propriété/variable d’environnement listés dans le tableau sont encore expérimentaux, et sont donc susceptibles de changer.

Configuration des méthodes HTTP connues

Configure l’instrumentation pour reconnaître un ensemble alternatif de méthodes de requête HTTP. Toutes les autres méthodes seront traitées comme _OTHER.

System property: otel.instrumentation.http.known-methodsEnvironment variable: OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS

Default: CONNECT,DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,TRACE
Description: Une liste de méthodes HTTP connues séparées par des virgules.

Activation de la télémétrie HTTP expérimentale

Vous pouvez configurer l’agent pour capturer des données de télémétrie HTTP expérimentales supplémentaires.

System property: otel.instrumentation.http.client.emit-experimental-telemetryEnvironment variable: OTEL_INSTRUMENTATION_HTTP_CLIENT_EMIT_EXPERIMENTAL_TELEMETRY

Default: false
Description: Active la télémétrie expérimentale du client HTTP.

System property: otel.instrumentation.http.server.emit-experimental-telemetryEnvironment variable: OTEL_INSTRUMENTATION_HTTP_SERVER_EMIT_EXPERIMENTAL_TELEMETRY

Default: false
Description: Active la télémétrie expérimentale du serveur HTTP.

Pour les spans client et serveur, les attributs suivants sont ajoutés :

  • http.request.body.size et http.response.body.size : La taille des corps de requête et de réponse, respectivement.

Pour les métriques client, les métriques suivantes sont créées :

Pour les métriques serveur, les métriques suivantes sont créées :


Dernière modification August 4, 2025: [fr] Translation of Zero Code Java docs (#7389) (a409f82a)