Referenz zu Überwachungsdaten für Azure IoT Hub Device Provisioning Service

  • Artikel

Ausführliche Informationen zum Sammeln und Analysieren von Überwachungsdaten für Azure IoT Hub Device Provisioning Service (DPS) finden Sie unter Überwachen von IoT Hub Device Provisioning Service.

metrics

In diesem Abschnitt werden alle automatisch erfassten Plattformmetriken für DPS aufgelistet.

Ressourcenanbieter und -typ: Microsoft.Devices/provisioningServices.

Metrik Über Diagnoseeinstellungen exportierbar? Metrikanzeigename Einheit Aggregationstyp BESCHREIBUNG Dimensionen
AttestationAttempts Ja Nachweisversuche Anzahl Gesamt Anzahl von versuchten Gerätenachweisen ProvisioningServiceName, Status, Protokoll
DeviceAssignments Ja Zugewiesene Geräte Anzahl Gesamt Anzahl von Geräten, die einem IoT-Hub zugewiesen sind ProvisioningServiceName, IotHubName
RegistrationAttempts Ja Registrierungsversuche Anzahl Gesamt Anzahl von versuchten Geräteregistrierungen ProvisioningServiceName, IotHubName, Status

Weitere Informationen finden Sie in der Liste aller in Azure Monitor unterstützten Plattformmetriken.

Metrikdimensionen

Bei DPS 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 Typen von Ressourcenprotokollen aufgeführt, die Sie für DPS sammeln können.

Ressourcenanbieter und -typ: Microsoft.Devices/provisioningServices.

Category Beschreibung
DeviceOperations Protokolle im Zusammenhang mit Gerätenachweisereignissen. Weitere Informationen finden Sie unter den Geräte-APIs in Abrechenbare Dienstvorgänge und Preise.
ServiceOperations Protokolle im Zusammenhang mit DPS-Dienstereignissen. Weitere Informationen finden Sie unter den DPS-Dienst-APIs in Abrechenbare Dienstvorgänge und Preise.

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": "68952383-80c0-436f-a2e3-f8ae9a41c69d",
    "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": "37dcb621-xxxx-xxxx-xxxx-e8c8addbc4e5",
    "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": "23bd419d-d294-452b-9b1b-520afef5ef52",
    "DurationMs": "98",
    "Level": "Information",
    "OperationName": "Upsert",
    "OperationVersion": "October2021",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/747F1067-xxxx-xxxx-xxxx-9DEAA894152F/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "747f1067-xxxx-xxxx-xxxx-9deaa894152f",
    "TenantId": "37dcb621-xxxx-xxxx-xxxx-e8c8addbc4e5",
    "TimeGenerated": "2022-04-01T00:52:00Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/747F1067-xxxx-xxxx-xxxx-9DEAA894152F/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 auf alle Kusto-Tabellen in Azure Monitor-Protokollen, die für DPS relevant und für die Abfrage durch Log Analytics verfügbar sind. Eine Liste dieser Tabellen sowie Links zu weiteren Informationen für den Ressourcentyp „DPS“ finden Sie unter Device Provisioning Service in der Referenz zu Tabellen in Azure Monitor-Protokollen.

Eine Referenz zu allen Azure Monitor-Protokollen und Log Analytics-Tabellen finden Sie in der Referenz zu Tabellen in Azure Monitor-Protokollen.

Aktivitätsprotokoll

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

Weitere Informationen