Zustellprotokolle & Fehler

Jede Zustellung, ob erfolgreich oder fehlerhaft, wird protokolliert. So können Sie Probleme schnell diagnostizieren und Zustellungen bei Bedarf erneut anstoßen.

Zustellprotokoll: chronologische Liste aller Zustellversuche mit Status, Zeitstempel und Fehlermeldung.
Zustellprotokoll: chronologische Liste aller Zustellversuche mit Status, Zeitstempel und Fehlermeldung.

Protokolle aufrufen

Navigieren Sie zu Daten → Integrationen, öffnen Sie die gewünschte Verbindung und klicken Sie in der Liste Zugeordnete Zähler beim betreffenden Zähler auf Zustellprotokolle. Sie sehen eine chronologische Liste aller Zustellversuche für diesen Zähler mit Status, Zeitstempel und Details.

Statusbedeutungen

Status Bedeutung
Erfolg Zustellung wurde vom Ziel mit 2xx bestätigt
Fehlgeschlagen Zustellung ist endgültig fehlgeschlagen (nach allen Wiederholungen)
Erneuter Versuch Zustellung ist fehlgeschlagen, weitere Versuche stehen aus
Ausstehend Zustellung ist in der Warteschlange, noch nicht verarbeitet

Fehlerdiagnose

Bei fehlgeschlagenen Zustellungen zeigt das Protokoll den HTTP-Statuscode (bei Webhooks) oder die Fehlermeldung (bei MQTT) an. Häufige Ursachen:

  • 4xx (z. B. 401, 403): Authentifizierung fehlgeschlagen. Prüfen Sie Ihr Token oder Signing Secret.
  • 5xx: Serverfehler auf Empfängerseite. Warten Sie auf Verfügbarkeit oder kontaktieren Sie den Systembetreiber.
  • Timeout: Ziel antwortet zu langsam. Prüfen Sie Erreichbarkeit und Performance des Endpunkts.
  • MQTT-Verbindungsfehler: Broker nicht erreichbar oder Zugangsdaten falsch.

Automatische Deaktivierung

Nach 5 aufeinanderfolgenden Fehlern wird die Verbindung automatisch deaktiviert. Sie erhalten eine Benachrichtigung. Neue Messwerte werden für diese Verbindung nicht mehr zugestellt, bis Sie sie reaktivieren.

So reaktivieren Sie eine deaktivierte Verbindung:

  1. Navigieren Sie zu Daten → Integrationen.
  2. Öffnen Sie die deaktivierte Verbindung.
  3. Beheben Sie den Fehler (z. B. URL oder Zugangsdaten aktualisieren).
  4. Schalten Sie Aktiviert wieder ein und speichern Sie die Verbindung.

Zustellungen erneut senden

Öffnen Sie die Verbindung und klicken Sie in der Liste Zugeordnete Zähler beim betroffenen Zähler auf Erneut senden. Wählen Sie ein Start- und ein Enddatum: Alle Messwerte dieses Zeitraums werden für diesen Zähler erneut zugestellt. Das ist nützlich, wenn der Empfänger kurzzeitig nicht erreichbar war.

Test- vs. Live-Zustellungen

Zustellungen, die über den Test senden-Button ausgelöst wurden, sind im Protokoll als Testzustellungen markiert. Für den Fehlerzähler der automatischen Deaktivierung zählen sie wie Live-Zustellungen: Auch eine fehlgeschlagene Testzustellung bringt die Verbindung näher an die Abschaltung.