Dela via

Konfigurera diagnostikinställningar för MQTT-koordinator

Konfigurera diagnostikinställningar för att konfigurera mått, loggar och självkontroll för MQTT-koordinatorn.

Viktigt!

Diagnostiken ställs in på mäklarresursen. Konfigurera diagnostik under den första distributionen med hjälp av Azure CLI eller Azure-portalen. Om du vill ändra inställningarna för mäklare distribuerar du en ny mäklarresurs. Mer information finns i Anpassa standard broker.

Mått

Mått visar aktuell och tidigare hälsa och status för MQTT-koordinatorn. Dessa mått använder FORMATET OpenTelemetry Protocol (OTLP). Konvertera dem till Prometheus-format med en OpenTelemetry Collector och dirigera dem till Azure Managed Grafana-instrumentpaneler med hjälp av Azure Monitor-hanterad tjänst för Prometheus. Mer information finns i Konfigurera observerbarhet och övervakning.

En fullständig lista över tillgängliga mått finns i MQTT-koordinatormått.

Loggar

Loggar visar information om åtgärder som MQTT-koordinatorn utför. Dessa loggar finns i Kubernetes-klustret som containerloggar. Ställ in dem för att skicka till Azure Monitor Logs med Container Insights.

Mer information finns i Konfigurera observerbarhet och övervakning.

Självkontroll

MQTT-mäklarens självkontrollmekanism är aktiverad som standard. Den använder en diagnostiksond och OpenTelemetry-spårningar (OTel) för att övervaka mäklaren. Avsökningen skickar testmeddelanden för att kontrollera systemets beteende och tidsinställning.

Valideringsprocessen kontrollerar om systemet fungerar korrekt genom att jämföra testresultat med förväntade resultat. Dessa resultat omfattar:

  • Vägarna som meddelandena tar genom systemet.
  • Systemtidsbeteende.

** Diagnostikavsökningen kör regelbundet MQTT-åtgärder (PING, CONNECT, PUBLISH, SUBSCRIBE, UNSUBSCRIBE) på MQTT-brokern och övervakar motsvarande ACK:ar och spår för att kontrollera latens, meddelandeförlust och korrekthet i replikeringsprotokollet.

Viktigt!

Diagnostikproben med självtest publicerar meddelanden till ämnet azedge/dmqtt/selftest. Publicera eller prenumerera inte på diagnostikämnen som börjar med azedge/dmqtt/selftest. Publicering eller prenumeration på dessa ämnen kan påverka avsöknings- eller självtestkontrollerna och resultera i ogiltiga resultat. Ogiltiga resultat kan visas i diagnostikavsökningsloggar, mått eller instrumentpaneler. Du kan till exempel se problemet "Sökvägsverifieringen misslyckades för avsökningshändelsen med åtgärdstypen 'Publicera'" i diagnostiksonderingsloggarna. Du hittar mer information i Kända problem.

Även om MQTT-mäklarens diagnostik skapar diagnostikmeddelanden på sitt eget ämnesområde kan du fortfarande få meddelanden från självtestet när du prenumererar på ämnet #. Detta är en begränsning och förväntat beteende.

Ändra diagnostikinställningar

I de flesta scenarier räcker standarddiagnostikinställningarna. För att åsidosätta standarddiagnostikinställningarna för MQTT-mäklaren, redigera diagnostics-delen i Broker-resursen. För närvarande kan du bara ändra inställningarna med hjälp --broker-config-file av flaggan när du distribuerar Azure IoT Operations med az iot ops create kommandot .

För att åsidosätta, förbered en broker-konfigurationsfil genom att följa API-referensen BrokerDiagnostics. Till exempel:

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

Distribuera sedan IoT-åtgärder med az iot ops create kommandot och --broker-config-file flaggan, som du ser i följande exempel. (Andra parametrar utelämnas för korthet.)

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

Läs mer i Azure CLI-stöd för avancerad MQTT-koordinatorkonfiguration och Broker-exempel.

Relaterat innehåll