Fehler bei Dashboardkacheln in Azure Data Explorer beheben

Wenn Sie mit Dashboards in Azure Data Explorer arbeiten, zeigt eine Kachel möglicherweise einen Fehler anstelle eines visuellen Elements an. Diese Fehler werden kategorisiert, damit Sie den Typ des Problems verstehen und die nächsten Schritte ermitteln können. Jeder Fehlertyp gibt eine andere Phase im Abfrage-, Datenempfangs- oder Renderingprozess an, bei dem der Fehler aufgetreten ist.

Screenshot verschiedener Beispiele für Kachelfehlertypen.

Grundlegendes zu Kachelfehlertypen

Im folgenden Abschnitt werden allgemeine Kachelfehlerkategorien, ihre Bedeutung und allgemeine Methoden zur Behebung beschrieben.

Zugriff verweigert

Die Kachel kann nicht auf Daten aus der zugrunde liegenden Datenquelle zugreifen oder diese abrufen. Dieser Fehler tritt auf, wenn der Benutzer nicht berechtigt ist, auf die Datenquelle zuzugreifen.

Vorgehensweise:

  • Überprüfen Sie, ob die Datenquelle vorhanden ist und erreichbar ist.
  • Überprüfen Sie, ob Sie über die Berechtigung für den Zugriff auf die Datenquelle verfügen.
  • Versuchen Sie, zu aktualisieren, nachdem Sie die Verfügbarkeit bestätigt haben.

Syntaxfehler

Die in der Kachel verwendete Abfrage enthält ungültige Syntax und kann nicht analysiert werden. Dieser Fehler tritt nach dem Bearbeiten einer Abfrage oder beim Erstellen einer neuen Kachel auf.

Vorgehensweise:

  • Überprüfen Sie die Abfrage auf Syntaxprobleme, z. B. fehlende Operatoren oder ungültige Ausdrücke.
  • Überprüfen Sie die Abfrage im Abfrage-Editor.
  • Machen Sie die letzten Änderungen rückgängig, wenn der Fehler nach der Änderung aufgetreten ist.

Semantikfehler

Die Abfrage ist syntaktisch gültig, verwendet jedoch ungültige Verweise oder Logik. Dieser Fehler tritt auf, wenn die Abfrage auf nicht vorhandene Tabellen, Spalten oder inkompatible Datentypen verweist.

Vorgehensweise:

  • Stellen Sie sicher, dass referenzierte Tabellen und Spalten vorhanden sind.
  • Suchen Sie nach umbenannten oder gelöschten Objekten.
  • Überprüfen sie Abfragelogik und Datentypen.
  • Aktualisieren Sie die Abfrage so, dass sie mit dem aktuellen Schema übereinstimmt.

Netzwerkfehler

Fehler bei der Verbindung zwischen dem Dashboard und den Back-End-Diensten. Dieser Fehler tritt aufgrund temporärer Konnektivitätsprobleme oder Dienstunterbrechungen auf.

Vorgehensweise:

  • Überprüfen Sie Ihre Netzwerkverbindung.
  • Aktualisieren Sie das Dashboard.
  • Versuchen Sie es nach kurzer Zeit erneut, wenn das Problem vorübergehend ist.
  • Wenn das Problem weiterhin besteht, überprüfen Sie den Dienststatus, oder wenden Sie sich an den Support.

Problem mit visueller Formatierung

Die Kachel kann das visuelle Element aufgrund von Konfigurations- oder Formatierungsproblemen nicht rendern. Dieses Problem tritt auf, wenn die Abfrage erfolgreich ausgeführt wird, aber das visuelle Element nicht ordnungsgemäß angezeigt wird.

Vorgehensweise:

  • Überprüfen Sie visuelle Einstellungen, z. B. Feldzuweisungen und Formatierungsregeln.
  • Stellen Sie sicher, dass erforderliche Felder eingeschlossen sind.
  • Vereinfachen oder Zurücksetzen der visuellen Konfiguration.
  • Erstellen Sie das visuelle Element bei Bedarf neu.

Ein Fehler ist aufgetreten.

Ein allgemeiner Fehler ist aufgetreten, der nicht in die vorherigen Kategorien passt. Dieser Catch-All-Fehler kann aus verschiedenen Gründen auftreten, z. B. unerwartete Ausnahmen oder unbehandelte Fälle.

Vorgehensweise:

  • Weitere Informationen finden Sie in der Fehlermeldung.
  • Überprüfen Sie die letzten Änderungen an der Kachel, Abfrage oder Datenquelle.
  • Versuchen Sie, das Dashboard zu aktualisieren.
  • Wenn das Problem weiterhin besteht, wenden Sie sich an den Support mit den Fehlerdetails.

Weitere Details aus Fehlermeldungen abrufen

Wenn ein Kachelfehler auftritt, zeigen Sie mit der Maus auf die Kachel, um die Schaltfläche "Details " verfügbar zu machen. Wählen Sie diese Schaltfläche aus, um weitere Informationen zum Fehler zu erhalten, einschließlich Fehlercodes und Meldungen, mit denen die Ursache identifiziert werden kann.

Beispiel:

Screenshot des Beispiels für Kachelfehlerdetails.

Allgemeiner Problembehandlungsansatz

Wenn Sie nicht sicher sind, wie Sie fortfahren können:

  • Aktualisieren Sie das Dashboard, um temporäre Probleme auszuschließen.
  • Überprüfen Sie andere Kacheln:
    • Wenn mehrere Kacheln fehlschlagen, liegt möglicherweise ein Datenquellen- oder Dienstproblem vor.
    • Wenn eine Kachel fehlschlägt, liegt wahrscheinlich ein Abfrage- oder Konfigurationsproblem vor.
  • Aktuelle Änderungen überprüfen:
    • Abfragebearbeitungen
    • Datenquellenaktualisierungen
    • Berechtigungsänderungen
  • Überprüfen Sie die Abfrage im Editor, sofern möglich.
  • Wenden Sie sich an ihren Administrator oder Datenbesitzer, wenn das Problem zugriffs- oder freigegebene Ressourcen umfasst.