Azure IoT Hub Device Provisioning Service – Überwachungsdatenverweis
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 | Summe (Summe) | ProvisioningServiceName , Status Protocol |
PT1M | Ja |
Zugewiesene Geräte Anzahl von Geräten, die einem IoT-Hub zugewiesen sind |
DeviceAssignments |
Anzahl | Summe (Summe) | ProvisioningServiceName , IotHubName |
PT1M | Ja |
Registrierungsversuche Anzahl von versuchten Geräteregistrierungen |
RegistrationAttempts |
Anzahl | Summe (Summe) | ProvisioningServiceName , IotHubName Status |
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:
- 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": "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": "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": "aaaa0000-bb11-2222-33cc-444444dddddd",
"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 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
- Eine Beschreibung des Überwachens des IoT Hub-Gerätebereitstellungsdiensts finden Sie unter Überwachen des Bereitstellungsdiensts für IoT-Hub-Geräte.
- Weitere Informationen zur Überwachung von Azure-Ressourcen finden Sie unter Überwachen von Azure-Ressourcen mit Azure Monitor.