|
1 | 1 | // -*- coding: utf-8 -*- |
2 | 2 | // IGNORE |
3 | | -// SKIPCOMMITS 2025-07-22 |
| 3 | +// NONASCII |
4 | 4 | include::global_attr.adoc[] |
5 | 5 | = Prometheus integrieren |
6 | | -:revdate: 2024-04-12 |
7 | 6 | :title: Prometheus integrieren |
8 | 7 | :description: Prometheus kann in {CMK} integriert werden, um schnelllebige Containerumgebungen zu überwachen. Hier erfahren Sie, wie Sie die Überwachung einrichten. |
9 | 8 |
|
10 | 9 | {related-start} |
11 | | -link:https://checkmk.com/de/integrations[Katalog der Check-Plugins^] |
| 10 | +link:https://checkmk.com/integrations[Katalog der Check-Plugins^] |
12 | 11 | xref:monitoring_kubernetes#[Kubernetes überwachen] |
13 | 12 | {related-end} |
14 | 13 |
|
15 | 14 |
|
| 15 | +[#intro] |
16 | 16 | == Einleitung |
17 | 17 |
|
18 | 18 | === Hintergrund und Motivation |
@@ -42,28 +42,29 @@ Für Prometheus stehen Ihnen die folgenden Exporter zur Verfügung: |
42 | 42 | * link:https://github.com/prometheus/node_exporter/blob/master/README.md[Node Exporter^] |
43 | 43 |
|
44 | 44 | Wenn wir den von Ihnen benötigten Exporter nicht unterstützen, haben erfahrene Nutzer von Prometheus auch die Möglichkeit, direkt über {CMK} selbst definierte Abfragen an Prometheus zu richten. |
45 | | -Dies geschieht in der Prometheus-eigenen xref:promQL[Abfragesprache PromQL.] |
| 45 | +Dies geschieht in der Prometheus-eigenen xref:promQL[Abfragesprache PromQL]. |
46 | 46 |
|
47 | 47 |
|
| 48 | +[#setup] |
48 | 49 | == Einrichten der Integration |
49 | 50 |
|
50 | 51 | === Host anlegen |
51 | 52 |
|
52 | 53 | Da es das Konzept der Hosts in Prometheus schlicht nicht gibt, schaffen Sie zuerst einen Ort, der die gewünschten Metriken sammelt. |
53 | 54 | Dieser Host bildet die zentrale Anlaufstelle für den Spezialagenten und verteilt die angelieferten Daten dann später an die richtigen Hosts in {CMK}. |
54 | | -Erzeugen Sie dazu einen neuen Host über [.guihint]#Setup > Hosts > Hosts > Add host.# |
| 55 | +Erzeugen Sie dazu einen neuen Host über [.guihint]#Setup > Hosts > Hosts > Add host#. |
55 | 56 |
|
56 | 57 | image::prometheus_hostname.png[] |
57 | 58 |
|
58 | 59 | Sollte der angegebene Host-Name nicht vom {CMK}-Server auflösbar sein, geben Sie hier noch die IP-Adresse an unter der der Prometheus-Server erreichbar ist. |
59 | 60 |
|
60 | | -Nehmen Sie alle weiteren Einstellungen Ihrer Umgebung entsprechend vor und bestätigen Sie Ihre Auswahl mit [.guihint]#Save & view folder.# |
| 61 | +Nehmen Sie alle weiteren Einstellungen Ihrer Umgebung entsprechend vor und bestätigen Sie Ihre Auswahl mit [.guihint]#Save & view folder#. |
61 | 62 |
|
62 | 63 |
|
63 | 64 | === Regel für Prometheus anlegen |
64 | 65 |
|
65 | 66 | Bevor {CMK} Ihre Metriken aus Prometheus finden kann, müssen Sie zuerst noch den Spezialagenten über den Regelsatz [.guihint]#Prometheus# einrichten. |
66 | | -Diesen finden Sie über [.guihint]#Setup > Agents > VM, cloud, container.# |
| 67 | +Diesen finden Sie über [.guihint]#Setup > Agents > VM, cloud, container#. |
67 | 68 | Unabhängig davon, welchen Exporter Sie verwenden wollen, gibt es verschiedene Möglichkeiten, die Verbindung zu dem Web Frontend Ihres Prometheus-Servers anzupassen. |
68 | 69 |
|
69 | 70 | * [.guihint]#URL server address#: |
@@ -156,7 +157,7 @@ Beachten Sie, dass sie zwar immer Gleitkommazahlen angeben, diese sich aber nat |
156 | 157 |
|
157 | 158 | ==== Regel dem Prometheus-Host zuweisen |
158 | 159 |
|
159 | | -Weisen Sie zum Schluss diese Regel explizit dem soeben angelegten Host zu und bestätigen Sie mit [.guihint]#Save.# |
| 160 | +Weisen Sie zum Schluss diese Regel explizit dem soeben angelegten Host zu und bestätigen Sie mit [.guihint]#Save#. |
160 | 161 |
|
161 | 162 | image::prometheus_ruleset_explicit_host.png[] |
162 | 163 |
|
@@ -204,7 +205,7 @@ Im Falle von Containern kann das aber durchaus nützlich sein, wie in dem Beispi |
204 | 205 | // TK: 2: "wie in dem Beispiel eben gesehen": Welches Beispiel? |
205 | 206 |
|
206 | 207 | Wenn Container nur neu gestartet werden, möchten Sie sehr wahrscheinlich deren Historie nicht verlieren. |
207 | | -Um das zu erreichen, legen Sie die Container nicht unter ihren IDs, sondern stattdessen unter ihren Namen an -- mit der Option [.guihint]#Name - Use the name of the container# in der xref:cadvisor[Prometheus-Regel.] |
| 208 | +Um das zu erreichen, legen Sie die Container nicht unter ihren IDs, sondern stattdessen unter ihren Namen an -- mit der Option [.guihint]#Name - Use the name of the container# in der xref:cadvisor[Prometheus-Regel]. |
208 | 209 |
|
209 | 210 |
|
210 | 211 | Auf diese Weise können Sie nicht mehr vorhandene Container dennoch mit der Option [.guihint]#Delete vanished hosts# in der dynamischen Host-Verwaltung löschen, |
|
0 commit comments