Diagnostische instellingen voor MQTT-broker configureren

Artikel
11/20/2024

Belangrijk

Deze instelling vereist het wijzigen van de Broker-resource en kan alleen worden geconfigureerd tijdens de eerste implementatie met behulp van de Azure CLI of Azure Portal. Er is een nieuwe implementatie vereist als brokerconfiguratiewijzigingen nodig zijn. Zie Standaardbroker aanpassen voor meer informatie.

Met diagnostische instellingen kunt u metrische gegevens, logboeken en zelfcontrole voor de MQTT-broker configureren.

Metrische gegevens

Metrische gegevens bieden informatie over de huidige en eerdere status en status van de MQTT-broker. Deze metrische gegevens worden verzonden in de OpenTelemetry-indeling (OTLP). Ze kunnen worden geconverteerd naar de Prometheus-indeling met behulp van een OpenTelemetry Collector en worden gerouteerd naar Azure Managed Grafana-dashboards met behulp van Azure Monitor Managed Service voor Prometheus. Zie Waarneembaarheid en bewaking configureren voor meer informatie.

Zie de metrische gegevens van MQTT Broker voor de volledige lijst met beschikbare metrische gegevens.

Logboeken

Logboeken bevatten informatie over de bewerkingen die door MQTT-broker worden uitgevoerd. Deze logboeken zijn beschikbaar in het Kubernetes-cluster als containerlogboeken. Ze kunnen worden geconfigureerd voor verzending naar Azure Monitor-logboeken met Container Insights.

Zie Waarneembaarheid en bewaking configureren voor meer informatie.

Zelfcontrole

Het zelfcontrolemechanisme van de MQTT-broker is standaard ingeschakeld. Er wordt gebruikgemaakt van een diagnostische test en OTelemetry-traceringen (OTel) om de broker te bewaken. De test verzendt testberichten om het gedrag en de timing van het systeem te controleren.

Het validatieproces controleert of het systeem correct werkt door de testresultaten te vergelijken met de verwachte resultaten. Deze resultaten zijn onder andere:

De paden die berichten door het systeem nemen.
Het timinggedrag van het systeem.

De diagnostische test voert periodiek MQTT-bewerkingen (PING, CONNECT, PUBLISH, SUBSCRIBE, UNSUBSCRIBE) uit op de MQTT-broker en bewaakt de bijbehorende ACL's en traceringen om te controleren op latentie, berichtverlies en juistheid van het replicatieprotocol.

Belangrijk

Met de test voor zelfcontrole worden berichten naar het azedge/dmqtt/selftest onderwerp gepubliceerd. Publiceer of abonneer u niet op diagnostische testonderwerpen die beginnen met azedge/dmqtt/selftest. Het publiceren of abonneren op deze onderwerpen kan van invloed zijn op de test- of zelftestcontroles die resulteren in ongeldige resultaten. Ongeldige resultaten kunnen worden vermeld in diagnostische testlogboeken, metrische gegevens of dashboards. U ziet bijvoorbeeld dat het probleem padverificatie is mislukt voor de testgebeurtenis met het bewerkingstype Publiceren in de logboeken voor diagnostische tests. Zie Bekende problemen voor meer informatie.

Diagnostische instellingen wijzigen

In de meeste scenario's zijn de standaardinstellingen voor diagnostische gegevens voldoende. Als u standaardinstellingen voor diagnostische gegevens voor MQTT Broker wilt overschrijven, bewerkt u de diagnostics sectie in de Broker-resource. Op dit moment wordt het wijzigen van instellingen alleen ondersteund met behulp van de --broker-config-file vlag wanneer u de Azure IoT-bewerkingen implementeert met behulp van de az iot ops create opdracht.

Als u dit wilt overschrijven, moet u eerst een Broker-configuratiebestand voorbereiden volgens de BrokerDiagnostics-API-verwijzing . Voorbeeld:

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

Implementeer vervolgens Azure IoT-bewerkingen met behulp van de az iot ops create opdracht met de --broker-config-file vlag, zoals de volgende opdracht (andere parameters die zijn weggelaten voor beknoptheid):

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

Zie De Ondersteuning van Azure CLI voor geavanceerde MQTT Broker-configuratie en Broker-voorbeelden voor meer informatie.

Volgende stappen

Waarneembaarheidsbronnen implementeren en logboeken instellen

Delen via