Referência de dados de monitoramento do Serviço de Provisionamento de Dispositivo do 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 Dispositivo do Hub IoT do Azure para obter detalhes sobre os dados que você pode coletar para o Serviço de Provisionamento de Dispositivo do Hub IoT e como usá-lo.
Métricas
Esta seção lista todas as métricas de plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas de plataforma com suporte no Azure Monitor.
Para obter informações sobre retenção de métricas, consulte Visão geral do Azure Monitor Metrics.
Métricas suportadas 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 visualizar todas as colunas disponíveis.
Cabeçalhos de tabela
- Categoria - O grupo ou classificação de métricas.
- Métrica - O nome para exibição da métrica conforme aparece no portal do Azure.
- Nome na API REST - O nome da métrica conforme referido na API REST.
- Unidade - Unidade de medida.
- Agregação - O tipo de agregação padrão. Valores válidos: Média (Média), Mínima (Mín), Máxima (Máx), Total (Soma), Contagem.
- Dimensões - Dimensões disponíveis para a métrica.
- Intervalos de grãos de - tempo 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. - DS Export- Se a métrica é exportável para os Logs do Azure Monitor por meio de configurações de diagnóstico. Para obter informações sobre como exportar métricas, consulte Criar configurações de diagnóstico no Azure Monitor.
| Métrica | Nome na API REST | Unit | Agregação | Dimensões | Grãos de tempo | DS Exportação |
|---|---|---|---|---|---|---|
| Tentativas de atestado Número de atestados de dispositivo tentados |
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 registo Número de tentativas de registo de dispositivos |
RegistrationAttempts |
Count | Total (soma) | ProvisioningServiceName, IotHubName, Status |
PT1M | Sim |
Dimensões métricas
Para obter informações sobre o que são dimensões métricas, consulte Métricas multidimensionais.
Este serviço 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. |
| Status | 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 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 suportados para Microsoft.Devices/provisioningServices
| Categoria | Nome de exibição da categoria | Tabela de registo | Suporta plano de log básico | Suporta a transformação do tempo de ingestão | Consultas de exemplo | Custos de exportação |
|---|---|---|---|---|---|---|
DeviceOperations |
Operações do dispositivo | AzureDiagnostics Logs de vários recursos do Azure. |
No | Não | Consultas | Não |
ServiceOperations |
Operações de Serviço | AzureDiagnostics Logs de vários recursos do Azure. |
No | 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 APIs de dispositivo listadas em Operações e preços de serviço faturáveis.
- ServiceOperations: 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.
| Property | 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. |
| Level | 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.DEVICES. |
| 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. |
| TenantId | 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": "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\"}",
}
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": "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 as tabelas de Logs do Azure Monitor relevantes para este serviço, que estão disponíveis para consulta pelo Log Analytics usando consultas 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 dispositivo do Hub IoT Microsoft.Devices/ProvisioningServices
Registo 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 possíveis do provedor de recursos no log de atividades.
Para obter mais informações sobre o esquema de entradas do log de atividades, consulte Esquema do log de atividades.
Conteúdos relacionados
- Consulte Monitorar o Serviço de Provisionamento de Dispositivo do Hub IoT do Azure para obter uma descrição do monitoramento do Serviço de Provisionamento de Dispositivo do Hub IoT.
- Consulte Monitorar recursos do Azure com o Azure Monitor para obter detalhes sobre o monitoramento de recursos do Azure.