Freigeben über

Azure IoT Hub Device Provisioning Service – Überwachungsdatenverweis

  • Artikel

Dieser Artikel enthält alle Referenzinformationen zur Überwachung dieses Dienstes.

Ausführliche Informationen zu den Daten, die Sie für den Bereitstellungsdienst für IoT Hub-Geräte sammeln können, finden Sie unter Überwachen des Azure IoT Hub-Gerätebereitstellungsdiensts und deren Verwendung.

Metriken

In diesem Abschnitt werden alle automatisch erfassten Plattformmetriken für diesen Dienst aufgeführt. Diese Metriken sind auch Teil der globalen Liste aller in Azure Monitor unterstützten Plattformmetriken.

Informationen zur Aufbewahrung von Metriken finden Sie unter Überblick über Metriken in Azure Monitor.

Unterstützte Metriken für Microsoft.Devices/provisioningServices

In der folgenden Tabelle sind die Metriken aufgeführt, die für den Ressourcentyp "Microsoft.Devices/provisioningServices" verfügbar sind.

  • Möglicherweise sind nicht alle Spalten in jeder Tabelle vorhanden.
  • Einige Spalten können über den Anzeigebereich der Seite hinausgehen. Wählen Sie Tabelle erweitern aus, um alle verfügbaren Spalten anzuzeigen.

Tabellenüberschriften

  • Kategorie – Die Metrikgruppe oder -klassifizierung.
  • Metrik – Der Anzeigename der Metrik, wie er im Azure-Portal angezeigt wird.
  • Name in REST-API: Der Metrikname im REST-API
  • Einheit – Abrechnungseinheit.
  • Aggregation – Der Standard-Aggregationstyp. Gültige Werte: Mittelwert (Avg), Minimum (Min), Maximum (Max), Gesamt (Sum), Anzahl
  • Dimensionen - Für die Metrik verfügbare Dimensionen.
  • Aggregationsintervall - Intervalle, in denen die Metrik gesampelt wird. PT1M bedeutet zum Beispiel, dass die Metrik jede Minute abgerufen wird, PT30M alle 30 Minuten, PT1H jede Stunde usw.
  • DS-Export – Gibt an, ob die Metrik über Diagnose-Einstellungen in Azure Monitor-Protokolle exportiert werden kann. Informationen zum Exportieren von Metriken finden Sie unter Diagnoseeinstellungen in Azure Monitor erstellen.
Metrik Name in der REST-API Einheit Aggregation Dimensionen Aggregationsintervalle DS-Export
Nachweisversuche

Anzahl von versuchten Gerätenachweisen		 AttestationAttempts Anzahl Gesamt (Summe) ProvisioningServiceName, StatusProtocol PT1M Ja
Zugewiesene Geräte

Anzahl von Geräten, die einem IoT-Hub zugewiesen sind		 DeviceAssignments Anzahl Gesamt (Summe) ProvisioningServiceName, IotHubName PT1M Ja
Registrierungsversuche

Anzahl von versuchten Geräteregistrierungen		 RegistrationAttempts Anzahl Gesamt (Summe) ProvisioningServiceName, IotHubNameStatus PT1M Ja

Metrikdimensionen

Informationen darüber, was metrische Dimensionen sind, finden Sie unter Mehrdimensionale Metriken.

Bei diesem Dienst gelten die folgenden Dimensionen für die zugehörigen Metriken.

Dimensionsname Beschreibung
IotHubName Der Name des IoT-Zielhubs
Protokoll Das verwendete Geräte- oder Dienstprotokoll
ProvisioningServiceName Der Name der DPS-Instanz
Status Der Status des Vorgangs.

Weitere Informationen zu Metrikdimensionen finden Sie unter Mehrdimensionale Metriken.

Ressourcenprotokolle

In diesem Abschnitt werden die Ressourcenprotokolltypen aufgeführt, die für diesen Service erfasst werden können. Der Abschnitt wird aus der Liste aller in Azure Monitor unterstützten Kategorietypen für Ressourcenprotokolle gezogen.

Unterstützte Ressourcenprotokolle für Microsoft.Devices/provisioningServices

Kategorie Anzeigename der Kategorie Protokolltabelle Unterstützt grundlegenden Protokollplan Unterstützt die Erfassungszeittransformation Beispielabfragen Exportkosten
DeviceOperations Gerätevorgänge AzureDiagnostics

Protokolle aus mehreren Azure-Ressourcen.

 No No Abfragen No
ServiceOperations Dienstoperationen AzureDiagnostics

Protokolle aus mehreren Azure-Ressourcen.

 No No Abfragen No

Die folgende Liste enthält zusätzliche Informationen zu den vorherigen Protokollen:

Eine Referenz finden Sie in der Liste aller Typen von Ressourcenprotokollkategorien, die in Azure Monitor unterstützt werden.

DPS verwendet die Tabelle AzureDiagnostics zum Speichern von Ressourcenprotokollinformationen. Die folgenden Spalten sind relevant.

