Surveiller les références de données du service IoT Hub Device Provisioning

  • Article

Pour plus d’informations sur la collecte et l’analyse des données de surveillance pour le service Azure IoT Hub Device Provisioning (DPS), consultez Surveillance du service Hub Device Provisioning.

Métriques

Cette section répertorie toutes les métriques de plateforme collectées automatiquement pour DPS.

Fournisseur de ressources et type : Microsoft.Devices/provisioningServices.

Métrique Exportable par le biais des paramètres de diagnostic ? Nom d’affichage de la métrique Unité Type d’agrégation Description Dimensions
AttestationAttempts Oui Tentatives d’attestation Count Total Nombre d’attestations d’appareils tentées ProvisioningServiceName, Status, Protocol
DeviceAssignments Oui Appareils attribués Count Total Nombre d’appareils affectés à un hub IoT ProvisioningServiceName, IotHubName
RegistrationAttempts Oui Tentatives d’enregistrement Count Total Nombre d’inscriptions d’appareils tentées ProvisioningServiceName, IotHubName, Status

Pour plus d’informations, consultez la liste de toutes les métriques de plateforme prises en charge dans Azure Monitor.

Dimensions de métrique

DPS a les dimensions suivantes associées à ses métriques.

Nom de la dimension Description
IoTHubName Nom du hub IoT cible.
Protocol Protocole d’appareil ou de service utilisé.
ProvisioningServiceName Nom de l’instance DPS.
État État de l'opération.

Pour plus d’informations sur les dimensions de métrique, consultez Métriques multidimensionnelles.

Journaux d’activité de ressources

Cette section répertorie les types de journaux de ressources que vous pouvez collecter pour DPS.

Fournisseur de ressources et type : Microsoft.Devices/provisioningServices.

Category Description
DeviceOperations Journaux relatifs aux événements d’attestation d’appareil. Consultez les API d’appareil répertoriées dans les Opérations de service facturables et tarification.
ServiceOperations Journaux liés aux événements de service DPS. Consultez les API du service DPS répertoriées dans les Opérations de service facturables et tarification.

Pour référence, consultez la liste de tous les types de catégories de journaux de ressources pris en charge dans Azure Monitor.

DPS utilise la table AzureDiagnostics pour stocker les informations du journal des ressources. Les colonnes suivantes sont pertinentes.

Propriété Type de données Description
ApplicationId GUID ID d’application utilisé dans l’autorisation du porteur.
callerIpAddress String Adresse IP source masquée de l’événement.
Catégorie Chaîne Type d’opération : ServiceOperations ou DeviceOperations.
CorrelationId GUID Identificateur unique de l’événement.
DurationMs String Durée de l’exécution de l’événement, en millisecondes.
Niveau Int Niveau de gravité de journalisation de l’événement. Par exemple, Information ou Erreur.
NomOpération Chaîne Type d’action réalisée pendant l'événement. Par exemple : Requête, Get, Upsert, et ainsi de suite.
OperationVersion Chaîne Version de l'API utilisée pendant l'événement.
Ressource Chaîne Nom de la ressource pour OF où l’événement a eu lieu. Par exemple, « MYEXAMPLEDPS ».
ResourceGroup Chaîne Nom du groupe de ressources dans lequel se trouve la ressource.
ResourceId String ID de la ressource Azure Resource Manager où l’événement a eu lieu.
ResourceProvider Chaîne Fournisseur de ressources pour l’événement. Par exemple, « MICROSOFT.DEVICES ».
ResourceType Chaîne Type de ressource de l’événement. Par exemple, « PROVISIONINGSERVICES ».
ResultDescription Chaîne Détails d’erreur de l’événement en cas d’échec.
ResultSignature Chaîne État HTTP de l’événement en cas d’échec.
ResultType Chaîne Résultat de l’événement : Réussite, Échec, ClientError, et ainsi de suite.
SubscriptionId GUID ID d’abonnement de l’abonnement Azure où se trouve la ressource.
TenantId GUID ID de locataire pour le locataire Azure où se trouve la ressource.
TimeGenerated Date et heure Date et heure (au format UTC) auxquelles cet événement s’est produit.
location_s Chaîne Région Azure où s'est produit l'événement.
properties_s JSON Informations supplémentaires pour l’événement.

DeviceOperations

Le code JSON suivant est un exemple de tentative d’attestation réussie à partir d’un appareil. L’ID d’inscription de l’appareil est identifié dans la propriété properties_s.

  {
    "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

Le code JSON suivant est un exemple d’opération d’ajout (Upsert) d’inscription individuelle réussie. L’ID et le type d’inscription de l’inscription sont identifiés dans la propriété properties_s.

  {
    "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\"}",
  }

Tables Azure Monitor Logs

Cette section fait référence à toutes les tables Kusto d’Azure Monitor Logs pertinentes pour DPS et disponibles pour une requête par Log Analytics. Pour obtenir la liste de ces tables et des liens vers des informations supplémentaires sur le type de ressource DPS, consultez Services Device Provisioning dans la référence de table Azure Monitor Logs.

Pour obtenir une référence de toutes les tables Azure Monitor Logs/Log Analytics, consultez la référence relative aux tables Azure Monitor Logs.

Journal d’activité

Pour plus d’informations sur le schéma des entrées du journal d’activité, consultez Schéma du journal d’activité.

Voir aussi