Prometheus Grafana

Last change on 2024-11-06 • Created on 2022-06-20 • ID: CL-EC4B4
prometheus grafana logo

Diese App enthält eine fertige Prometheus und Grafana Installation. Du kannst sie über die Hetzner Console oder die Hetzner Cloud API installieren.

Deploy to Hetzner Cloud

Grafana ist eine Open-Source Software zur Visualisierung von Metriken. Diese Metriken werden von der Anwendung Prometheus zur Verfügung gestellt.

Getting Started

Erstell dir deinen Server wie gewohnt über die Hetzner Console. Alternativ zum Betriebssystem kannst du eine App wählen, die du gerne vorinstalliert hättest.

Prometheus und Grafana ist vorinstalliert, wenn das Image gebootet wird, aber nicht aktiviert.

Um Prometheus und Grafana zu aktivieren, melde dich bitte auf deinem Server an:

  • Per SSH-Key, falls du beim Erstellen deines Servers einen angegeben hast
  • Per root-Passwort, das du beim Erstellen deines Servers per E-Mail von uns erhalten hast, wenn kein SSH-Key angegeben wurde

Dies führt dich durch einen Prozess, wobei du anschließend Grafana wie gewohnt aus dem Web, mit automatischer Let's Encrypt-Unterstützung, benutzen kannst.

Hetzner Cloud API

Anstelle der Hetzner Console kann zum Einrichten eines Servers mit vorinstalliertem Prometheus und Grafana auch die Hetzner Cloud API genutzt werden.

  • Zum Beispiel per Curl-Befehl über die Kommandozeile

    curl \
       -X POST \
       -H "Authorization: Bearer $API_TOKEN" \
       -H "Content-Type: application/json" \
       -d '{"name":"my-server", "server_type":"cpx32", "image":"prometheus-grafana"}' \
       'https://api.hetzner.cloud/v1/servers'
  • Oder über hcloud-cli

    hcloud server create --name my-server --type cpx32 --image prometheus-grafana

Image Inhalt

Betriebssystem

  • Ubuntu 24.04

Installierte Pakete und Container

Dieses Image enthält Docker und alle anderen aufgeführten Anwendungen als Docker Container.

NAME LIZENZ
Prometheus GGPLv3 (Apache 2.0)
Grafana AGPLv3
Node-Exporter GPLv3 (Apache 2.0)
Cadvisor GPLv3 (Apache 2.0)
Docker GPLv3 (Apache 2.0)
Watchtower GPLv3 (Apache 2.0)
Caddy-docker-proxy MIT

Passwörter

Wir verwenden automatisch generierte Passwörter, die im folgenden Ordner gespeichert werden:

/root/.hcloud_password

Nützliche Befehle

Passwort zurücksetzen

Grafana

Im Falle eines Verlust des Passworts für den Benutzer admin kannst du dieses über die grafana-cli zurücksetzen. Melden sie sich hierfür zunächst an dem Server an. Anschließend führst du folgenden Befehl auf dem Server aus und setzen hierbei das von dir gewünschte Passwort ein:

docker exec -it grafana grafana-cli --homepath "/usr/share/grafana" admin reset-admin-password <password>

Das Passwort für den Benutzer admin wurde nun zurückgesetzt.

Prometheus

Falls du das Passwort für die Prometheus Basic Auth ändern möchten, kannst du zunächst einen neuen Passwort-Hash mit folgendem Befehl generieren.

docker exec -it caddy caddy hash-password -plaintext <password>

Anschließend ändern sie den Hashwert für die Variable PROMETHEUS_ADMIN_PASSWORD in der Datei /opt/containers/prometheus-grafana/.env. Stoppst du nun den Caddy Container und starten lässt du ihn anschließend wieder um die Änderung des Passworts abzuschließen.

docker compose -f /opt/containers/prometheus-grafana/docker-compose.yml stop caddy
docker compose -f /opt/containers/prometheus-grafana/docker-compose.yml start caddy

Weitere Informationen über die installierten Pakete und Container erhältst du in den offiziellen Dokumentationen:

Weitere Informationen über Hetzner Cloud und Hetzner Cloud Apps erhältst du in unserer offiziellen Dokumentation:

Table of Contents