Eigenschaft Datentyp Beschreibung
ApplicationId GUID Bei der Bearerautorisierung verwendete Anwendungs-ID
CallerIpAddress String Eine maskierte Quell-IP-Adresse für das Ereignis
Kategorie String Typ des Vorgangs, entweder ServiceOperations oder DeviceOperations.
CorrelationId GUID Eindeutiger Bezeichner für das Ereignis.
DurationMs String Wie lange die Ausführung des Ereignisses in Millisekunden dauern soll
Ebene Int Der Protokollierungsschweregrad des Ereignisses Beispiel: „Information“ oder „Error“.
Vorgangsname String Typ der Aktion, die während des Ereignisses ausgeführt wurde. Beispiel: Abfrage, Get, Upsert usw.
OperationVersion String Die während des Ereignisses verwendete API-Version
Resource String Der Name der Ressource, auf der das Ereignis stattgefunden hat. Beispiel: MYEXAMPLEDPS.
ResourceGroup String Der Name der Ressourcengruppe, in der sich die Ressource befindet
resourceId String Die Azure Resource Manager Ressourcen-ID für die Ressource, in der das Ereignis stattgefunden hat
ResourceProvider String Der Ressourcenanbieter für das Ereignis. Beispiel: MICROSOFT.DEVICES.
ResourceType String Der Ressourcentyp für das Ereignis. Beispiel: PROVISIONINGSERVICES.
ResultDescription String Fehlerdetails für das Ereignis (wenn nicht erfolgreich)
ResultSignature String HTTP-Statuscode für das Ereignis (wenn nicht erfolgreich)
ResultType String Ergebnis des Ereignisses: Success, Failure, ClientError usw.
SubscriptionId GUID Die Abonnement-ID des Azure-Abonnements, in dem sich die Ressource befindet
TenantId GUID Die Mandanten-ID für den Azure-Mandanten, in dem sich die Ressource befindet
TimeGenerated DateTime Datum und Uhrzeit des Ereignisses in UTC
location_s String Die Azure-Region, in der das Ereignis eingetreten ist
properties_s JSON Weitere Informationen zu dem Ereignis

DeviceOperations

Der folgende JSON-Code ist ein Beispiel für einen erfolgreichen Nachweisversuch eines Geräts. Die Registrierungs-ID für das Gerät wird in der properties_s-Eigenschaft angegeben.

  {
    "CallerIPAddress": "24.18.226.XXX",
    "Category": "DeviceOperations",
    "CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "DurationMs": "226",
    "Level": "Information",
    "OperationName": "AttestationAttempt",
    "OperationVersion": "March2019",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/747F1067-xxx-xxx-xxxx-9DEAA894152F/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "747F1067-xxx-xxx-xxxx-9DEAA894152F",
    "TenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated": "2022-04-02T00:05:51Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/747F1067-xxx-xxx-xxxx-9DEAA894152F/resourcegroups/myresourcegroup/providers/microsoft.devices/provisioningservices/myexampledps",
    "location_s": "centralus",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"Registration\",\"protocol\":\"Mqtt\"}",
  }

ServiceOperations

Der folgende JSON-Code ist ein Beispiel für das erfolgreiche Hinzufügen (Upsert) einer einzelnen Registrierung. Die Registrierungs-ID für die Registrierung und der Typ der Registrierung werden in der properties_s-Eigenschaft angegeben.

  {
    "CallerIPAddress": "13.91.244.XXX",
    "Category": "ServiceOperations",
    "CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "DurationMs": "98",
    "Level": "Information",
    "OperationName": "Upsert",
    "OperationVersion": "October2021",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "TenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated": "2022-04-01T00:52:00Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myresourcegroup/providers/microsoft.devices/provisioningservices/myexampledps",
    "location_s": "centralus",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"IndividualEnrollment\",\"protocol\":\"Http\"}",
  }

Tabellen in Azure Monitor-Protokollen

Dieser Abschnitt bezieht sich die für diesen Service relevanten Azure-Monitor-Protokolltabellen, die für die Abfrage durch Protokollanalyse mit Kusto-Abfragen zur Verfügung stehen. Diese Tabellen enthalten Ressourcenprotokolldaten und möglicherweise mehr, je nachdem, was erfasst und an sie weitergeleitet wird.

IoT Hub Device Provisioning Service Microsoft.Devices/ProvisioningServices

Aktivitätsprotokoll

In der verknüpften Tabelle sind die Vorgänge aufgeführt, die im Aktivitätsprotokoll für diesen Dienst aufgezeichnet werden können. Diese Operationen sind eine Teilmenge aller möglichen Ressourcenanbietervorgänge im Aktivitätsprotokoll.

Weitere Informationen zum Schema von Aktivitätsprotokolleinträgen finden Sie unter Ereignisschema des Azure-Aktivitätsprotokolls.

Zugehöriger Inhalt