Überwachen von Azure Digital Twins mit Metriken, Warnungen und Diagnosen

Azure Digital Twins ist mit Azure Monitor integriert, um Metriken und Diagnoseinformationen bereitzustellen, mit denen Sie Ihre Azure Digital Twins-Ressourcen überwachen können. Metriken sind standardmäßig aktiviert und liefern Informationen zum Zustand der Azure Digital Twins-Ressourcen in Ihrem Azure-Abonnement. Warnungen informieren Sie proaktiv, wenn bestimmte Bedingungen in Ihren Metrikdaten gefunden werden. Sie können auch Diagnoseprotokolle für Ihre Dienstinstanz zur Überwachung von Leistung, Zugriff und anderen Daten sammeln.

Diese Überwachungsfeatures helfen Ihnen, die allgemeine Integrität des Azure Digital Twins-Diensts und der damit verbundenen Ressourcen zu bewerten. Sie können sie verwenden, um zu verstehen, was in Ihrer Azure Digital Twins-Instanz passiert, und die Ursachen analysieren, ohne sich an den Azure-Support wenden zu müssen.

Auf alle diese Überwachungsfeatures kann über das Azure-Portal zugegriffen werden, gruppiert unter der Überschrift "Überwachung " für die Azure Digital Twins-Ressource.

Metriken und Warnungen

Allgemeine Informationen zum Anzeigen von Metriken zu Azure-Ressourcen finden Sie in der Azure Monitor-Dokumentation unter Erste Schritte mit dem Metrik-Explorer. Allgemeine Informationen zum Konfigurieren von Warnungen für Azure-Metriken finden Sie unter Erstellen einer neuen Warnungsregel.

Im Rest dieses Abschnitts werden die Metriken beschrieben, die von jeder Azure Digital Twins-Instanz nachverfolgt werden, und es wird erläutert, wie sich jede Metrik auf den Gesamtstatus Ihrer Instanz bezieht.

Metriken zum Überwachen von Diensteinschränkungen

Sie können diese Metriken so konfigurieren, dass überwacht wird, wann Sie sich einem veröffentlichten Dienstlimit für einen bestimmten Aspekt Ihrer Lösung nähern.

Verwenden Sie zum Einrichten der Nachverfolgung das Feature Warnungen in Azure Monitor. Sie können Schwellenwerte für diese Metriken definieren, sodass Sie eine Warnung erhalten, wenn eine Metrik einen bestimmten Prozentsatz dieses veröffentlichten Limits erreicht.

Metrik	Anzeigename der Metrik	Einheit	Aggregationstyp	BESCHREIBUNG	Dimensionen
TwinCount	Twin Count (Vorschau)	Anzahl	Gesamt	Hierbei handelt es sich um die Gesamtanzahl von Zwillingen in einer Azure Digital Twins-Instanz. Verwenden Sie diese Metrik, um zu bestimmen, ob Sie sich dem Dienstlimit für die maximal pro Instanz zulässige Anzahl an Zwillingen nähern.	Keine
ModelCount	Model Count (Vorschau)	Anzahl	Gesamt	Hierbei handelt es sich um die Gesamtanzahl von Modellen in einer Azure Digital Twins-Instanz. Verwenden Sie diese Metrik, um zu bestimmen, ob Sie sich dem Dienstlimit für die maximal pro Instanz zulässige Anzahl an Modellen nähern.	Keine

API-Anforderungsmetriken

Metriken für API-Anforderungen:

Metrik	Anzeigename der Metrik	Einheit	Aggregationstyp	BESCHREIBUNG	Dimensionen
API-Anfragen	API-Anforderungen	Anzahl	Gesamt	Die Anzahl der API-Anforderungen, die für Lese-, Schreib-, Lösch- und Abfragevorgänge für Digital Twins durchgeführt wurden.	Authentifizierung, Betrieb, Protokoll, Statuscode, Statuscodeklasse, Statustext
ApiRequestsFailureRate	API-Anforderungsfehlerrate	Prozent	Durchschnitt	Der Prozentsatz der API-Anforderungen, die der Dienst für Ihre Instanz erhält und die einen internen Fehler (500) als Antwortcode für Lese-, Schreib-, Lösch- und Abfragevorgänge von Digital Twins angeben.	Authentifizierung, Betrieb, Protokoll, Statuscode, Statuscodeklasse, Statustext
Latenz von API-Anfragen	API-Anforderungslatenz	Millisekunden	Durchschnitt	Die Antwortzeit für API-Anforderungen. Dieser Wert bezieht sich auf den Zeitraum zwischen dem Eingang der Anforderung bei Azure Digital Twins und dem Zeitpunkt, zu dem der Dienst ein Erfolgs- bzw. Fehlerergebnis für Lese-, Schreib-, Lösch- und Abfragevorgänge von Digital Twins sendet.	Authentifizierung, Betrieb, Protokoll

Abrechnungsmetriken

Metriken für die Abrechnung:

Metrik	Anzeigename der Metrik	Einheit	Aggregationstyp	BESCHREIBUNG	Dimensionen
BillingApiOperations	API-Abrechnungsvorgänge	Anzahl	Gesamt	Abrechnungsmetrik für die Anzahl aller API-Anforderungen, die für den Azure Digital Twins-Dienst durchgeführt wurden.	Messungs-ID
BillingMessagesProcessed	Verarbeitete Abrechnungsnachrichten	Anzahl	Gesamt	Abrechnungsmetrik für die Anzahl von Nachrichten, die von Azure Digital Twins Zwillingen an externe Endpunkte gesendet werden. Nutzdaten dürfen maximal 1 KB groß sein, da sie ansonsten nicht als einzelne Nachricht für die Abrechnung betrachtet wird. Nutzlasten, die größer als dieser Grenzwert sind, werden als zusätzliche Nachrichten in 1 KB Schritten gezählt (daher wird eine Nachricht zwischen 1 KB und 2 KB als zwei Nachrichten gezählt, zwischen 2 KB und 3 KB drei Nachrichten usw.). Diese Einschränkung gilt auch für Antworten, sodass ein Aufruf, der 1,5 KB im Antworttext zurückgibt, beispielsweise als zwei Vorgänge in Rechnung gestellt wird.	Messungs-ID
BillingQueryUnits	Abrechnungsabfrageeinheiten	Anzahl	Gesamt	Die Anzahl der Abfrageeinheiten (ein intern berechnetes Measure der Dienstressourcennutzung), die zum Ausführen von Abfragen genutzt werden. Es ist auch eine Hilfs-API zum Messen von Abfrageeinheiten verfügbar: die QueryChargeHelper-Klasse.	Messungs-ID

Weitere Informationen zur Abrechnung für Azure Digital Twins finden Sie unter Preise für Azure Digital Twins.

Eingangsmetriken

Metriken für den Dateneingang:

Metrik	Anzeigename der Metrik	Einheit	Aggregationstyp	BESCHREIBUNG	Dimensionen
IngressEvents	Eingangsereignisse	Anzahl	Gesamt	Die Anzahl der in Azure Digital Twins eingehenden Gerätetelemetrieereignisse.	Ergebnis
IngressEventsFailureRate	Eingangsereignis-Fehlerrate	Prozent	Durchschnitt	Der Prozentsatz der eingehenden Gerätetelemetrieereignisse, bei denen der Dienst einen internen Fehlerantwortcode (500) zurückgibt.	Ergebnis
IngressEventsLatency	Latenz von Eingangsereignissen	Millisekunden	Durchschnitt	Die Zeit zwischen dem Eintreffen eines Ereignisses und dem Zeitpunkt, zu dem es von Azure Digital Twins ausgegeben werden kann, wobei der Dienst ein Erfolgs-/Fehlerergebnis sendet.	Ergebnis

Metriken für Massenvorgänge (aus den Auftrags-APIs)

Metriken für Massenvorgänge aus den Auftrags-APIs:

