Compartilhar via


Referência de dados de monitoramento do Serviço de Provisionamento de Dispositivos no Hub IoT do Azure

Este artigo contém todas as informações de referência de monitoramento para este serviço.

Consulte Monitorar o Serviço de Provisionamento de Dispositivos no Hub IoT do Azure para obter detalhes sobre os dados que você pode coletar para o Serviço de Provisionamento de Dispositivos no Hub IoT e como usá-los.

Métricas

Esta seção lista todas as métricas da plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas da plataforma com suporte no Azure Monitor.

Para obter informações sobre retenção de métricas, consulte Visão geral das métricas do Azure Monitor.

Métricas com suporte para Microsoft.Devices/provisioningServices

A tabela a seguir lista as métricas disponíveis para o tipo de recurso Microsoft.Devices/provisioningServices.

  • Nem todas as colunas podem estar presentes em todas as tabelas.
  • Algumas colunas podem estar além da área de visualização da página. Selecione Expandir tabela para exibir todas as colunas disponíveis.

Títulos de tabela

  • Categoria: o grupo ou classificação de métricas.
  • Métrica: o nome de exibição da métrica como aparece no portal do Azure.
  • Nome na API REST: o nome da métrica, conforme mencionado na API REST.
  • Unidade: unidade de medida
  • Agregação: o tipo de agregação padrão. Valores válidos: Médio (Méd.), Mínimo (Mín.), Máximo (Máx.), Total (Soma), Contagem.
  • Dimensões: as Dimensões disponíveis para a métrica.
  • Intervalos de agregação: os Intervalos em que a métrica é amostrada. Por exemplo, PT1M indica que a métrica é amostrada a cada minuto, PT30M a cada 30 minutos, PT1H a cada hora e assim por diante.
  • Exportação de DS: se a métrica é exportável para os Logs do Azure Monitor via configurações de diagnóstico. Para obter mais informações sobre exportação de métricas, consulte as Criar configurações de diagnóstico no Azure Monitor.
Métrica Nome na API REST Unidade Agregação Dimensões Granularidade de tempo Exportação de DS
Tentativas de atestado

Número de tentativas de atestado do dispositivo
AttestationAttempts Count Total (Soma) ProvisioningServiceName, Status, Protocol PT1M Sim
Dispositivos atribuídos

Número de dispositivos atribuídos a um hub IoT
DeviceAssignments Count Total (Soma) ProvisioningServiceName, IotHubName PT1M Sim
Tentativas de registro

Número de tentativas de registros do dispositivo
RegistrationAttempts Count Total (Soma) ProvisioningServiceName, IotHubName, Status PT1M Yes

Dimensões de métrica

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

Este serviço tem as dimensões a seguir 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 este serviço. A seção extrai da lista de todos os tipos de categoria de logs de recursos com suporte no Azure Monitor.

Logs de recursos com suporte para Microsoft.Devices/provisioningServices

Categoria Nome de exibição da categoria Tabela de log Com suporte a plano de log básico Com suporte a transformações de tempo-ingestão Consultas de exemplo Custos de exportação
DeviceOperations Operações do Dispositivo AzureDiagnostics

Logs de vários recursos do Azure.

Não Não Consultas Não
ServiceOperations Operações de serviço AzureDiagnostics

Logs de vários recursos do Azure.

Não Não Consultas Não

A lista a seguir fornece informações adicionais sobre os logs anteriores:

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
ApplicationId 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": "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

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

Tabelas de Logs do Azure Monitor

Esta seção lista todas as tabelas dos Logs do Azure Monitor relevantes para este serviço e disponíveis para consulta pela análise de logs usando o Kusto. As tabelas contêm dados de log de recursos e possivelmente mais, dependendo do que é coletado e roteado para elas.

Serviço de provisionamento de dispositivos no Hub IoT Microsoft.Devices/ProvisioningServices

Log de atividades

A tabela vinculada lista as operações que podem ser registradas no log de atividades desse serviço. Essas operações são um subconjunto de todas as operações do provedor de recursos possíveis no log de atividades.

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