Problembehandlung für Azure Managed Grafana
Dieser Artikel führt Sie durch die Problembehandlung von Fehlern mit Azure Managed Grafana und schlägt Lösungen vor, um diese zu beheben.
Zugriffsberechtigungsbenachrichtigungen werden beim Erstellen des Arbeitsbereichs angezeigt
Bei der Erstellung einer Managed Grafana-Instanz über das Azure-Portal erhält der Benutzer auf der Registerkarte Grundlagen eine Warnung: Sie haben möglicherweise nicht genügend Zugriffsrechte für das Abonnement oder die Ressourcengruppe unten, um alle Funktionen zu aktivieren. Details finden Sie auf der Registerkarte „Berechtigung“.
Auf der Registerkarte Berechtigungen wird eine weitere Warnung angezeigt: Sie müssen „Besitzer“ des Abonnements oder „Benutzerzugriffsadministrator“ sein, um dieses Feature verwenden zu können. Rollenzuweisungssteuerelemente sind deaktiviert.
Diese Warnungen werden ausgelöst, weil der Benutzer kein Administrator oder Besitzer des Abonnements ist und die folgenden Konsequenzen auftreten, wenn der Benutzer den Arbeitsbereich erstellt:
- Der Benutzer erhält nicht die Rolle „Grafana Admin“ für die neue Grafana-Instanz
- Die systemseitig zugewiesene verwaltete Identität dieser Grafana-Instanz erhält nicht die Rolle „Monitoring Reader“ (Überwachungsleser).
Lösung 1: Fortsetzen und Administratorhilfe erhalten
Fahren Sie mit der Erstellung des Managed Grafana-Arbeitsbereichs fort. Sie sollten wissen, dass Sie die Managed Grafana-Instanz erst dann nutzen können, wenn Ihr Abonnementadministrator Ihnen eine Rolle „Grafana Admin“, „Grafana Editor“ oder „Grafana Viewer“ zuweist.
Lösung 2: Auswählen eines anderen Abonnements
Der Benutzer kann ein anderes Abonnement auf der Registerkarte Grundlagen auswählen. Er muss dazu ein Administrator oder Besitzer sein. Das Banner wird geschlossen.
Fehler bei der Erstellung der Azure Managed Grafana-Instanz
Ein Fehler wird angezeigt, wenn der Benutzer eine Managed Grafana-Instanz im Azure-Portal erstellt.
Lösung 1: Bearbeiten des Instanznamens
Wenn Sie beim Ausfüllen des Formulars zum Erstellen einer Managed Grafana-Instanz einen Fehler erhalten, haben Sie möglicherweise einen ungültigen Namen für Ihre Grafana-Instanz angegeben.
Geben Sie einen Namen ein, auf den Folgendes zutrifft:
- Er ist in der gesamten Azure-Region eindeutig. Er kann nicht bereits von einem anderen Benutzer verwendet werden.
- Ist maximal 23 Zeichen lang.
- Er beginnt mit einem Buchstaben. Die restlichen Zeichen dürfen nur alphanumerische Zeichen oder Bindestriche sein, und der Name muss mit einem alphanumerischen Zeichen enden.
Lösung 2: Überprüfen des Bereitstellungsfehlers
Überprüfen Sie die Bereitstellungsdetails der Managed Grafana-Instanz, und lesen Sie die Statusmeldung.
Führen Sie die folgende Aktion je nach Fehlermeldung aus:
Die Statusmeldung besagt, dass die Region nicht unterstützt wird und stellt eine Liste der unterstützten Azure-Regionen zur Verfügung. Versuchen Sie erneut, eine neue Managed Grafana-Instanz bereitzustellen. Wenn Sie zum ersten Mal versuchen, eine Managed Grafana-Instanz zu erstellen, schlägt das Azure-Portal Azure-Regionen vor, die nicht verfügbar sind. Diese Regionen werden bei Ihrem zweiten Versuch nicht angezeigt.
Die Statusmeldung besagt, dass das Rollenzuweisungsupdate nicht zulässig ist. Der Benutzer ist kein Abonnementbesitzer. Wenn die Ressourcenbereitstellung erfolgreich war und die Rollenzuweisung fehlgeschlagen ist, bitten Sie eine Person mit Besitzer- oder Administratorzugriffssteuerung über Ihr Abonnement um Folgendes:
- Zuweisen der Rolle „Monitoring reader“ (Überwachungsleser) auf Abonnementebene zur verwalteten Identität der Managed Grafana-Instanz
- Zuweisen einer Rolle „Grafana Admin“ Rolle für diese neue Managed Grafana-Instanz
Wenn die Statusnachricht auf einen Konflikt verweist, hat möglicherweise jemand zur gleichen Zeit eine andere Instanz mit demselben Namen erstellt, oder die Namensüberprüfung ist früher fehlgeschlagen, was zu einem späteren Zeitpunkt zu einem Konflikt führt. Löschen Sie diese Instanz, und erstellen Sie eine andere Instanz mit einem anderen Namen.
Benutzer kann nicht auf seine Managed Grafana-Instanz zugreifen
Der Benutzer hat erfolgreich eine Azure Managed Grafana-Instanz erstellt, kann jedoch nicht auf seine Managed Grafana-Instanz zugreifen, wenn er zur Endpunkt-URL wechselt.
Lösung 1: Überprüfen des Bereitstellungsstatus
Wenn Sie eine Seite mit einer Fehlermeldung wie „Diese Seite kann nicht erreicht werden“ erhalten, die besagt, dass die Antwort der Seite zu lange gedauert hat, führen Sie die unten beschriebenen Schritte aus:
Öffnen Sie auf der Azure-Plattform Ihre Instanz, und navigieren Sie zur Seite Übersicht. Stellen Sie sicher, dass der BereitstellungsstatusErfolgreich lautet und alle anderen Felder im Abschnitt Essentials mit Daten aufgefüllt wurden. Wenn alles in Ordnung zu sein scheint, fahren Sie mit dem unten beschriebenen Verfahren fort. Andernfalls löschen Sie eine Instanz und erstellen sie dann neu.
Wenn Sie mehrere Browserweiterleitungen gesehen haben und dann auf einer allgemeinen Browserfehlerseite gelandet sind, wie oben gezeigt, dann bedeutet das, dass es einen Fehler im Back-End gibt.
Wenn Sie eine Firewall verwenden, die ausgehenden Datenverkehr blockiert, erlauben Sie den Zugriff auf Ihre Instanz, auf Ihre URL mit der Endung „grafana.azure.com“ und auf Microsoft Entra ID.
Lösung 2: Beheben von Zugriffsrollenproblemen
Wenn Sie eine Fehlerseite mit der Meldung „Keine Rollen zugewiesen“ erhalten:
Das Problem kann in folgenden Fällen auftreten:
Sie sind nicht berechtigt, eine Grafana Admin-Rolle für sich selbst hinzuzufügen. Weitere Informationen finden Sie unter „Zugriffsrechtbenachrichtigungen werden beim Erstellen des Arbeitsbereichs angezeigt.
Sie haben die CLI, eine ARM-Vorlage oder andere Verfahren als das Azure-Portal verwendet, um den Arbeitsbereich zu erstellen. Nur das Azure-Portal fügen Sie automatisch als Grafana Admin hinzu. In allen anderen Fällen müssen Sie sich manuell die Rolle Grafana Admin zuweisen.
- Wählen Sie in Ihrem Grafana-Arbeitsbereich die Option Zugriffssteuerung (IAM) > Rollenzuweisung hinzufügen aus, um diese Rollenzuweisung hinzuzufügen. Sie müssen über die Rolle „Administrator“ oder „Besitzer“ für das Abonnement oder die Managed Grafana-Ressource verfügen, um diese Rollenzuweisung vorzunehmen. Bitten Sie Ihren Administrator, Ihnen zu helfen, wenn Sie keinen ausreichenden Zugriff besitzen.
- Ihr Konto ist ein Fremdkonto: Die Grafana-Instanz ist nicht in Ihrem Heimmandanten registriert.
- Wenn Sie dieses Problem kürzlich behoben haben und Ihnen eine ausreichende Grafana-Rolle zugewiesen wurden, müssen Sie möglicherweise einige Zeit warten, bis das Cookie abläuft und eine Aktualisierung erfolgt. Dieser Prozess dauert normalerweise 5 Minuten. Wenn Zweifel bestehen, löschen Sie alle Cookies, oder starten Sie eine private Browsersitzung, um ein frisches neues Cookie mit den neuen Rolleninformationen zu erzwingen.
Autorisierte Benutzer werden in der Grafana-Benutzerkonfiguration nicht angezeigt
Nach dem Hinzufügen eines Benutzers zu einer integrierten RBAC-Rolle von Managed Grafana (z. B. Grafana-Leser) wird dieser Benutzer auf der Benutzeroberfläche von Grafana nicht sofort auf der Seite Konfiguration aufgeführt. Dieses Verhalten ist beabsichtigt. RBAC-Rollen von Managed Grafana werden in Microsoft Entra ID gespeichert. Aus Leistungsgründen synchronisiert Managed Grafana Benutzer, die den integrierten Rollen zugewiesen sind, nicht automatisch mit jeder Instanz. Es gibt keine Benachrichtigung für Änderungen an RBAC-Zuordnungen. Regelmäßige Abfragen von Microsoft Entra ID zum Abrufen aktueller Zuordnungen bedeuten einen hohen Zusatzaufwand für den Microsoft Entra-Dienst.
Dies kann im Grunde nicht behoben werden. Nachdem sich ein Benutzer bei Ihrer Grafana-Instanz angemeldet hat, wird er auf der Registerkarte Benutzer unter der Konfiguration von Grafana angezeigt. Sie können sehen, welcher Rolle der Benutzer zugewiesen wurde.
Azure Managed Grafana-Dashboardpanel zeigt keine Daten an
Mindestens ein Managed Grafana-Dashboardpanel zeigt keine Daten an.
Lösung: Überprüfen Sie die Dashboardeinstellungen.
Kontext: Grafana-Dashboards sind so eingerichtet, dass sie neue Daten regelmäßig abrufen. Wenn das Dashboard zu oft aktualisiert wird, um die zugrunde liegende Abfrage zu laden, bleibt das Panel hängen, ohne dass es jemals Daten geladen und angezeigt werden können.
- Prüfen Sie, wie häufig das Dashboard für die Aktualisierung der Daten konfiguriert ist.
- Navigieren Sie in Ihrem Dashboard zu Dashboardeinstellungen.
- Verringern Sie in den allgemeinen Einstellungen die Automatische Aktualisierungsrate des Dashboards, um nicht schneller zu sein als die Zeit, die zum Laden der Abfrage benötigt wird.
- Wenn eine Abfrage zu lange dauert, um Daten abzurufen. Grafana löst automatisch für bestimmte Abhängigkeitsaufrufe, die länger als z. B. 30 Sekunden dauern, Timeouts aus. Vergewissern Sie sich, dass keine ungewöhnlichen Verzögerungen auf Seiten der Abfrage auftreten.
Allgemeine Probleme mit Datenquellen
Der Benutzer kann keine Verbindung mit einer Datenquelle herstellen, oder eine Datenquelle kann keine Daten abrufen.
Lösung: Überprüfen von Netzwerkeinstellungen und IP-Adresse
So beheben Sie dieses Problem
- Überprüfen Sie die Netzwerkeinstellung des Datenquellenservers. Es sollte keine Firewall vorhanden sein, die Grafana vom Zugriff darauf blockiert.
- Prüfen Sie, dass die Datenquelle nicht versucht, sich mit einer privaten IP-Adresse zu verbinden. Azure Managed Grafana unterstützt derzeit keine Verbindungen mit privaten Netzwerken.
Azure Monitor kann keine Daten abrufen
Jede Grafana-Instanz wird mit einer Azure Monitor-Datenquelle vorkonfiguriert. Beim Versuch, ein vorab bereitgestelltes Dashboard zu verwenden, stellt der Benutzer fest, dass die Azure Monitor-Datenquelle keine Daten abrufen kann.
Lösung: Überprüfen Ihrer Azure Monitor-Dateneinstellungen
Suchen Sie nach einem vorab bereitgestellten Dashboard, indem Sie Ihren verwalteten Grafana-Endpunkt öffnen und Dashboards>Durchsuchen auswählen. Wählen Sie dann ein Dashboard aus, z. B. Azure Monitor>Azure-App-Überwachung – Application Insights.
Stellen Sie sicher, dass die Dropdownlisten am oberen Rand mit einem Abonnement, einer Ressourcengruppe und einem Ressourcennamen aufgefüllt sind. Im folgenden Screenshotbeispiel wird die Dropdownliste Ressource auf null festgelegt. Wählen Sie in diesem Fall einen Ressourcennamen aus. Möglicherweise müssen Sie eine andere Ressourcengruppe auswählen, die einen Ressourcentyp enthält, für den das Dashboard entworfen wurde. In diesem Beispiel müssen Sie eine Ressourcengruppe auswählen, die über eine Application Insights-Ressource verfügt.
Öffnen der Azure Monitor-Einrichtungsseite für die Datenquelle
- Wählen Sie in Ihrem Managed Grafana-Endpunkt Konfigurationen im linken Menü aus, und wählen Sie dann Datenquellen aus.
- Wählen Sie Azure Monitor aus.
Wenn die Datenquelle eine verwaltete Identität verwendet:
Wählen Sie die Schaltfläche Abonnements laden aus, um einen Schnelltest vorzunehmen. Wenn Standardabonnement Ihr Abonnement angibt, kann Managed Grafana innerhalb dieses Abonnements auf Azure Monitor zugreifen. Wenn dies nicht der Fall ist, liegen Berechtigungsprobleme vor.
Überprüfen Sie, ob die Option für die systemseitig zugewiesene verwaltete Identität im Azure-Portal aktiviert ist. Wenn dies nicht der Fall ist, aktivieren Sie sie manuell:
- Öffnen Sie die Managed Grafana-Instanz im Azure-Portal.
- Wählen Sie im Menü auf der linken Seite unter Einstellungen die Option Identität aus.
- Wählen Sie Status: Ein und dann Speichern aus.
Überprüfen Sie, ob der verwalteten Identität die Rolle „Monitoring Reader“ der Managed Grafana-Instanz zugewiesen ist. Wenn dies nicht der Fall ist, fügen Sie sie manuell im Azure-Portal hinzu:
- Öffnen Sie die Managed Grafana-Instanz im Azure-Portal.
- Wählen Sie im Menü auf der linken Seite unter Einstellungen die Option Identität aus.
- Wählen Sie Azure-Rollenzuweisungen aus.
- Es sollte eine Rolle Monitoring Reader (Überwachungsleser) angezeigt werden, die Ihrer Managed Grafana-Instanz zugewiesen ist. Wenn dies nicht der Fall ist, wählen Sie „Rollenzuweisung hinzufügen“ aus, und fügen Sie die Rolle Monitoring Reader hinzu.
Wenn die Datenquelle Authentifizierung vom Typ App-Registrierung verwendet:
Navigieren Sie in Ihrem Grafana-Endpunkt zu Konfigurationen > Datenquellen > Azure Monitor, und überprüfen Sie, ob die Informationen für Verzeichnis-ID (Mandant) und Anwendungs-ID (Client) richtig sind.
Überprüfen Sie, ob dem Dienstprinzipal Identität die Rolle „Monitoring Reader“ der Managed Grafana-Instanz zugewiesen ist. Wenn dies nicht der Fall ist, fügen Sie sie manuell im Azure-Portal hinzu.
Falls erforderlich, wenden Sie den geheimen Clientschlüssel erneut an.
Azure Data Explorer kann keine Daten abrufen
Die Azure Data Explorer-Datenquelle kann keine Daten abrufen.
Lösung: Überprüfen Ihrer Azure Data Explorer-Einstellungen
Suchen Sie nach einem vorab bereitgestellten Dashboard, indem Sie Ihren verwalteten Grafana-Endpunkt öffnen und Dashboards>Durchsuchen auswählen. Wählen Sie dann ein Dashboard aus, z. B. Azure Monitor>Azure Data Explorer-Clusterressourcenerkenntnisse.
Stellen Sie sicher, dass die Dropdownlisten am oberen Rand die Namen einer Datenquelle, eines Abonnements, einer Ressourcengruppe, eines Namespace, einer Ressource und eines Arbeitsbereichs aufweisen. Im folgenden Screenshotbeispiel haben wir eine Ressourcengruppe ausgewählt, die keine Data Explorer-Cluster enthält. Wählen Sie in diesem Fall eine andere Ressourcengruppe aus, die einen Data Explorer-Cluster enthält.
Überprüfen Sie die Azure Data Explorer-Datenquelle, und überprüfen Sie, wie die Authentifizierung eingerichtet ist. Derzeit kann die Authentifizierung für Azure Data Explorer nur über Microsoft Entra ID eingerichtet werden.
Navigieren Sie in Ihrem Grafana-Endpunkt zu Konfigurationen > Datenquellen > Azure Data Explorer.
Überprüfen Sie, ob die Informationen, die für Azure Cloud, Cluster-URL, Verzeichnis-ID (Mandant), Anwendungs-ID (Client) und Geheimer Clientschlüssel angegeben werden, richtig sind. Erstellen Sie bei Bedarf einen neuen Schlüssel, der als geheimer Clientschlüssel hinzugefügt werden soll.
Oben auf der Seite finden Sie Anweisungen, die Sie durch den Prozess zur Erteilung der erforderlichen Berechtigungen für diese Microsoft Entra-App zum Lesen der Azure Data Explorer-Datenbank führen.
Stellen Sie sicher, dass Ihre Azure Data Explorer-Instanz keine Firewall aufweist, die den Zugriff auf Managed Grafana blockiert. Die Azure Data Explorer-Datenbank muss über das öffentliche Internet bereitgestellt werden.
Fehler beim Dashboardimport
Der Benutzer erhält beim Importieren eines Dashboards aus dem Katalog oder einer JSON-Datei einen Fehler. Eine Fehlermeldung wird angezeigt: Das Dashboard wurde von einer anderen Person geändert.
Lösung: Bearbeiten des Dashboardnamens oder der UID
Meistens tritt dieser Fehler auf, weil der Benutzer versucht, ein Dashboard zu importieren, das denselben Namen oder eindeutigen Bezeichner (UID) wie ein anderes Dashboard aufweist.
So überprüfen Sie, ob Ihre Managed Grafana-Instanz bereits über ein Dashboard mit demselben Namen verfügt:
Wählen Sie in Ihrem Grafana-Endpunkt Dashboards aus dem Navigationsmenü auf der linken Seite und dann Durchsuchen aus.
Überprüfen Sie die Dashboardnamen.
Benennen Sie das alte oder das neue Dashboard um.
Sie können auch die UID eines JSON-Dashboards bearbeiten, bevor Sie es importieren, indem Sie das Feld namens uid in der JSON-Datei bearbeiten.
Nach der Aktualisierung der Rollenzuweisung für verwaltete Identitäten ändert sich nichts
Nachdem Sie die systemseitig zugewiesene verwaltete Identität deaktiviert haben, kann die Datenquelle, die mit verwalteter Identität konfiguriert wurde, weiterhin auf die Daten aus Azure-Diensten zugreifen.
Lösung: Warten, bis die Änderung wirksam wird
Datenquellen, die mit einer verwalteten Identität konfiguriert wurden, können möglicherweise noch bis zu 24 Stunden auf Daten aus Azure-Diensten zugreifen. Wenn eine Rollenzuweisung in einer verwalteten Identität für Azure Managed Grafana aktualisiert wird, kann es aufgrund von Einschränkungen verwalteter Identitäten bis zu 24 Stunden dauern, bis die Änderung wirksam wird.