Metrik	Anzeigename der Metrik	Einheit	Aggregationstyp	BESCHREIBUNG	Dimensionen
ImportJobLatency	Wartezeit für Importaufträge	Millisekunden	Durchschnitt	Gesamtdauer bis zum Abschluss eines Importauftrags.	Betrieb, Authentifizierung, Protokoll
ImportJobEntityCount	Anzahl der Importauftragsentitäten	Anzahl	Gesamt	Die Anzahl der Zwillinge, Modelle oder Beziehungen, die durch einen Importauftrag verarbeitet wurden.	Betrieb, Ergebnis
DeleteJobLatency	Wartezeit für Löschaufträge	Millisekunden	Durchschnitt	Gesamtdauer bis zum Abschluss eines Löschauftrags.	Betrieb, Authentifizierung, Protokoll
DeleteJobEntityCount	Anzahl der Löschauftragsentitäten	Anzahl	Gesamt	Die Anzahl der Modelle, Zwillinge und/oder Beziehungen, die als Teil eines Löschauftrags gelöscht wurden.	Betrieb, Ergebnis

Routingmetriken

Metriken für Routing:

Metrik	Anzeigename der Metrik	Einheit	Aggregationstyp	BESCHREIBUNG	Dimensionen
MessagesRouted	Weitergeleitete Nachrichten	Anzahl	Gesamt	Die Anzahl von Nachrichten, die an einen Azure-Endpunktdienst wie Event Hubs, Service Bus oder Event Grid geleitet werden.	Endpunkttyp, Ergebnis
RoutingFailureRate	Routingfehlerrate	Prozent	Durchschnitt	Der Prozentsatz der Ereignisse, die zu einem Fehler führen, wenn sie von Azure Digital Twins zu einem Azure-Endpunktdienst wie Event Hubs, Service Bus oder Event Grid weitergeleitet werden.	Endpunkttyp, Ergebnis
RoutingLatency	Routinglatenz	Millisekunden	Durchschnitt	Die Zeit zwischen der Weiterleitung eines Ereignisses von Azure Digital Twins bis zu dem Zeitpunkt, an dem es an den Azure-Endpunktdienst wie Event Hubs, Service Bus oder Event Grid gesendet wird.	Endpunkttyp, Ergebnis

Metrikdimensionen

Dimensionen helfen bei der Identifizierung weiterer Details zu Metriken. Einige Routingmetriken bieten Informationen zu den einzelnen Endpunkten. In der folgenden Tabelle sind mögliche Werte für diese Dimensionen aufgeführt.

Abmessung	Werte
Authentifizierung	OAuth
Vorgang (für API-Anforderungen)	Microsoft.DigitalTwins/digitaltwins/delete, Microsoft.DigitalTwins/digitaltwins/write, Microsoft.DigitalTwins/digitaltwins/read, Microsoft.DigitalTwins/eventroutes/read, Microsoft.DigitalTwins/eventroutes/write, Microsoft.DigitalTwins/eventroutes/delete, Microsoft.DigitalTwins/models/read, Microsoft.DigitalTwins/models/write, Microsoft.DigitalTwins/models/delete, Microsoft.DigitalTwins/query/action
Endpunkttyp	Ereignisraster, Event Hubs, Dienstbus
Protokoll	HTTPS
Ergebnis	Erfolg, Fehler
Statuscode	200, 404, 500 usw.
Statuscodeklasse	2xx, 4xx, 5xx usw.
Statustext	Interner Serverfehler, Nicht gefunden, usw.

Diagnoseprotokolle

Allgemeine Informationen zu Azure-Diagnoseeinstellungen, einschließlich ihrer Aktivierung, finden Sie unter Diagnoseeinstellungen in Azure Monitor. Informationen zum Abfragen von Diagnoseprotokollen mit Log Analytics finden Sie in der Übersicht über Log Analytics in Azure Monitor.

Im Rest dieses Abschnitts werden die Diagnoseprotokollkategorien beschrieben, die Azure Digital Twins sammeln kann, sowie deren Schemas.

Protokollkategorien

Nachfolgend finden Sie weitere Details zu den Protokollkategorien, die von Azure Digital Twins erfasst werden.

Protokollkategorie	BESCHREIBUNG
ADTModelsOperation	Protokollieren aller API-Aufrufe in Bezug auf Modelle
ADTQueryOperation	Protokollieren aller API-Aufrufe in Bezug auf Abfragen
ADTEventRoutesOperation	Protokolliert alle API-Aufrufe in Bezug auf Ereignisrouten sowie ausgehende Ereignisse von Azure Digital Twins an einen Endpunktdienst wie Event Grid, Event Hubs und Service Bus
ADTDigitalTwinsOperation	Protokollieren aller API-Aufrufe in Bezug auf einzelne Zwillinge

