Wie man Grafana auf Ubuntu installiert: Vollständiger Setup- und Konfigurationsleitfaden
Grafana ist eine der leistungsstärksten Open-Source-Plattformen für Datenvisualisierung und Infrastrukturüberwachung. Egal ob Sie die Serverleistung, Anwendungsmetriken oder geschäftliche KPIs verfolgen – die flexiblen Dashboards und umfangreiche Datenquellenunterstützung von Grafana machen es zu einem unverzichtbaren Werkzeug für jeden Systemadministrator oder DevOps-Ingenieur.
Dieser umfassende Leitfaden führt Sie durch jeden Schritt der Installation von Grafana auf Ubuntu – von der anfänglichen Systemvorbereitung über die Konfiguration von Datenquellen, das Erstellen Ihres ersten Dashboards, die Einrichtung von Warnungen bis hin zur Sicherung Ihrer Bereitstellung.
> Voraussetzungen: Ein laufender Ubuntu-Server (20.04 oder 22.04 LTS empfohlen), sudo-Berechtigungen und eine stabile Internetverbindung. Wenn Sie einen zuverlässigen Server zum Hosten Ihrer Grafana-Instanz benötigen, erwägen Sie VPS Hosting von AlexHost – optimiert für leistungskritische Überwachungsaufgaben.
Schritt 1: Systempakete aktualisieren
Vor der Installation neuer Software ist es wichtig, Ihren Paketindex zu synchronisieren und alle verfügbaren Upgrades anzuwenden. Dies gewährleistet Kompatibilität und reduziert das Risiko von Abhängigkeitskonflikten.
sudo apt update && sudo apt upgrade -yLassen Sie den Prozess abschließen, bevor Sie fortfahren. Auf einem neu bereitgestellten Server kann dies einige Minuten dauern.
Schritt 2: Grafana über das offizielle APT-Repository installieren
Grafana verwaltet ein offizielles APT-Repository für Debian-basierte Systeme, einschließlich Ubuntu. Die Verwendung des offiziellen Repositorys stellt sicher, dass Sie immer Zugriff auf die neuesten stabilen Versionen und Sicherheitspatches haben.
Schritt 2a: Erforderliche Abhängigkeiten installieren
Installieren Sie zunächst das software-properties-common Paket, das das add-apt-repository Dienstprogramm bereitstellt:
sudo apt install -y software-properties-common apt-transport-https wget gnupg2Schritt 2b: Den Grafana GPG-Signaturschlüssel importieren
Das Hinzufügen des GPG-Schlüssels ermöglicht es Ihrem System, die Authentizität von Paketen zu überprüfen, die aus dem Grafana-Repository heruntergeladen werden:
wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -Schritt 2c: Das offizielle Grafana APT-Repository hinzufügen
sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"Schritt 2d: Die Paketliste aktualisieren und Grafana installieren
sudo apt update
sudo apt install grafana -yNach Abschluss der Installation überprüfen Sie die installierte Version:
grafana-server -vSchritt 3: Grafana-Dienst starten und aktivieren
Nach der Installation starten Sie den Grafana-Server-Daemon und konfigurieren ihn so, dass er beim Systemstart automatisch startet:
sudo systemctl start grafana-server
sudo systemctl enable grafana-serverÜberprüfen Sie, dass der Dienst ordnungsgemäß ausgeführt wird:
sudo systemctl status grafana-serverSie sollten eine Ausgabe ähnlich der folgenden sehen, die bestätigt, dass der Dienst aktiv (läuft) ist:
● grafana-server.service - Grafana instance
Loaded: loaded (/lib/systemd/system/grafana-server.service; enabled)
Active: active (running) since ...Wenn der Dienst nicht startet, überprüfen Sie die Protokolle auf Fehler:
sudo journalctl -u grafana-server -fSchritt 4: Zugriff auf die Grafana-Weboberfläche
Standardmäßig lauscht Grafana auf Port 3000. Öffnen Sie Ihren Webbrowser und navigieren Sie zu:
http://your_server_ip:3000Ersetzen Sie your_server_ip durch die tatsächliche IP-Adresse oder den Hostnamen Ihres Servers.
Standard-Anmeldedaten
| Feld | Wert |
|---|---|
| Benutzername | admin |
| Passwort | admin |
Bei Ihrer ersten Anmeldung werden Sie von Grafana sofort aufgefordert, ein neues, sicheres Passwort festzulegen. Überspringen Sie diesen Schritt nicht — die Beibehaltung der Standard-Anmeldedaten stellt ein erhebliches Sicherheitsrisiko dar.
> Firewall-Hinweis: Wenn Sie UFW oder eine andere Firewall verwenden, öffnen Sie Port 3000, um den Browserzugriff zu ermöglichen:
> “`bash
> sudo ufw allow 3000/tcp
> sudo ufw reload
> “`
Schritt 5: Datenquellen konfigurieren
Grafana ist eine Visualisierungsschicht — es speichert Metriken nicht selbst. Stattdessen verbindet es sich mit externen Datenquellen wie Prometheus, InfluxDB, Elasticsearch, MySQL, PostgreSQL und vielen anderen. Die Konfiguration einer Datenquelle ist der wesentliche erste Schritt, bevor Sie ein Dashboard erstellen können.
Schritt 5a: Zu Datenquellen navigieren
- Klicken Sie in der linken Seitenleiste auf das Zahnradsymbol (⚙), um das Konfigurationsmenü zu öffnen.
- Wählen Sie Datenquellen.
Schritt 5b: Eine neue Datenquelle hinzufügen
- Klicken Sie auf Datenquelle hinzufügen.
- Durchsuchen Sie die Liste und wählen Sie den gewünschten Datenquellentyp (z. B. Prometheus, InfluxDB, MySQL).
Schritt 5c: Verbindungsdetails eingeben
Füllen Sie die Verbindungsparameter für Ihre gewählte Datenquelle aus. Wenn Sie sich beispielsweise mit einer lokal laufenden Prometheus-Instanz verbinden:
- URL:
http://localhost:9090 - Zugriff:
Server (default) - Scrape-Intervall:
15s(entsprechend Ihrer Prometheus-Scrape-Konfiguration)
Für eine Remote-InfluxDB-Instanz würden Sie die Host-URL, den Datenbanknamen und die Authentifizierungsdaten angeben.
Schritt 5d: Verbindung speichern und testen
Klicken Sie auf Speichern & Testen. Grafana versucht, sich mit der Datenquelle zu verbinden und zeigt eine Erfolgs- oder Fehlermeldung an. Eine grüne „Datenquelle funktioniert”-Bestätigung bedeutet, dass Sie bereit sind, Dashboards zu erstellen.
Schritt 6: Erstellen Sie Ihr erstes Grafana-Dashboard
Mit einer verbundenen Datenquelle können Sie jetzt Dashboards erstellen, um Ihre Metriken in Echtzeit zu visualisieren.
Schritt 6a: Erstellen Sie ein neues Dashboard
- Klicken Sie in der linken Seitenleiste auf das Symbol + (Plus).
- Wählen Sie Dashboard.
- Klicken Sie auf Add new panel.
Schritt 6b: Konfigurieren Sie das Panel
Der Panel-Editor wird geöffnet und gibt Ihnen vollständige Kontrolle darüber, welche Daten angezeigt werden und wie sie visualisiert werden.
- Data Source: Wählen Sie die Datenquelle aus, die Sie in Schritt 5 konfiguriert haben.
- Query: Schreiben Sie Ihre Metrik-Abfrage. Für Prometheus verwenden Sie PromQL. Um beispielsweise die CPU-Auslastung zu visualisieren:
100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)- Visualization Type: Wählen Sie aus Time series, Gauge, Bar chart, Table, Stat, Heatmap und mehr – je nach Art Ihrer Daten.
- Panel Title: Geben Sie Ihrem Panel einen aussagekräftigen Namen (z. B. „CPU Usage — Last 1 Hour”).
Schritt 6c: Anpassen und Speichern
Verwenden Sie die Panel-Optionen auf der rechten Seite, um Schwellenwerte, Farbschemas, Achsenbeschriftungen und Legenden zu konfigurieren. Wenn Sie zufrieden sind:
- Klicken Sie auf Apply, um das Panel zu Ihrem Dashboard hinzuzufügen.
- Wiederholen Sie den Vorgang, um mehrere Panels hinzuzufügen – jedes verfolgt eine andere Metrik.
- Klicken Sie auf das Symbol Save dashboard (Diskette) in der oberen rechten Ecke, geben Sie Ihrem Dashboard einen Namen ein und klicken Sie auf Save.
> Pro Tip: Die offizielle Dashboard-Bibliothek von Grafana bietet Hunderte von vorgefertigten, von der Community beigesteuerten Dashboards für beliebte Stacks wie Node Exporter, Kubernetes, MySQL und NGINX. Sie können diese direkt mit einer Dashboard-ID importieren.
Schritt 7: Warnungen einrichten
Die integrierte Alerting-Engine von Grafana ermöglicht es Ihnen, schwellenwertbasierte Regeln zu definieren und Benachrichtigungen zu erhalten, wenn Metriken kritische Werte überschreiten — damit Sie informiert bleiben, bevor kleine Probleme zu größeren Ausfällen werden.
Schritt 7a: Eine Warnregel erstellen
- Öffnen Sie das Panel, das Sie überwachen möchten, und klicken Sie auf Bearbeiten.
- Navigieren Sie zur Registerkarte Alert im Panel-Editor.
- Klicken Sie auf Warnung erstellen.
Schritt 7b: Warnbedingungen definieren
Konfigurieren Sie die Bedingungen, die die Warnung auslösen. Zum Beispiel:
- Bedingung:
WHEN avg() OF query(A, 5m, now) IS ABOVE 90 - Dies löst eine Warnung aus, wenn der Durchschnittswert Ihrer Metrik in den letzten 5 Minuten 90 überschreitet.
Legen Sie die Felder Evaluieren alle und Für fest, um zu steuern, wie häufig die Regel ausgewertet wird und wie lange die Bedingung bestehen bleiben muss, bevor sie ausgelöst wird.
Schritt 7c: Benachrichtigungskanäle konfigurieren
- Gehen Sie zu Alerting → Benachrichtigungskanäle in der linken Seitenleiste.
- Klicken Sie auf Kanal hinzufügen und wählen Sie Ihre bevorzugte Methode:
- E-Mail — erfordert SMTP-Konfiguration in
grafana.ini - Slack — erfordert eine Slack-Webhook-URL
- PagerDuty, OpsGenie, Webhook und mehr
Weisen Sie den Benachrichtigungskanal Ihrer Warnregel zu, damit die richtigen Personen benachrichtigt werden, wenn Schwellenwerte überschritten werden.
Schritt 8: Sichern Sie Grafana mit HTTPS und Zugriffskontrolle
Das Ausführen von Grafana in einer Produktionsumgebung ohne angemessene Sicherheitshärtung ist ein ernstes Risiko. Befolgen Sie diese Best Practices, um Ihre Überwachungsinfrastruktur zu schützen.
8a: HTTPS mit einem SSL-Zertifikat aktivieren
Das Verschlüsseln des Datenverkehrs zu Ihrer Grafana-Instanz ist wichtig, besonders wenn sie über das öffentliche Internet zugänglich ist. Sie benötigen ein gültiges SSL-Zertifikat — AlexHost bietet erschwingliche SSL-Zertifikate, die einfach bereitzustellen sind.
Sobald Sie Ihr Zertifikat und Ihren privaten Schlüssel haben, bearbeiten Sie die Grafana-Konfigurationsdatei:
sudo nano /etc/grafana/grafana.iniSuchen Sie den [server] Abschnitt und aktualisieren Sie die folgenden Parameter:
[server]
protocol = https
http_port = 3000
cert_file = /etc/grafana/ssl/grafana.crt
cert_key = /etc/grafana/ssl/grafana.keySpeichern Sie die Datei und starten Sie Grafana neu:
sudo systemctl restart grafana-serverGrafana ist jetzt über HTTPS auf Port 3000 zugänglich.
> Empfohlene Alternative: Platzieren Sie Grafana hinter einem Reverse Proxy (z. B. Nginx oder Apache) und beenden Sie SSL auf der Proxy-Ebene. Dies ist ein flexiblerer und weit verbreiteter Ansatz in Produktionsumgebungen.
8b: Admin-Zugriff einschränken und Benutzer verwalten
- Navigieren Sie zu Server Admin → Users in der Grafana-Benutzeroberfläche.
- Überprüfen und passen Sie Benutzerrollen an:
- Admin — vollständiger Zugriff
- Editor — kann Dashboards erstellen und bearbeiten
- Viewer — Lesezugriff
- Deaktivieren oder löschen Sie ungenutzte Konten.
- Erwägen Sie die Aktivierung von LDAP oder OAuth (Google, GitHub, GitLab) für zentralisierte Authentifizierung.
8c: Zusätzliche Härtungsempfehlungen
- Deaktivieren Sie den anonymen Zugriff in
grafana.ini:
[auth.anonymous]
enabled = false- Ändern Sie den Standard-HTTP-Port, wenn Grafana öffentlich verfügbar gemacht wird.
- Beschränken Sie ausgehende Verbindungen vom Grafana-Server mithilfe von Firewall-Regeln.
- Aktivieren Sie Audit-Logging, um Benutzeraktivitäten zu verfolgen.
Schritt 9: Grafana verwalten und aktualisieren
Es ist wichtig, Grafana auf dem neuesten Stand zu halten, um Sicherheit und Zugriff auf neue Funktionen zu gewährleisten. Da Sie Grafana aus dem offiziellen APT-Repository installiert haben, sind Updates unkompliziert.
Grafana aktualisieren
sudo apt update
sudo apt upgrade grafana -yHäufige Service-Management-Befehle
| Aktion | Befehl |
|---|---|
| Grafana starten | sudo systemctl start grafana-server |
| Grafana stoppen | sudo systemctl stop grafana-server |
| Grafana neu starten | sudo systemctl restart grafana-server |
| Konfiguration neu laden | sudo systemctl reload grafana-server |
| Status überprüfen | sudo systemctl status grafana-server |
| Protokolle anzeigen | sudo journalctl -u grafana-server -f |
Grafana-Daten sichern
Grafana speichert seine Konfiguration, Dashboards und Benutzerdaten standardmäßig in einer SQLite-Datenbank, die sich unter folgendem Pfad befindet:
/var/lib/grafana/grafana.dbSichern Sie diese Datei regelmäßig, besonders vor Upgrades:
sudo cp /var/lib/grafana/grafana.db /var/lib/grafana/grafana.db.backup-$(date +%F)Erwägen Sie für größere Bereitstellungen die Migration zu einem dedizierten MySQL– oder PostgreSQL-Backend für verbesserte Zuverlässigkeit und einfachere Backup-Verwaltung.
Fehlerbehebung häufiger Probleme
| Problem | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Zugriff auf Port 3000 nicht möglich | Firewall blockiert den Port | Führen Sie sudo ufw allow 3000/tcp aus |
| Service startet nicht | Konfigurationsfehler oder Port-Konflikt | Überprüfen Sie journalctl -u grafana-server |
| "Datenquellenverbindung fehlgeschlagen" | Falsche URL oder Firewall-Regeln | Überprüfen Sie die Datenquellen-URL und den Netzwerkzugriff |
| Anmeldung funktioniert nach Passwortänderung nicht | Browser-Cache | Löschen Sie den Cache oder verwenden Sie den Inkognito-Modus |
| Grafana läuft langsam | Unzureichende Server-Ressourcen | Aktualisieren Sie auf einen höherwertigen VPS Hosting Plan |
Wahl des richtigen Hostings für Ihren Grafana-Stack
Die Leistung Ihrer Grafana-Bereitstellung hängt stark von der zugrunde liegenden Infrastruktur ab. Hier ist ein kurzer Leitfaden zur Wahl der richtigen Hosting-Stufe:
- Kleine Teams / persönliche Projekte: Shared Web Hosting kann für leichte Setups funktionieren, obwohl ein VPS für Grafana generell empfohlen wird.
- Production Monitoring Stacks: Ein VPS Hosting Plan bietet Ihnen dedizierte Ressourcen, Root-Zugriff und die Flexibilität, Grafana zusammen mit Prometheus, InfluxDB oder anderen Komponenten auszuführen.
- Hochvolumige Datenaufnahme / ML-gesteuerte Observability: Erwägen Sie GPU Hosting für Workloads, die großflächige Datenverarbeitung oder KI-gesteuerte Anomalieerkennung beinhalten.
- Enterprise-Bereitstellungen: Dedicated Servers bieten maximale Leistung, Isolation und Sicherheit für unternehmenskritische Monitoring-Infrastruktur.
Fazit
Die Installation und Konfiguration von Grafana auf Ubuntu ist ein unkomplizierter Prozess, der leistungsstarke Echtzeitüberwachung Ihrer Systeme und Anwendungen ermöglicht. Durch diesen Leitfaden haben Sie gelernt, wie Sie:
- Grafana aus dem offiziellen Repository auf Ubuntu installieren
- Den Grafana-Dienst starten, aktivieren und überprüfen
- Datenquellen wie Prometheus, InfluxDB und MySQL verbinden
- Interaktive Dashboards mit benutzerdefinierten Panels und Visualisierungen erstellen
- Schwellenwertbasierte Warnungen mit Multi-Channel-Benachrichtigungen konfigurieren
- Ihre Grafana-Instanz mit HTTPS und rollenbasierten Zugriffskontrolle sichern
- Grafana mit Standard-APT-Befehlen warten und aktualisieren
Egal ob Sie einen einzelnen VPS oder eine komplexe Multi-Node-Infrastruktur überwachen – Grafana bietet die Observability-Grundlage, die Sie benötigen, um Leistungsproblemen zuvorzukommen und datengestützte Entscheidungen zu treffen. Kombinieren Sie es mit einer zuverlässigen Hosting-Umgebung von AlexHost, und Sie haben alles, was Sie für einen erstklassigen Monitoring-Stack benötigen.
bei allen Hosting-Diensten