Zum Hauptinhalt springen

Methoden-Metriken und Traces

Ein Betreiber sieht Rate, Dauer und Fehler von Methoden-Aufrufen pro Methode und kann einen Aufruf vom Gateway über den Event Hub bis in den Handler in einem einzigen Trace verfolgen. Diese Seite nennt den Meter, seine Instrumente und Labels sowie die Spans. Die Konsistenzregeln stehen im Konsistenzmodell für Methoden, die Handler-Seite in Methoden-Handler implementieren.

Jeder Service, der AddObservability() aufruft, abonniert den Meter und die Span-Quellen Meshmakers.Octo.Methods und MassTransit.

Meter Meshmakers.Octo.Methods​

InstrumentTypLabelsWas gezählt wird
ck.method.callsCountermethod_id, transport, outcomejeder beendete Aufruf, genau einmal
ck.method.durationHistogramm (Sekunden, Buckets 5 ms bis 300 s)method_id, transport, outcomedie Dauer desselben Aufrufs aus Sicht des Aufrufers
ck.method.no_handlerCountermethod_id, transportAufrufe, die niemand annehmen konnte: METHOD_HANDLER_NOT_AVAILABLE, weil kein Handler lebt, der Tenant nicht bedient wird oder die Methode nicht registriert ist. Derselbe Code, weil der Idempotenz-Speicher ausgefallen ist, wird hier nicht gezählt.
ck.method.duplicate_refusedCounterreason, method_idZustellungen, die ein Handler-Host als mögliche Duplikate abgelehnt und nicht ausgeführt hat
ck.method.audit.failuresCountertransportAudit-Ereignisse, die nicht geschrieben werden konnten
ck.method.operationsCountermethod_id, stateZustandswechsel von Operationen asynchroner Methoden: accepted, running, succeeded, failed. Operationen, die der Sweep als verloren beendet (METHOD_OUTCOME_UNKNOWN, handler-lost), zählen als failed mit method_id other.

In Prometheus und Dash0 heißen die Namen mit Unterstrichen: ck_method_calls_total, ck_method_duration_seconds_bucket, ck_method_no_handler_total, ck_method_duplicate_refused_total, ck_method_operations_total.

Labels​

LabelWerte
method_iddie qualifizierte Methoden-Id ohne Modellversion, zum Beispiel System.Identity/User.ChangePassword-1. Ein Prozess meldet höchstens 1000 verschiedene Ids; weitere erscheinen als other, damit ein Aufrufer mit erfundenen Ids die Serien nicht unbegrenzt wachsen lassen kann.
transportbus (Handler in einem anderen Service, über den Event Hub), in-process (Handler im aufrufenden Service), gateway (vom Gateway abgelehnt, bevor der Aufruf die Pipeline erreichte; nur in ck.method.calls und ck.method.duration), other
outcomeSUCCESS, ACCEPTED (lang laufende Operation gestartet), CALLER_CANCELLED, ein Plattform-Fehlercode (METHOD_FORBIDDEN, METHOD_TIMEOUT, METHOD_HANDLER_FAILED, METHOD_HANDLER_NOT_AVAILABLE, METHOD_OUTCOME_UNKNOWN, ...) oder ein Fehlercode, den die Methode deklariert; invalid_code für jeden anderen Wert. Es ist dasselbe Vokabular wie im Audit-Ereignis.
stateaccepted, running, succeeded, failed (nur ck.method.operations)
reasonbroker_flag: Der Broker hat die Zustellung als mögliches Duplikat markiert (Redelivery, Bus-Retry). seen_id: Der Broker hat sie nicht markiert, aber diese Instanz hat die Aufruf-Id schon gesehen.

Was ein Label nie enthält: Parameterwerte, Ergebnisse, Tokens, Idempotenz-Schlüssel, Entitäts-Ids, Benutzernamen oder Subjects und die Tenant-Id. Der Tenant ist kein Label dieses Meters, damit die Zahl der Serien von der Zahl der Methoden abhängt und nicht von der Zahl der Tenants.

