Sdílet prostřednictvím

Konfigurace nastavení diagnostiky zprostředkovatele MQTT

  • Článek

Důležité

Toto nastavení vyžaduje úpravu prostředku zprostředkovatele. Konfiguruje se pouze při počátečním nasazení pomocí Azure CLI nebo webu Azure Portal. Pokud jsou potřeba změny konfigurace zprostředkovatele, vyžaduje se nové nasazení. Další informace najdete v tématu Přizpůsobení výchozího zprostředkovatele.

Pomocí nastavení diagnostiky můžete nakonfigurovat metriky, protokoly a samoobslužnou kontrolu zprostředkovatele MQTT.

Metriky

Metriky poskytují informace o aktuálním a minulém stavu a stavu zprostředkovatele MQTT. Tyto metriky se generují ve formátu OTLP (OpenTelemetry Protocol). Můžete je převést do formátu Prometheus pomocí kolekce OpenTelemetry a směrovat je na řídicí panely Grafana spravované službou Azure Monitoru pro Prometheus. Další informace najdete v tématu Konfigurace pozorovatelnosti a monitorování.

Úplný seznam dostupných metrik najdete v tématu Metriky zprostředkovatele MQTT.

Protokoly

Protokoly poskytují informace o operacích prováděných zprostředkovatelem MQTT. Tyto protokoly jsou k dispozici v clusteru Kubernetes jako protokoly kontejneru. Pomocí Container Insights je můžete nakonfigurovat tak, aby se odesílaly do protokolů služby Azure Monitor.

Další informace najdete v tématu Konfigurace pozorovatelnosti a monitorování.

Samoobslužná kontrola

Mechanismus samoobslužné kontroly zprostředkovatele MQTT je ve výchozím nastavení povolený. K monitorování zprostředkovatele používá diagnostické sondy a trasování OpenTelemetry (OTel). Sonda odesílá testovací zprávy, aby zkontrolovala chování a načasování systému.

Proces ověření zkontroluje, jestli systém funguje správně, a to porovnáním výsledků testů s očekávanými výsledky. Mezi tyto výsledky patří:

  • Cesty, které zprávy procházejí systémem.
  • Chování časování systému.

Test diagnostiky pravidelně spouští operace MQTT (PING, CONNECT, PUBLISH, SUBSCRIBE, UNSUBSCRIBE) na zprostředkovateli MQTT a monitoruje odpovídající sady ACL a trasování a kontroluje latenci, ztrátu zpráv a správnost protokolu replikace.

Důležité

Sonda diagnostiky samoobslužné kontroly publikuje zprávy do azedge/dmqtt/selftest tématu. Nepublikujte ani se přihlaste k odběru témat diagnostických testů, která začínají azedge/dmqtt/selftest. Publikování nebo přihlášení k odběru těchto témat může mít vliv na testy nebo kontroly samoobslužného testu a vést k neplatným výsledkům. Neplatné výsledky můžou být uvedené v protokolech diagnostických testů, metrikách nebo řídicích panelech. V protokolech diagnostiky se například může zobrazit problém "Ověření cesty selhalo pro událost sondy s typem operace Publish". Další informace najdete v tématu Známé problémy.

Změna nastavení diagnostiky

Ve většiněscénářůch Pokud chcete přepsat výchozí nastavení diagnostiky pro zprostředkovatele MQTT, upravte diagnostics část prostředku zprostředkovatele. V současné době se změna nastavení podporuje jenom pomocí příznaku --broker-config-file při nasazování operací Azure IoT pomocí az iot ops create příkazu.

Chcete-li přepsat, nejprve připravte konfigurační soubor zprostředkovatele pomocí odkazu rozhraní BrokerDiagnostics API. Příklad:

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

Potom pomocí příkazu s --broker-config-file příznakem az iot ops create nasaďte operace IoT, jako je následující příkaz. (Pro stručnost nejsou vynechány další parametry.)

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

Další informace najdete v tématu Podpora Azure CLI pro pokročilou konfiguraci zprostředkovatele MQTT a příklady zprostředkovatele.

Související obsah