Configuration des traces abrégées dans l'agent Dotnet APM
Cette fonctionnalité est conçue pour éliminer les cas de nombre excessif d'étendues par trace. Lorsque trop d'étendues sont créées en un seul appel, l'agent peut entraîner une surcharge supérieure à celle souhaitée, il peut également augmenter le nombre d'étendues 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 des appels récursifs (intentionnels ou non), du code généré entraînant un nombre élevé d'instructions SQL exécutées par transaction, etc.
- La fonctionnalité de réduction permet aux utilisateurs de limiter le nombre maximal d'étendues par appel. Il permet également d'exclure des étendues qui peuvent être considérées comme "non dignes" (par exemple, un volume élevé de requêtes SQL très rapides).
- Les limites de nombre propres à la sonde, l'exclusion basée sur le nom d'étendue et le seuil sont configurables par appel, comme décrit dans la section de configuration.
- Le paramètre par défaut consiste à limiter chaque appel à 100 étendues.
- Des statistiques récapitulatives de base sur les étendues supprimées peuvent être collectées par appel.
Voici un exemple de paramètre qui limitera le nombre maximal d'étendues ODP par appel à 50 et exclura les instructions SQL qui s'exécutent en moins de 2 ms. En activant l'option summarize, l'agent ajoute les mesures suivantes à l'étendue 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 | Valeur 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'étendue après laquelle les sondes dans probes_list sont réduites. Cette limite concerne le nombre total d'étendues 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 étendues contribuent au span_limit et qui deviennent abrégées une fois que span_limit est atteint. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_LIST=Odp, client HTTP |
|
OTEL_DOTNET_ABRIDGE_SUMMARIZE |
Récapitulatif des étendues supprimées. Définissez la valeur sur Vrai pour l'activer. |
False | |
|
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_<probe_name> |
Limite d'étendue après laquelle les étendues de la sonde sont réduites. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_odp=5 |
|
OTEL_DOTNET_ABRIDGE_PROBE_EXCLUDE_REGEX_<probe_name> |
Une expression régulière correspondant au nom de l'opération. Une fois la correspondance établie, l'étendue 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 de l'étendue. La valeur est exprimée en millisecondes et indique que les étendues prenant moins de temps que le temps configuré doivent être supprimées. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_odp=2 |
|
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_<probe_name> |
Seuil basé sur la durée de l'étendue. Indique le nombre d'étendues à capturer avant le début de l'actualisation des étendues rapides. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_odp=0 |