Wie ein Aufruf gezählt wird​

  • Jeder Aufruf über den Dispatcher oder den In-Process-Transport wird einmal gezählt, um die gesamte Aufruf-Pipeline herum. Eine Ablehnung durch den Autorisierungsfilter, eine aus dem Idempotenz-Speicher wiedergegebene Antwort, eine Ausnahme und ein Abbruch durch den Aufrufer werden ebenfalls mit ihrem Ergebnis gezählt. Die Metriken sind kein Filter der Pipeline und haben keinen Platz in der Filter-Reihenfolge (Audit 100, Autorisierung 200, Idempotenz 300).
  • Ein Aufruf, den das Gateway ablehnt, bevor er die Pipeline erreicht (verboten, unbekanntes Ziel, Parameter zu groß, ...), wird vom Audit-Recorder gezählt, der das Audit-Ereignis der Ablehnung schreibt, mit transport="gateway" und dem Ablehnungscode als Ergebnis. Solche Aufrufe erscheinen überall dort, wo das Methoden-Audit registriert ist.
  • ck.method.duplicate_refused zählt die gemeinsame Duplikat-Prüfung, die jeder Handler-Host verwendet, einmal pro abgelehnter Zustellung. Treffen beide Merkmale zu, wird das Broker-Flag gezählt. Ein wachsendes seen_id bei gleichbleibendem broker_flag zeigt Duplikate, die der Broker nicht markiert hat; das ist der Auslöser für die offene Entscheidung zu Duplikat-Zustellungen (Option B' von OD-3) im Konsistenzmodell für Methoden.

Beispielabfragen​

# Aufrufe pro Sekunde, pro Methode und Ergebnis
sum by (method_id, outcome) (rate(ck_method_calls_total[5m]))

# Fehlerquote pro Methode (alles außer SUCCESS und ACCEPTED)
sum by (method_id) (rate(ck_method_calls_total{outcome!~"SUCCESS|ACCEPTED"}[5m]))
/ sum by (method_id) (rate(ck_method_calls_total[5m]))

# 95. Perzentil der Dauer
histogram_quantile(0.95, sum by (le, method_id) (rate(ck_method_duration_seconds_bucket[5m])))

# Aufrufe ohne Handler in den letzten 15 Minuten
sum by (method_id) (increase(ck_method_no_handler_total[15m]))

# abgelehnte Duplikate nach Grund in der letzten Stunde
sum by (reason) (increase(ck_method_duplicate_refused_total[1h]))

Ein Trace für einen Aufruf​

Die Trace-Quelle Meshmakers.Octo.Methods liefert zwei Spans. Sie tragen die Tags ck.method.id und ck.method.transport, nie Parameter, Ergebnisse oder Tokens.

SpanWoHinweise
CK method callim aufrufenden Service, um den gesamten Aufrufdas Tag ck.method.outcome wird beim Ende des Aufrufs gesetzt; Kind des Spans der Anfrage, die den Aufruf auslöste
CK method handleim Handler: der Bus-Consumer des Handler-Hosts oder der In-Process-HandlerKind des Bus-Process-Spans (Bus) oder des Call-Spans (In-Process)

Über den Event Hub lautet die Kette: Anfrage-Span des Gateways, CK method call, Send-, Receive- und Process-Spans des Busses (Quelle MassTransit), CK method handle. Alle haben dieselbe Trace-Id, auch wenn der Handler in einem anderen Service läuft: Der Bus schreibt den W3C-Trace-Kontext in die Nachricht.

Für Betreiber

Wo die injizierte Auto-Instrumentierung die Spans exportiert (der übliche Aufbau im Cluster), müssen die beiden Quellennamen auch in der Pod-Einstellung OTEL_DOTNET_AUTO_TRACES_ADDITIONAL_SOURCES stehen: MassTransit und Meshmakers.Octo.Methods. Ohne Listener auf MassTransit startet der Handler einen neuen Trace.