Monitoramento da referência de dados do Serviço de Provisionamento de Dispositivos no Hub IoT do Azure

  • Artigo

Consulte Monitoramento do Serviço de Provisionamento de Dispositivos no Hub IoT para obter detalhes sobre como coletar e analisar dados de monitoramento para o DPS (Serviço de Provisionamento de Dispositivos) no Hub IoT do Azure.

Métrica

Esta seção lista todas as métricas da plataforma coletadas automaticamente para o DPS.

Provedor de recursos e tipo: Microsoft.Devices/provisioningServices.

Métrica Exportável por meio das Configurações de Diagnóstico? Nome de exibição da métrica Unidade Tipo de agregação Descrição Dimensões
AttestationAttempts Yes Tentativas de atestado Contagem Total Número de tentativas de atestado do dispositivo ProvisioningServiceName, Status, Protocol
DeviceAssignments Yes Dispositivos atribuídos Contagem Total Número de dispositivos atribuídos a um hub IoT ProvisioningServiceName, IotHubName
RegistrationAttempts Yes Tentativas de Registro Contagem Total Número de tentativas de registros do dispositivo ProvisioningServiceName, IotHubName, Status

Para obter mais informações, veja uma lista de todas as métricas de plataforma com suporte no Azure Monitor.

Dimensões de métrica

O DPS tem as seguintes dimensões associadas a essas métricas.

Nome da dimensão Descrição
IotHubName O nome do hub IoT de destino.
Protocolo O dispositivo ou protocolo de serviço usado.
ProvisioningServiceName O nome da instância do DPS.
Status O status da operação.

Para obter mais informações sobre o que são dimensões de métrica, confira Métricas multidimensionais.

Logs de recursos

Esta seção lista os tipos de logs de recursos que você pode coletar para o DPS.

Provedor de recursos e tipo: Microsoft.Devices/provisioningServices.

Categoria Descrição
DeviceOperations Logs relacionados aos eventos de atestado de dispositivo. Consulte as APIs de dispositivo listadas em Operações de serviço faturáveis e preços.
ServiceOperations Logs relacionados a eventos de serviço DPS. Consulte as APIs de serviço DPS listadas em Operações de serviço faturáveis e preços.

Para referência, confira uma lista de todos os tipos de categoria de logs de recursos com suporte no Azure Monitor.

O DPS usa a tabela AzureDiagnostics para armazenar informações de log de recursos. As colunas a seguir são relevantes.

Propriedade Tipo de dados Descrição
IDdoAplicativo GUID ID do aplicativo usada na autorização de portador.
CallerIpAddress String Um endereço IP de origem mascarado para o evento.
Categoria String Tipo de operação, ServiceOperations ou DeviceOperations.
CorrelationId GUID Identificador exclusivo do evento.
DurationMs String Quanto tempo demorou para executar o evento em milissegundos.
Nível Int A severidade do registro em log do evento. Por exemplo, Informações ou Erro.
OperationName String O tipo de ação executada durante o evento. Por exemplo: Query, Get, Upsert e assim por diante.
OperationVersion String A versão da API usada durante o evento.
Recurso String O nome forOF do recurso em que o evento ocorreu. Por exemplo, "MYEXAMPLEDPS".
ResourceGroup String O nome do grupo de recursos em que o recurso de está localizado.
ResourceId String A ID do Recurso do Azure Resource Manager para o recurso em que o evento ocorreu.
ResourceProvider String O provedor de recursos para o evento. Por exemplo, "MICROSOFT.DEVICES".
ResourceType String O tipo de recurso para o evento. Por exemplo, "PROVISIONINGSERVICES".
ResultDescription String Detalhes do erro para o evento, se não tiver êxito.
ResultSignature String Código de status HTTP para o evento, se não tiver êxito.
ResultType String Resultado do evento: Êxito, falha, ClientError e assim por diante.
SubscriptionId GUID A ID da assinatura do Azure em que o recurso está localizado.
TenantId GUID A ID do locatário do Azure em que o recurso está localizado.
TimeGenerated Datetime A data e a hora em que esse evento ocorreu, em UTC.
location_s String A região do Azure na qual o evento ocorreu.
properties_s JSON Detalhes de informações adicionais para o evento.

DeviceOperations

O JSON a seguir é um exemplo de uma tentativa de atestado bem-sucedida de um dispositivo. A ID de registro do dispositivo é identificada na propriedade 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

O JSON a seguir é um exemplo de uma operação de registro individual de adição (Upsert) bem-sucedida. A ID do registro da inscrição e o tipo de inscrição são identificados na propriedade 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\"}",
  }

Tabelas de Logs do Azure Monitor

Esta seção refere-se a todas as tabelas do Kusto dos Logs do Azure Monitor relevantes para o DPS e disponíveis para consulta pelo Log Analytics. Para obter uma lista dessas tabelas e links para obter mais informações sobre o tipo de recurso do DPS, consulte Serviços de Provisionamento de Dispositivos na referência de tabela Logs do Azure Monitor.

Para obter uma referência de todas as tabelas de Logs do Azure Monitor/Log Analytics, confira a Referência da tabela de log do Azure Monitor.

Log de atividades

Para obter mais informações sobre o esquema de entradas do log de atividades, confira Esquema do log de atividades.

Confira também