Planification du déploiement - Diagnostics

Le système de diagnostic du broker MQTT est un ensemble d’outils intégrés qui surveillent l’état de santé du broker à l’aide de métriques, de journaux et de sondes d’autocontrôle. Décidez avant le déploiement de la configuration des diagnostics dont vous avez besoin pour le répartiteur MQTT.

Important

Les diagnostics sont définis sur la ressource Broker. Configurez les diagnostics pendant le déploiement initial à l’aide d’Azure CLI ou du portail Azure. Si vous souhaitez modifier les paramètres du répartiteur, déployez une nouvelle ressource broker. Pour en savoir plus, consultez Personnaliser l’Agent par défaut.

Auto-vérification

Le mécanisme d’auto-vérification du répartiteur MQTT est activé par défaut. Il utilise une sonde de diagnostic et des traces OpenTelemetry (OTel) pour monitorer l’Agent. La sonde envoie des messages de test pour vérifier le comportement et le minutage du système.

Le processus de validation vérifie si le système fonctionne correctement en comparant les résultats des tests avec les résultats attendus. Ces résultats sont les suivants :

  • La manière dont les messages circulent à travers le système.
  • Comportement temporel du système.

La sonde de diagnostic exécute régulièrement des opérations MQTT (PING, CONNECT, PUBLISH, SUBSCRIBE, UNSUBSCRIBE) sur le courtier MQTT et surveille les ACKs et traces correspondants pour vérifier la latence, la perte de messages et la correction du protocole de réplication.

Important

La sonde de diagnostic d’auto-vérification publie des messages dans la rubrique azedge/dmqtt/selftest. Ne publiez pas de rubriques de sonde de diagnostic qui commencent par azedge/dmqtt/selftest et ne vous abonnez pas à ce type de rubriques. La publication ou l’abonnement à ces rubriques peut affecter la sonde ou les vérifications d’auto-test et entraîner des résultats non valides. Les résultats non valides peuvent être répertoriés dans les journaux de sonde de diagnostic, les métriques ou les tableaux de bord. Par exemple, le problème « La vérification du chemin d’accès a échoué pour l’événement de la sonde avec le type d’opération « Publier » » peut apparaître dans les journaux diagnostics-probe. Pour plus d’informations, voir Problèmes connus.

Même si les diagnostics de l’Agent MQTT produisent des messages de diagnostics sur sa propre rubrique, vous pouvez toujours recevoir des messages de l’auto-test lorsque vous vous abonnez à la rubrique #. Il s’agit d’une limitation et d’un comportement attendu.

Configurer les paramètres de diagnostic

Dans la plupart des scénarios, les paramètres de diagnostic par défaut sont suffisants. Pour remplacer les paramètres de diagnostic par défaut pour le répartiteur MQTT, modifiez la diagnostics section dans la ressource Broker. Actuellement, vous pouvez modifier les paramètres uniquement à l’aide de l’indicateur --broker-config-file lorsque vous déployez Des opérations Azure IoT avec la az iot ops create commande. Pour plus d’informations, consultez la prise en charge de la configuration avancée du répartiteur MQTT par Azure CLI.

Pour contourner cette règle, préparez d’abord un fichier de configuration d’agent en suivant la référence d’API BrokerDiagnostics. Par exemple:

{
  "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
    }
  }
}

Ensuite, déployez des opérations IoT avec la az iot ops create commande et l’indicateur --broker-config-file , comme illustré dans l’exemple suivant. (D’autres paramètres sont omis pour la concision.)

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

Étapes suivantes

  • Last updated on