Abgekürzte Traces in APM Dotnet Agent konfigurieren
Dieses Feature wurde entwickelt, um Fälle von übermäßiger Span-Anzahl pro Trace zu vermeiden. Wenn zu viele Spans in einem einzigen Aufruf erstellt werden, kann der Agent einen höheren als den gewünschten Overhead verursachen, er kann auch die Stundenspannenanzahl erhöhen, was zu einer höheren als erwarteten Ladung führt. Fälle, in denen dies ein Problem sein kann, sind rekursive Aufrufe (absichtlich oder nicht), generierter Code, der zu einer hohen Anzahl von pro Transaktion ausgeführten SQLs führt, und andere.
- Mit der Abridge-Funktion können Benutzer die maximale Anzahl von Spans pro Aufruf begrenzen. Es bietet auch eine Möglichkeit, Spans auszuschließen, die als "nicht würdig" betrachtet werden können (z. B. eine hohe Menge an sehr schnellen SQLs).
- Probe-spezifische Zählungsgrenzen, Span-Name-basierter Ausschluss und Schwellenwert können pro Aufruf konfiguriert werden, wie im Konfigurationsabschnitt beschrieben.
- Standardmäßig wird jeder Aufruf auf 100 Spans begrenzt.
- Pro Aufruf können grundlegende zusammenfassende Statistiken zu gelöschten Spans gesammelt werden.
Im Folgenden finden Sie ein Beispiel für eine Einstellung, mit der die maximale Anzahl von ODP-Spans pro Aufruf auf 50 begrenzt wird und SQLs ausgeschlossen werden, die in weniger als 2 ms ausgeführt werden. Wenn Sie die Option summarize aktivieren, fügt der Agent dem übergeordneten Span die folgenden Metriken hinzu: 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=2Konfiguration
| Umgebungsvariable | Beschreibung | Standardwert | Beispiel |
|---|---|---|---|
|
OTEL_DOTNET_ABRIDGE_ENABLED |
Aktivieren/Deaktivieren des Abridge-Modus. Standardmäßig ist der Abridge-Modus aktiviert. |
true | |
|
OTEL_DOTNET_ABRIDGE_SPAN_LIMIT |
Die Span-Grenze, nach der Probes in probes_list gekürzt werden. Dieser Grenzwert gilt für die Gesamtanzahl der Spans aus ALLEN Probes in probes_list. Es ist nicht pro Probe. |
100 |
OTEL_DOTNET_ABRIDGE_SPAN_LIMIT=100 |
|
OTEL_DOTNET_ABRIDGE_PROBE_LIST |
Die Liste der Prüfpunkte, deren Spannweiten zur span_limit beitragen und die gekürzt werden, sobald span_limit erreicht ist. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_LIST=Odp,httpclient |
|
OTEL_DOTNET_ABRIDGE_SUMMARIZE |
Zusammenfassung der gelöschten Spans. Wählen Sie 'Wahr', um sie zu aktivieren. |
false | |
|
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_<probe_name> |
Die Spanngrenze, nach der die Spannweiten der Sonde verkürzt werden. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_odp=5 |
|
OTEL_DOTNET_ABRIDGE_PROBE_EXCLUDE_REGEX_<probe_name> |
Auf dem Vorgangsnamen basierender regexbasierter Abgleich. Nach dem Abgleich wird die Spanne der Probe gelöscht. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_EXCLUDE_REGEX_odp=.*auswählen.* |
|
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_<probe_name> |
Span-Dauer-basierter Schwellenwert. Der Wert liegt in Millisekunden und gibt an, dass Spans, die weniger als die konfigurierte Zeit benötigen, gelöscht werden sollen. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_odp=2 |
|
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_<probe_name> |
Span-Dauer-basierter Schwellenwert. Gibt die Anzahl der Spans an, die erfasst werden sollen, bevor der Schwellenwert für schnelle Spans festgelegt wird. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_odp=0 |