Planeamiento de la implementación: diagnósticos

El sistema de diagnóstico del broker MQTT es un conjunto de herramientas integradas que supervisan el estado del broker mediante métricas, registros y sondas de autocomprobación. Decida antes de implementar qué configuración de diagnóstico necesita para el agente MQTT.

Importante

Los diagnósticos se establecen en el recurso del agente. Configure los diagnósticos durante la implementación inicial mediante la CLI de Azure o Azure Portal. Si desea cambiar la configuración del agente, implemente un nuevo recurso de agente. Para obtener más información, consulte Personalizar el agente predeterminado.

Autoprotección

El mecanismo de autocomprobación del intermediario MQTT está activado de forma predeterminada. Usa un sondeo de diagnóstico y seguimientos de OpenTelemetry (OTel) para supervisar el agente. El sondeo envía mensajes de prueba para comprobar el comportamiento y el tiempo del sistema.

El proceso de validación comprueba si el sistema funciona correctamente comparando los resultados de las pruebas con los resultados esperados. Estos resultados incluyen:

  • Los mensajes de rutas de acceso realizados a través del sistema.
  • Comportamiento temporal del sistema.

La sonda de diagnóstico ejecuta regularmente operaciones MQTT (PING, CONECTAR, PUBLICAR, SUSCRIBIR, CANCELAR SUSCRIPCIÓN) en el agente MQTT y monitorea los ACK y seguimientos correspondientes para verificar la latencia, la pérdida de mensajes y la corrección del protocolo de replicación.

Importante

El sondeo de diagnóstico de comprobación automática publica mensajes en el tema azedge/dmqtt/selftest. No publique ni se suscriba a temas de sondeo de diagnóstico que empiecen por azedge/dmqtt/selftest. La publicación o suscripción a estos temas puede afectar a las comprobaciones de prueba de sonda o autoevaluación y producir resultados no válidos. Los resultados no válidos se pueden enumerar en los registros de pruebas diagnósticas, las métricas o los paneles. Por ejemplo, es posible que vea la incidencia "Error de comprobación de la ruta de acceso para el evento de sondeo con el tipo de operación 'Publicar'" en los registros de sondeo de diagnóstico. Para más información, consulte Problemas conocidos.

Aunque el agente MQTT diagnósticos genere mensajes de diagnóstico en su propio tema, todavía puede obtener mensajes de la prueba automática al suscribirse al tema de #. Se trata de una limitación y un comportamiento esperado.

Configuración de valores de diagnóstico

En la mayoría de los escenarios, la configuración de diagnóstico predeterminada es suficiente. Para invalidar la configuración de diagnóstico predeterminada para el agente MQTT, edite la diagnostics sección del recurso Broker. Actualmente, solo puede cambiar los ajustes mediante la bandera --broker-config-file al implementar las operaciones de Azure IoT con el comando az iot ops create. Para obtener más información, consulte la sección sobre la compatibilidad del CLI de Azure con la configuración avanzada del agente MQTT.

Para invalidar, prepare un archivo de configuración del agente siguiendo la referencia de la API BrokerDiagnostics. Por ejemplo:

{
  "diagnostics": {
    "metrics": {
      "prometheusPort": 9600
    },
      "logs": {
        "level": "info"
      },
    "traces": {
      "mode": "Enabled",
      "cacheSizeMegabytes": 16,
      "selfTracing": {
        "mode": "Enabled",
        "intervalSeconds": 30
      },
      "spanChannelCapacity": 1000
    },
    "selfCheck": {
      "mode": "Enabled",
      "intervalSeconds": 30,
      "timeoutSeconds": 60
    }
  }
}

A continuación, despliegue las Operaciones de IoT con el az iot ops create comando y el --broker-config-file indicador como se muestra en el ejemplo siguiente. (en aras de la concisión se omiten otros parámetros).

az iot ops create ... --broker-config-file <FILE>.json

Pasos siguientes

  • Last updated on