Prometheus Grafana

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

Diese App enthält eine fertige Prometheus und Grafana Installation. Sie können sie über die Hetzner Cloud Console oder die Hetzner Cloud API installieren.

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

Getting Started

Erstellen Sie sich Ihren Server wie gewohnt über die Hetzner Cloud Console. Alternativ zum Betriebssystem können Sie eine App wählen, die Sie gerne vorinstalliert hätten.

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

Um Prometheus und Grafana zu aktivieren, melden Sie sich bitte auf Ihrem Server an:

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

Dies führt Sie durch einen Prozess, wobei sie anschließend Grafana wie gewohnt aus dem Web, mit automatischer Let's Encrypt-Unterstützung, benutzen können.

Hetzner Cloud API

Anstelle der Hetzner Cloud 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":"cpx21", "image":"prometheus-grafana"}' \
       'https://api.hetzner.cloud/v1/servers'
  • Oder über hcloud-cli

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

Image Inhalt

Betriebssystem

  • Ubuntu 22.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 können sie dieses über die grafana-cli zurücksetzen. Melden sie sich hierfür zunächst an dem Server an. Anschließend führen sie folgenden Befehl auf dem Server aus und setzen hierbei das von ihnen 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

Insofern sie das Passwort für die Prometheus Basic Auth ändern möchten, können sie 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. Stoppen sie nun den Caddy Container und starten sie 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 erhalten Sie in den offiziellen Dokumentationen:

Weitere Informationen über Hetzner Cloud und Hetzner Cloud Apps erhalten Sie in unserer offiziellen Dokumentation:

Table of Contents