Jede Protokollkategorie besteht aus Schreib-, Lese-, Lösch- und Aktionsvorgängen. Diese Kategorien lassen sich REST-API-Aufrufen wie folgt zuordnen:

Ereignistyp	REST-API-Vorgänge
Schreiben	PUT und PATCH
Lesen	ERHALTEN/Bekommen
Löschen	Delete
Aktion	SENDEN

Die folgende Tabelle enthält eine umfassende Liste der Vorgänge und entsprechenden Azure Digital Twins REST API-Aufrufe , die in jeder Kategorie protokolliert werden.

Hinweis

Jede Protokollkategorie enthält mehrere Vorgänge/REST-API-Aufrufe. In der folgenden Tabelle ist jede Protokollkategorie allen Vorgängen/REST-API-Aufrufen darunter zugeordnet, bis die nächste Protokollkategorie aufgeführt ist.

Protokollkategorie	Vorgang	REST-API-Aufrufe und andere Ereignisse
ADTModelsOperation	Microsoft.DigitalTwins/models/write	API zum Aktualisieren von Digital Twin-Modellen
	Microsoft.DigitalTwins/models/read	APIs zum Abrufen nach ID und Auflisten von Digital Twin-Modellen
	Microsoft.DigitalTwins/models/delete	API zum Löschen von Digital Twin-Modellen
	Microsoft.DigitalTwins/models/action	API zum Hinzufügen von Digital Twin-Modellen
ADTQueryOperation	Microsoft.DigitalTwins/query/action	API zum Abfragen von Digital Twin-Instanzen
ADTEventRoutesOperation	Microsoft.DigitalTwins/eventroutes/write	API zum Hinzufügen von Ereignisrouten
	Microsoft.DigitalTwins/eventroutes/read	APIs zum Abrufen nach ID und Auflisten von Ereignisrouten
	Microsoft.DigitalTwins/eventroutes/delete	API zum Löschen von Ereignisrouten
	Microsoft.DigitalTwins/eventroutes/action	Fehler beim Veröffentlichen von Ereignissen in einem Endpunktdienst (kein API-Aufruf).
ADTDigitalTwinsOperation	Microsoft.DigitalTwins/digitaltwins/write	Vorgänge zum Hinzufügen, Hinzufügen von Beziehungen, Aktualisieren und Aktualisieren von Komponenten von Digital Twins
	Microsoft.DigitalTwins/digitaltwins/read	Vorgänge zum Abrufen nach ID, Abrufen von Komponenten, Abrufen der Beziehung nach ID, Auflisten eingehender Beziehungen und Auflisten von Beziehungen von Digital Twins
	Microsoft.DigitalTwins/digitaltwins/delete	Vorgänge zum Löschen und Löschen von Beziehungen von Digital Twins
	Microsoft.DigitalTwins/digitaltwins/action	Senden von Komponententelemetrie und Senden von Telemetrie von Digital Twins

Protokollschemas

Jede Protokollkategorie verfügt über ein Schema, das definiert, wie Ereignisse in dieser Kategorie gemeldet werden. Jeder einzelne Protokolleintrag wird als Text gespeichert und als JSON-Blob formatiert. Die Felder im Protokoll und in den Beispiel-JSON-Daten werden in den folgenden Abschnitten für jeden Protokolltyp verfügbar gemacht.

ADTDigitalTwinsOperation, ADTModelsOperation und ADTQueryOperation verwenden ein konsistentes API-Protokollschema. ADTEventRoutesOperation erweitert das Schema so, dass es ein endpointName-Feld in den Eigenschaften enthält.

API-Protokollschemas

Dieses Protokollschema ist für ADTDigitalTwinsOperation, ADTModelsOperation und ADTQueryOperation konsistent. Dasselbe Schema wird auch für ADTEventRoutesOperation verwendet, mit Ausnahme des Vorgangsnamens Microsoft.DigitalTwins/eventroutes/action (weitere Informationen zu diesem Schema finden Sie im nächsten Abschnitt: Ausgangsprotokollschemas).

