Configurer les traces abrégées dans l'agent Dotnet APM
Cette fonctionnalité est conçue pour éliminer les cas de nombre d'intervalles excessif par trace. Lorsque trop d'intervalles sont créés lors d'un seul appel, l'agent peut entraîner une surcharge supérieure à celle souhaitée. Il peut également augmenter le nombre d'intervalles horaires, ce qui entraîne des frais plus élevés que prévu. Les cas où il peut s'agir d'un problème incluent les appels récursifs (intentionnels ou non), le code généré entraînant un nombre élevé d'instructions SQL exécutées par transaction, etc.
- La fonction abridge permet aux utilisateurs de limiter le nombre maximal d'intervalles par appel. Il fournit également un moyen d'exclure les intervalles qui peuvent être considérés comme "non dignes" (par exemple, un volume élevé d'instructions SQL très rapides).
- Les limites de comptage propres à la sonde, l'exclusion basée sur le nom d'intervalle et le seuillage sont configurables par appel, comme décrit dans la section de configuration.
- La valeur par défaut est de limiter chaque appel à 100 intervalles.
- Des statistiques sommaires de base sur les intervalles supprimés peuvent être collectées par appel.
Vous trouverez ci-dessous un exemple de paramètre qui limitera le nombre maximal d'intervalles ODP par appel à 50 et exclura les énoncés SQL exécutés en moins de 2 ms. En activant l'option summarize, l'agent ajoute les mesures suivantes à l'intervalle parent : dropped span count, avg dropped span duration, min dropped span time, max dropped span time, dropped span error count.
OTEL_DOTNET_ABRIDGE_SUMMARIZE=true
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_odp=50
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_odp=2Configuration
| Variable d'environnement | Description | Par défaut | Exemple |
|---|---|---|---|
|
OTEL_DOTNET_ABRIDGE_ENABLED |
Activez/désactivez le mode abridge. Par défaut, le mode abridge est activé. |
true | |
|
OTEL_DOTNET_ABRIDGE_SPAN_LIMIT |
Limite d'intervalle après laquelle les sondes dans probes_list sont abrégées. Cette limite concerne le nombre total d'intervalles de TOUTES les sondes dans probes_list. Ce n'est pas par sonde. |
100 |
OTEL_DOTNET_ABRIDGE_SPAN_LIMIT=100 |
|
OTEL_DOTNET_ABRIDGE_PROBE_LIST |
Liste des sondes dont les intervalles contribuent à span_limit et qui deviennent abrégées une fois que span_limit est atteint. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_LIST=Odp,httpclient |
|
OTEL_DOTNET_ABRIDGE_SUMMARIZE |
Sommaire des intervalles abandonnés. Réglé à vrai pour l'activer. |
false | |
|
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_<probe_name> |
Limite d'intervalle après laquelle les intervalles de la sonde sont abrégés. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_odp=5 |
|
OTEL_DOTNET_ABRIDGE_PROBE_EXCLUDE_REGEX_<probe_name> |
Correspondance d'expressions rationnelles basée sur le nom de l'opération. Une fois appariée, la portée de la sonde est supprimée. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_EXCLUDE_REGEX_odp=.*sélectionner.* |
|
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_<probe_name> |
Seuil basé sur la durée d'intervalle. La valeur est exprimée en millisecondes et indique que les intervalles prenant moins de temps que le temps configuré doivent être abandonnés. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_odp=2 |
|
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_<probe_name> |
Seuil basé sur la durée d'intervalle. Indique le nombre d'intervalles à capturer avant de commencer à actualiser les intervalles rapides. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_odp=0 |