Delen via

Diagnostische instellingen voor MQTT-broker configureren

  • Artikel

Belangrijk

Voor deze instelling moet u de Broker-resource wijzigen. Deze wordt alleen geconfigureerd bij 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 behulp van 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 OTLP-indeling (OpenTelemetry Protocol). U kunt ze converteren naar de Prometheus-indeling met behulp van een OpenTelemetry Collector en deze routeren naar Azure Managed Grafana-dashboards met behulp van de beheerde Azure Monitor-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 worden uitgevoerd door de MQTT-broker. Deze logboeken zijn beschikbaar in het Kubernetes-cluster als containerlogboeken. U kunt deze configureren 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 en resulteren in ongeldige resultaten. Ongeldige resultaten kunnen worden vermeld in diagnostische testlogboeken, metrische gegevens of dashboards. U ziet bijvoorbeeld het probleem 'Padverificatie is mislukt voor testgebeurtenis met bewerkingstype Publiceren' in de diagnostische testlogboeken. Zie Bekende problemen voor meer informatie.

Diagnostische instellingen wijzigen

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

Als u dit wilt overschrijven, bereidt u eerst een Broker-configuratiebestand voor door de BrokerDiagnostics-API-verwijzing te volgen. 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 IoT-bewerkingen met behulp van de az iot ops create opdracht met de --broker-config-file vlag, zoals de volgende opdracht. (Andere parameters worden 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.

Gerelateerde inhoud