Das Schema enthält Informationen, die für API-Aufrufe an eine Azure Digital Twins-Instanz relevant sind.

Im Folgenden finden Sie die Feld- und Eigenschaftsbeschreibungen für API-Protokolle.

Feldname	Datentyp	BESCHREIBUNG
Time	Datum/Uhrzeit	Datum und Uhrzeit des Auftretens dieses Ereignisses in UTC
ResourceId	Schnur	Azure Resource Manager-Ressourcen-ID für die Ressource, in der das Ereignis aufgetreten ist
OperationName	Schnur	Typ der Aktion, die während des Ereignisses ausgeführt wurde
OperationVersion	Schnur	Während des Ereignisses verwendete API-Version
Category	Schnur	Typ der auszugebenden Ressource
ResultType	Schnur	Ergebnis des Ereignisses
ResultSignature	Schnur	HTTP-Statuscode für das Ereignis
ResultDescription	Schnur	Weitere Details zum Ereignis
DurationMs	Schnur	Zeit für die Ausführung des Ereignisses in Millisekunden
CallerIpAddress	Schnur	Maskierte Quell-IP-Adresse für das Ereignis
CorrelationId	Leitfaden	Eindeutiger Bezeichner für das Ereignis
ApplicationId	Leitfaden	Bei der Bearer-Autorisierung verwendete Anwendungs-ID
Level	Integer	Protokollschweregrad des Ereignisses
Location	Schnur	Region, in der das Ereignis aufgetreten ist
RequestUri	URI	Während des Ereignisses verwendeter Endpunkt
TraceId	Schnur	TraceId aus dem W3C-Ablaufverfolgungskontext. Die ID der gesamten Ablaufverfolgung, die zur systemübergreifenden eindeutigen Identifizierung einer verteilten Ablaufverfolgung verwendet wird
SpanId	Schnur	SpanId aus dem W3C-Ablaufverfolgungskontext. Die ID dieser Anforderung in der Ablaufverfolgung
ParentId	Schnur	ParentId aus dem W3C-Ablaufverfolgungskontext. Eine Anforderung ohne übergeordnete ID ist der Stamm der Ablaufverfolgung.
TraceFlags	Schnur	TraceFlags aus dem W3C-Ablaufverfolgungskontext. Steuert Ablaufverfolgungsflags wie Sampling, Ablaufverfolgungsebene usw.
TraceState	Schnur	TraceState aus dem W3C-Ablaufverfolgungskontext. Zusätzliche herstellerspezifische Informationen zur Ablaufverfolgungsidentifizierung, die verschiedene Systeme für die verteilte Ablaufverfolgung umfassen sollen.

Die folgenden Abschnitte zeigen Beispiel-JSON-Textkörper für diese Arten von Protokollen.

ADTDigitalTwinsOperation

