Acessar métricas internas no Azure IoT Edge

Aplica-se a: IoT Edge 1.5

Os componentes de tempo de execução do IoT Edge, o hub do IoT Edge e o agente do IoT Edge produzem métricas internas no formato de exposição Prometheus. Aceda a estas métricas remotamente para monitorizar e compreender o estado de funcionamento de um dispositivo IoT Edge.

Use sua própria solução para acessar essas métricas ou use o módulo coletor de métricas, que coleta as métricas internas e as envia para o Azure Monitor ou o Hub IoT do Azure. Para obter mais informações, consulte Coletar e transportar métricas.

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

Acesse as métricas do host ao expor e mapear a porta de métricas no módulo createOptions. O exemplo a seguir 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 de host distintos e únicos ao mapear as endpoints de métricas do edgeHub e do edgeAgent.

Métricas disponíveis

As métricas incluem tags que identificam a natureza da métrica que está sendo coletada. Todas as métricas incluem as seguintes tags:

O formato de exposição Prometheus inclui quatro tipos de métricas principais: contador, medidor, histograma e resumo. Para obter mais informações sobre os diferentes tipos de métricas, consulte a documentação de tipos de métricas Prometheus.

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

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

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

Próximos passos

• Coletar e transportar métricas
• Compreender o runtime do IoT Edge e a arquitetura
• Propriedades dos gêmeos do agente do IoT Edge e do módulo do hub do IoT Edge