Acessar métricas internas no Azure IoT Edge

Aplica-se a: IoT Edge 1.5 IoT Edge 1.4

Os componentes de runtime do IoT Edge, o hub do IoT Edge e o agente do IoT Edge produzem métricas internas no formato de exposição do Prometheus. Acesse essas métricas remotamente para monitorar e entender a integridade de um dispositivo do IoT Edge.

Você pode usar sua própria solução para acessar essas métricas. Ou você pode usar o módulo do coletor de métricas, que lida com a coleta de métricas internas e o envio delas ao Azure Monitor ou ao Hub IoT do Azure. Para obter mais informações, confira Coletar e transportar métricas.

As métricas são automaticamente expostas por padrão na porta 9600 dos módulos edgeHub e edgeAgent (http://edgeHub:9600/metrics e http://edgeAgent:9600/metrics). Elas não são portas mapeadas para o host por padrão.

Acesse as métricas do host expondo e mapeando a porta das métricas do createOptions do módulo. O seguinte exemplo mapeia a porta de métricas padrão para a porta 9601 no host:

{
  "ExposedPorts": {
    "9600/tcp": {}
  },
  "HostConfig": {
    "PortBindings": {
      "9600/tcp": [
        {
          "HostPort": "9601"
        }
      ]
    }
  }
}

Escolha números de porta do host diferentes e exclusivos se você estiver mapeando ambos os pontos de extremidade de métricas do edgeHub e do edgeAgent.

Métricas disponíveis

As métricas contêm marcas para ajudar a identificar a natureza da métrica que está sendo coletada. Todas as métricas contêm as seguintes marcas:

No formato de exposição do Prometheus, há quatro tipos principais de métrica: contador, medidor, histograma e resumo. Para obter mais informações sobre os diferentes tipos de métrica, confira a documentação dos tipos de métrica do Prometheus.

Os quantis fornecidos para as métricas internas de histograma e de resumo são 0,1, 0,5, 0,9 e 0,99.

O módulo edgeHub produz as seguintes métricas:

O módulo edgeAgent produz as seguintes métricas:

Próximas etapas

• Coletar e transportar métricas
• Entenda o runtime do Azure IoT Edge e sua arquitetura
• Propriedades do agente do IoT Edge e dos gêmeos de módulo do hub do IoT Edge