{
  "time": "2020-03-14T21:11:14.9918922Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/digitaltwins/write",
  "operationVersion": "2020-10-31",
  "category": "DigitalTwinOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": 8,
  "callerIpAddress": "13.68.244.*",
  "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/digitaltwins/factory-58d81613-2e54-4faa-a930-d980e6e2a884?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTModelsOperation

{
  "time": "2020-10-29T21:12:24.2337302Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/models/write",
  "operationVersion": "2020-10-31",
  "category": "ModelsOperation",
  "resultType": "Success",
  "resultSignature": "201",
  "resultDescription": "",
  "durationMs": "80",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/Models?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTQueryOperation

{
  "time": "2020-12-04T21:11:44.1690031Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/query/action",
  "operationVersion": "2020-10-31",
  "category": "QueryOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": "314",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "cccc2222-dd33-4444-55ee-666666ffffff",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/query?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTEventRoutesOperation

Nachfolgend finden Sie einen JSON-Beispieltext für einen ADTEventRoutesOperation, der nicht vom Microsoft.DigitalTwins/eventroutes/action-Typ ist (weitere Informationen zu diesem Schema finden Sie im nächsten Abschnitt: Ausgangsprotokollschemas).

  {
    "time": "2020-10-30T22:18:38.0708705Z",
    "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
    "operationName": "Microsoft.DigitalTwins/eventroutes/write",
    "operationVersion": "2020-10-31",
    "category": "EventRoutesOperation",
    "resultType": "Success",
    "resultSignature": "204",
    "resultDescription": "",
    "durationMs": 42,
    "callerIpAddress": "212.100.32.*",
    "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
    "identity": {
      "claims": {
        "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
      }
    },
    "level": "4",
    "location": "southcentralus",
    "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/EventRoutes/egressRouteForEventHub?api-version=2020-10-31",
    "properties": {},
    "traceContext": {
      "traceId": "95ff77cfb300b04f80d83e64d13831e7",
      "spanId": "b630da57026dd046",
      "parentId": "9f0de6dadae85945",
      "traceFlags": "01",
      "tracestate": "k1=v1,k2=v2"
    }
  },

Ausgangsprotokollschemas

Das folgende Beispiel ist das Schema für ADTEventRoutesOperation-Protokolle, die für den Vorgangsnamen Microsoft.DigitalTwins/eventroutes/action spezifisch sind. Diese enthalten Details zu Ausnahmen und den API-Vorgängen für Ausgangsendpunkte, die mit einer Instanz von Azure Digital Twins verbunden sind.

Feldname	Datentyp	BESCHREIBUNG
Time	Datum/Uhrzeit	Datum und Uhrzeit des Auftretens dieses Ereignisses in UTC
ResourceId	Schnur	Azure Resource Manager-Ressourcen-ID für die Ressource, in der das Ereignis aufgetreten ist
OperationName	Schnur	Typ der Aktion, die während des Ereignisses ausgeführt wurde
Category	Schnur	Typ der auszugebenden Ressource
ResultDescription	Schnur	Weitere Details zum Ereignis
CorrelationId	Leitfaden	Vom Kunden angegebener eindeutiger Bezeichner für das Ereignis
ApplicationId	Leitfaden	Bei der Bearer-Autorisierung verwendete Anwendungs-ID
Level	Integer	Protokollschweregrad des Ereignisses
Location	Schnur	Region, in der das Ereignis aufgetreten ist
TraceId	Schnur	TraceId aus dem W3C-Ablaufverfolgungskontext. Die ID der gesamten Ablaufverfolgung, die zur systemübergreifenden eindeutigen Identifizierung einer verteilten Ablaufverfolgung verwendet wird
SpanId	Schnur	SpanId aus dem W3C-Ablaufverfolgungskontext. Die ID dieser Anforderung in der Ablaufverfolgung
ParentId	Schnur	ParentId aus dem W3C-Ablaufverfolgungskontext. Eine Anforderung ohne übergeordnete ID ist der Stamm der Ablaufverfolgung.
TraceFlags	Schnur	TraceFlags aus dem W3C-Ablaufverfolgungskontext. Steuert Ablaufverfolgungsflags wie Sampling, Ablaufverfolgungsebene usw.
TraceState	Schnur	TraceState aus dem W3C-Ablaufverfolgungskontext. Zusätzliche herstellerspezifische Informationen zur Ablaufverfolgungsidentifizierung, die verschiedene Systeme für die verteilte Ablaufverfolgung umfassen sollen.
EndpointName	Schnur	Name des Ausgangsendpunkts, der in Azure Digital Twins erstellt wurde

Hier sehen Sie einen JSON-Beispieltext für ADTEventRoutesOperation vom Typ Microsoft.DigitalTwins/eventroutes/action.

{
  "time": "2020-11-05T22:18:38.0708705Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/eventroutes/action",
  "operationVersion": "",
  "category": "EventRoutesOperation",
  "resultType": "",
  "resultSignature": "",
  "resultDescription": "Unable to send EventHub message to [myPath] for event Id [f6f45831-55d0-408b-8366-058e81ca6089].",
  "durationMs": -1,
  "callerIpAddress": "",
  "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "",
  "properties": {
    "endpointName": "myEventHub"
  },
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
},

Nächste Schritte

Weitere Informationen zu Azure Monitor und seinen Funktionen finden Sie in der Azure Monitor-Dokumentation.