Partilhar via

Monitorando a referência de dados do Serviço de Provisionamento de Dispositivo do Hub IoT do Azure

  • Artigo

Consulte Monitoring Iot Hub Device Provisioning Service para obter detalhes sobre como coletar e analisar dados de monitoramento para o DPS (Serviço de Provisionamento de Dispositivos) do Hub IoT do Azure.

Métricas do

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

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

Métrico Exportável através de configurações de diagnóstico? Nome de exibição da métrica Unidade Tipo de agregação Description Dimensões
AtestadoTentativas Sim Tentativas de atestado Contagem Total Número de atestados de dispositivo tentados ProvisioningServiceName, Status, Protocolo
DeviceAssignments Sim Dispositivos atribuídos Contagem Total Número de dispositivos atribuídos a um hub IoT ProvisioningServiceName, IotHubName
RegistoTentativas Sim Tentativas de registo Contagem Total Número de tentativas de registo de dispositivos ProvisioningServiceName, IotHubName, Status

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

Dimensões métricas

O DPS tem as seguintes dimensões associadas às suas métricas.

Nome da Dimensão Description
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.
Estado O estado da operação.

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

Registos do recurso

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 Description
DeviceOperations Logs relacionados a eventos de atestado de dispositivo. Consulte APIs de dispositivo listadas em Operações e preços de serviço faturáveis.
Operações de Serviço Logs relacionados a eventos de serviço DPS. Consulte APIs de serviço DPS listadas em Operações e preços de serviço faturáveis.

Para referência, consulte 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 Description
ApplicationId GUID ID do pedido utilizado na autorização ao 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 levou para realizar o evento em milissegundos.
Nível Int A gravidade do registro em log do evento. Por exemplo, Informação ou Erro.
OperationName String O tipo de ação realizada 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 paraOF o recurso onde o evento ocorreu. Por exemplo, "MYEXAMPLEDPS".
ResourceGroup String O nome do grupo de recursos onde o recurso está localizado.
ResourceId String A ID de Recurso do Azure Resource Manager para o recurso onde o evento ocorreu.
ResourceProvider String O provedor de recursos para o evento. Por exemplo, "MICROSOFT. DISPOSITIVOS".
ResourceType String O tipo de recurso para o evento. Por exemplo, "PROVISIONINGSERVICES".
ResultDescription String Detalhes do erro para o evento se não for bem-sucedido.
ResultSignature String Código de status HTTP para o evento se não tiver êxito.
ResultType String Resultado do evento: Sucesso, Fracasso, ClientError e assim por diante.
SubscriptionId GUID A ID de assinatura da assinatura do Azure onde o recurso está localizado.
Identificação do locatário GUID A ID do locatário do Azure onde o recurso está localizado.
TimeGenerated DateTime A data e hora em que este evento ocorreu, em UTC.
location_s String A região do Azure onde o evento ocorreu.
properties_s JSON Informações adicionais para o evento.

DeviceOperations

O JSON a seguir é um exemplo de uma tentativa de atestado bem-sucedida de um dispositivo. O ID de registo do dispositivo está identificado na properties_s propriedade.

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

Operações de Serviço

O JSON a seguir é um exemplo de uma operação de registro individual de adição (Upsert) bem-sucedida. O ID de registro para a inscrição e o tipo de inscrição são identificados no properties_s imóvel.

  {
    "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 Kusto de Logs do Azure Monitor relevantes para 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 DPS, consulte Serviços de provisionamento de dispositivo na referência da tabela Logs do Azure Monitor.

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

Registo de atividades

Para obter mais informações sobre o esquema de entradas do Log de Atividades, consulte Esquema do Log de Atividades.

Consulte Também