Ü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. Anhand dieser Protokolle können Sie besser verstehen, was in Ihrer Azure Digital Twins-Instanz geschieht, und die Ursachen von Problemen analysieren, ohne den Azure-Support kontaktieren zu müssen.
Sie können darauf über das Azure-Portal zugreifen. Die Informationen werden unter der Überschrift Überwachung für die Azure Digital Twins-Ressource gruppiert.
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 im Zusammenhang mit API-Anforderungen:
| Metrik | Anzeigename der Metrik | Einheit | Aggregationstyp | BESCHREIBUNG | Dimensionen |
|---|---|---|---|---|---|
| ApiRequests | 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 | Percent | Average | 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 |
| ApiRequestsLatency | API-Anforderungslatenz | Millisekunden | Average | 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 im Zusammenhang mit 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. Umfangreichere Nutzdaten werden als zusätzliche Nachrichten in Schritten von 1 KB gezählt (eine Nachricht zwischen 1 KB und 2 KB wird also als zwei Nachrichten gezählt, eine Nachricht zwischen 2 KB und 3 KB als drei Nachrichten usw.). Diese Einschränkung gilt auch für Antworten: Ein Aufruf, der 1,5 KB im Antworttext zurückgibt, wird beispielsweise als zwei Vorgänge in Rechnung gestellt. |
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 im Zusammenhang mit 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 | Percent | Average | Der Prozentsatz der eingehenden Gerätetelemetrieereignisse, bei denen der Dienst einen internen Fehlerantwortcode (500) zurückgibt. | Ergebnis |
| IngressEventsLatency | Latenz von Eingangsereignissen | Millisekunden | Average | 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, die mit Massenvorgängen aus den Auftrags-APIs:
| Metrik | Anzeigename der Metrik | Einheit | Aggregationstyp | BESCHREIBUNG | Dimensionen |
|---|---|---|---|---|---|
| ImportJobLatency | Wartezeit für Importaufträge | Millisekunden | Average | 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 | Average | 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 im Zusammenhang mit 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 | Percent | Average | 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 | Average | 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
Mit Dimensionen lassen sich genauere Details zu den Metriken ermitteln. Einige Routingmetriken bieten Informationen zu den einzelnen Endpunkten. In der folgenden Tabelle sind die möglichen Werte für diese Dimensionen aufgeführt.
| Dimension | 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 | Event Grid, Event Hubs, Service Bus |
| Protocol | 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 mithilfe von Log Analytics finden Sie unter Ü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 | GET |
| Löschen | Delete |
| Aktion | POST |
Im Folgenden finden Sie eine umfassende Liste der Vorgänge und entsprechenden REST-API-Aufrufe für Azure Digital Twins, 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 darunter aufgeführten Vorgänge/REST-API-Aufrufen zugeordnet, anschließend folgt die nächste Kategorie.
| 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 die JSON-Beispieltexte werden für jeden unten angegebenen Protokolltyp bereitgestellt.
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 |
DateTime | Datum und Uhrzeit des Auftretens dieses Ereignisses in UTC |
ResourceId |
String | Azure Resource Manager-Ressourcen-ID für die Ressource, in der das Ereignis aufgetreten ist |
OperationName |
String | Typ der Aktion, die während des Ereignisses ausgeführt wurde |
OperationVersion |
String | Während des Ereignisses verwendete API-Version |
Category |
String | Typ der auszugebenden Ressource |
ResultType |
String | Ergebnis des Ereignisses |
ResultSignature |
String | HTTP-Statuscode für das Ereignis |
ResultDescription |
String | Weitere Details zum Ereignis |
DurationMs |
String | Zeit für die Ausführung des Ereignisses in Millisekunden |
CallerIpAddress |
String | Maskierte Quell-IP-Adresse für das Ereignis |
CorrelationId |
Guid | Eindeutiger Bezeichner für das Ereignis |
ApplicationId |
Guid | Bei der Bearer-Autorisierung verwendete Anwendungs-ID |
Level |
Int | Protokollschweregrad des Ereignisses |
Location |
String | Region, in der das Ereignis aufgetreten ist |
RequestUri |
URI | Während des Ereignisses verwendeter Endpunkt |
TraceId |
String | TraceId aus dem W3C-Ablaufverfolgungskontext. Die ID der gesamten Ablaufverfolgung, die zur systemübergreifenden eindeutigen Identifizierung einer verteilten Ablaufverfolgung verwendet wird |
SpanId |
String | SpanId aus dem W3C-Ablaufverfolgungskontext. Die ID dieser Anforderung in der Ablaufverfolgung |
ParentId |
String | ParentId aus dem W3C-Ablaufverfolgungskontext. Eine Anforderung ohne übergeordnete ID ist der Stamm der Ablaufverfolgung. |
TraceFlags |
String | TraceFlags aus dem W3C-Ablaufverfolgungskontext. Steuert Ablaufverfolgungsflags wie Sampling, Ablaufverfolgungsebene usw. |
TraceState |
String | TraceState aus dem W3C-Ablaufverfolgungskontext. Zusätzliche herstellerspezifische Informationen zur Ablaufverfolgungsidentifizierung, die verschiedene Systeme für die verteilte Ablaufverfolgung umfassen sollen. |
Im Folgenden finden Sie Beispiel-JSON-Texte 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 |
DateTime | Datum und Uhrzeit des Auftretens dieses Ereignisses in UTC |
ResourceId |
String | Azure Resource Manager-Ressourcen-ID für die Ressource, in der das Ereignis aufgetreten ist |
OperationName |
String | Typ der Aktion, die während des Ereignisses ausgeführt wurde |
Category |
String | Typ der auszugebenden Ressource |
ResultDescription |
String | Weitere Details zum Ereignis |
CorrelationId |
Guid | Vom Kunden angegebener eindeutiger Bezeichner für das Ereignis |
ApplicationId |
Guid | Bei der Bearer-Autorisierung verwendete Anwendungs-ID |
Level |
Int | Protokollschweregrad des Ereignisses |
Location |
String | Region, in der das Ereignis aufgetreten ist |
TraceId |
String | TraceId aus dem W3C-Ablaufverfolgungskontext. Die ID der gesamten Ablaufverfolgung, die zur systemübergreifenden eindeutigen Identifizierung einer verteilten Ablaufverfolgung verwendet wird |
SpanId |
String | SpanId aus dem W3C-Ablaufverfolgungskontext. Die ID dieser Anforderung in der Ablaufverfolgung |
ParentId |
String | ParentId aus dem W3C-Ablaufverfolgungskontext. Eine Anforderung ohne übergeordnete ID ist der Stamm der Ablaufverfolgung. |
TraceFlags |
String | TraceFlags aus dem W3C-Ablaufverfolgungskontext. Steuert Ablaufverfolgungsflags wie Sampling, Ablaufverfolgungsebene usw. |
TraceState |
String | TraceState aus dem W3C-Ablaufverfolgungskontext. Zusätzliche herstellerspezifische Informationen zur Ablaufverfolgungsidentifizierung, die verschiedene Systeme für die verteilte Ablaufverfolgung umfassen sollen. |
EndpointName |
String | 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.