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,
PT1Mindica que a métrica é amostrada a cada minuto,PT30Ma cada 30 minutos,PT1Ha 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:
- DeviceOperations: logs relacionados a 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 |
|---|---|---|
| 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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
"ResourceProvider": "MICROSOFT.DEVICES",
"ResourceType": "PROVISIONINGSERVICES",
"ResultDescription": "",
"ResultSignature": "",
"ResultType": "Success",
"SourceSystem": "Azure",
"SubscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"TenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"TimeGenerated": "2022-04-01T00:52:00Z",
"Type": "AzureDiagnostics",
"_ResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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.
Conteúdo relacionado
- Consulte Monitorar o Serviço de Provisionamento de Dispositivos no Hub IoT do Azure para obter uma descrição do monitoramento do Serviço de Provisionamento de Dispositivos no Hub IoT.
- Confira Monitorar recursos do Azure com o Azure Monitor para ver informações detalhadas sobre o monitoramento dos recursos do Azure.