Konfigurace nastavení diagnostiky zprostředkovatele MQTT

Článek
11/20/2024

Důležité

Toto nastavení vyžaduje úpravu prostředku zprostředkovatele a dá se nakonfigurovat pouze v počáteční době 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.

Nastavení diagnostiky umožňuje konfigurovat 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 OpenTelemetry (OTLP). Dají se převést na formát Prometheus pomocí kolekce OpenTelemetry a směrovat je do řídicích panelů Spravované grafany Azure pomocí spravované služby Azure Monitor 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 možné je 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ří:

Zprávy cest procházejí systémem.
Chování časování systému.

Diagnostická sonda pravidelně provádí operace MQTT (PING, CONNECT, PUBLISH, SUBSCRIBE, UNSUBSCRIBE) na zprostředkovateli MQTT a monitoruje odpovídající sady ACL a trasování, aby zkontrolovala 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, což vede 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. Například u události sondy s typem operace Publish v protokolech diagnostiky se může zobrazit neúspěšné ověření cesty k problému. 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. Změna nastavení se v současné době podporuje pouze pomocí příznaku --broker-config-file při nasazování operací Azure IoT pomocí az iot ops create příkazu.

Pokud chcete přepsat, nejprve připravte konfigurační soubor zprostředkovatele podle referenčních informací k rozhraní API BrokerDiagnostics . 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
    }
  }
}

Pak nasaďte operace Azure IoT pomocí az iot ops create příkazu s příznakem --broker-config-file , jako je následující příkaz (pro stručnost chybí 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.

Další kroky

Nasazení prostředků pozorovatelnosti a nastavení protokolů

Sdílet prostřednictvím