Configuration de l'instrumentation

Cette page décrit les paramètres courants qui s’appliquent à plusieurs instrumentations à la fois.

Nom du service pair

Le nom du service pair (peer.service) est le nom d’un service distant auquel une connexion est établie. Il correspond à service.name dans la ressource pour le service local.

1.2.3.4=cats-service,dogs-abcdef123.serverlessapis.com=dogs-api

1.2.3.4:443=cats-service,dogs-abcdef123.serverlessapis.com:80/api=dogs-api

Nettoyage des instructions de base de données

L’agent nettoie toutes les requêtes/instructions de base de données avant de définir l’attribut sémantique db.statement. Toutes les valeurs (chaînes de caractères, nombres) dans la chaîne de requête sont remplacées par un point d’interrogation (?).

Note : Si vous cherchez à capturer les paramètres de liaison JDBC, ils ne sont pas capturés dans db.statement. Voir le problème correspondant.

Exemples :

• La requête SQL SELECT a from b where password="secret" apparaîtra comme SELECT a from b where password=? dans le span exporté ;
• La commande Redis HSET map password "secret" apparaîtra comme HSET map password ? dans le span exporté.

Ce comportement est activé par défaut pour toutes les instrumentations de base de données. Utilisez la propriété suivante pour le désactiver :

Capture de la télémétrie de réception de messages des consommateurs dans les instrumentations de messagerie

Vous pouvez configurer l’agent pour capturer la télémétrie de réception de messages des consommateurs dans l’instrumentation de messagerie. Utilisez la propriété suivante pour l’activer :

Notez que cela amènera le côté consommateur à démarrer une nouvelle trace, avec seulement un lien de span le connectant à la trace du producteur.

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 attributs de l’utilisateur final

Vous pouvez configurer l’agent pour capturer les attributs d’identité généraux (enduser.id, enduser.role, enduser.scope) des bibliothèques d’instrumentation comme JavaEE/JakartaEE Servlet et Spring Security.

Note : Étant donné la nature sensible des données impliquées, cette fonctionnalité est désactivée par défaut tout en permettant une activation sélective pour des attributs particuliers. Vous devez évaluer attentivement les implications de chaque attribut en matière de confidentialité avant d’activer la collecte de ces données.

Spring Security

Pour les utilisateurs de Spring Security qui utilisent des préfixes d’autorité accordée (granted authority prefixes) personnalisés, vous pouvez utiliser les propriétés suivantes pour supprimer ces préfixes des valeurs d’attribut enduser.* afin de mieux représenter les noms de rôle et de portée réels :