Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
linux:icinga:docker-stack [2025/03/19 20:09] – [Eigene Checks einbinden] adilinux:icinga:docker-stack [2025/03/21 20:05] (aktuell) – [Graphite] adi
Zeile 669: Zeile 669:
  
 ===== Notifications ===== ===== Notifications =====
-Damit Icinga Benachrichtungen per Mail senden kann müssen folgende Konfigurationen erstellt/gemacht werden.+Damit Icinga Benachrichtungen per Mail senden kann muss man sich eine ''msmtprc'' Datei erstellt werden. 
 +Diese steuert den lokalen Mailbefehl ''msmtp''. 
 +<code bash>cd /opt/docker-compose-icinga/ 
 +mkdir -p etc_data/msmtp/ 
 +vi etc_data/msmtp/msmtprc</code> 
 + 
 +Hier diesen Inhalt einfügen und nach belieben anpassen. 
 +<code># Set default values: use the mail submission port 587, and always use TLS. 
 +# On this port, TLS is activated via STARTTLS. 
 +defaults 
 +tls on 
 +#tls_starttls on 
 +tls_trust_file  /etc/ssl/certs/ca-certificates.crt 
 +logfile         /var/log/msmtp.log 
 +#aliases         /etc/aliases 
 + 
 +# Define a mail account 
 +account         <NAME> 
 +# Host name of the SMTP server 
 +host            <MAILHOST> 
 +port            <MAILHOST_PORT> 
 +tls_starttls    <on|off> 
 +# Envelope-from address 
 +from            <ABSENDERADRESSE> 
 +# Authentication 
 +auth            on 
 +user            <USERNAME> 
 +#password        <PLAINTEXT_PASSWORD> 
 +passwordeval    gpg2 --no-tty -q -d /etc/.msmtp-cred.gpg 
 + 
 +account default: <ACCOUNT_NAME></code> 
 + 
 +Dann erstellt man sich die verschlüsslete Datei mit dem Passwort. 
 +<code bash>vi etc_data/msmtp/.msmtp-cred.txt</code> 
 +Hier das Passwort einfügen und danach verschlüsseln. 
 +<code bash>gpg -c .msmtp-cred.txt</code> 
 +Die Passphrase merken, wird im Container jedes mal wenn er neu gestartet wurde abgefragt. 
 +Möchte man gpg nicht verwenden, dann einfach wie oben beschrieben das Passwort als Plaintext einfügen. 
 + 
 +Den Inhalt kann man so prüfen. 
 +<cocde bash>gpg -d --no-tty -q .msmtp-cred.txt.gpg</code> 
 + 
 +Die beiden Dateien ''msmtp'' und ''.msmtp-cred.php'' müssen noch in den "icinga2" container eingebunden werden. 
 +Dazu in der "docker-compose.yml" unter dem Service "icinga2" folgende Volumes hinzufügen. 
 +<code>- ./etc_data/msmtp/msmtprc:/etc/msmtprc:ro 
 +- ./etc_data/msmtp/.msmtp-cred.txt.gpg:/etc/.msmtp-cred.txt.gpg:ro</code> 
 + 
 +Jetzt noch die Konfiguration bekannt machen. 
 +<code bash>docker compose stop && docker compose up -d</code> 
 + 
 +Die Grundlage zum Senden von Mails ist nun vorhanden. 
 +Man kann im "icinga2" container das senden mit diesem Befehl testen. 
 +<code bash>echo "Irgend ein Text" | mail -a "From: <ABSENDER_ADRESSE" -s "Mailtest" <EMPFAENGER_ADRESSE> --debug-level=all</code> 
 + 
 +Jetzt noch IcingaWeb konfigurieren.
   - Felder erstellen   - Felder erstellen
-    - notification_address 
-      - **Datentyp**: String 
     - notification_from     - notification_from
-      - **Datentyp**: String 
-    - notification_logtosyslog 
       - **Datentyp**: String       - **Datentyp**: String
   - Zeitperiode erstellen   - Zeitperiode erstellen
Zeile 686: Zeile 736:
     - **Änderungsstypen**: benötigte wählen     - **Änderungsstypen**: benötigte wählen
   - Benachrichtigungsvorlage für Hosts und Services erstellen   - Benachrichtigungsvorlage für Hosts und Services erstellen
-    - **Felder hinzufügen**: notification_address, notification_from, notification_logtosyslog+    - **Felder hinzufügen**: notification_from
     - **Benutzer**: den erstellten Benutzer wählen     - **Benutzer**: den erstellten Benutzer wählen
     - **Benachrichtigungskommando**: mail-host-notification bzw. mail-service-notification     - **Benachrichtigungskommando**: mail-host-notification bzw. mail-service-notification
Zeile 699: Zeile 749:
     - **Anwenden auf**: Hosts bzw. Services     - **Anwenden auf**: Hosts bzw. Services
     - **Zuweisen wo**: 1. Textfeld: "host.enable_notifications" 2. Operatorfeld: "is true (or set)"     - **Zuweisen wo**: 1. Textfeld: "host.enable_notifications" 2. Operatorfeld: "is true (or set)"
-    - **notification_address**: Hostadresse mit Mailserver 
-    - **notification_logtosyslog**: "-v" nur setzen wenn Debug erwünscht 
  
 Wenn nun noch der Host oder Service die Benachrichtigungen aktiviert hat, werden Mails gesendet. Wenn nun noch der Host oder Service die Benachrichtigungen aktiviert hat, werden Mails gesendet.
Zeile 708: Zeile 756:
 <code bash>cd /opt/docker-compose-icinga <code bash>cd /opt/docker-compose-icinga
 docker compose logs -f icinga2</code> docker compose logs -f icinga2</code>
 +===== Graphite =====
 +Mit Graphite kann man Performancedaten der einzelnen Checks grafisch darstellen.
 +Zum einbinden von Graphite folgendes tun.
 +  - Docker Container erstellen <code bash>cd /opt/docker-compose-icinga
 +vi docker-compose.yml</code>
 +    - hier beim Service "icingaweb" diese Zeile wie folgt anpassen <code>icingaweb.enabledModules: director, icingadb, incubator, graphite</code>
 +    - danach folgendes unter den letzten Service einfügen <code>graphite:
 +    container_name: graphite
 +    image: graphiteapp/graphite-statsd
 +    restart: always
 +    ports:
 +      - "50080:80"
 +      - "52003-52004:2003-2004"
 +      - "52023-52024:2023-2024"
 +      - "58125:8125/udp"
 +      - "58126:8126"
 +    hostname: graphite
 +    volumes:
 +      #- ./backup:/opt/backup
 +      #- ./conf/graphite/conf:/opt/graphite/conf
 +      - ./graphite/graphite/storage:/opt/graphite/storage
 +      #- ./conf/webapp/graphite/functions/custom:/opt/graphite/webapp/graphite/functions/custom
 +      #- ./conf/nginx:/etc/nginx
 +      #- ./conf/statsd/config:/opt/statsd/config
 +      #- ./conf/logrotate.d:/etc/logrotate.d
 +      #- ./var/log:/var/log
 +      #- ./var/lib/redis:/var/lib/redis
 +    environment:
 +      - GRAPHITE_TIME_ZONE=Europe/Berlin
 +      - GRAPHITE_DATE_FORMAT=%m/%d
 +      - COLLECTD=1</code>
 +   - Volumeordner für Graphite erstellen <code bash>mkdir -p ./graphite/graphite/storage</code>
 +   - Icinga Konfiguration zum senden von Performancedaten erstellen <code bash>mkdir -p ./icinga2.conf.d/features-enabled</code>
 +     - hier die Datei graphite.conf mit folgendem Inhalt erstellen <code>/**
 + * The GraphiteWriter type writes check result metrics and
 + * performance data to a graphite tcp socket.
 + */
 +
 +object GraphiteWriter "graphite" {
 +  host = "graphite"
 +  port = 2003
 +}</code>
 +   - Graphite Container starten <code bash>docker compose stop && docker compose up -d</code>
 +   - ggf. in IcingaWeb unter Einstellungen (Zahnrad) -> "Modul" das Modul "graphite" einschalten
 +     - im Reiter "Backend" unter "Graphite Web URL" die URL "http://graphite:80/" einfügen
 +   - In der Ansicht eines Hosts oder Service werden nun die Graphen angezeigt, vorausgesetzt die Performancedaten sind in den jew. Icinga-Objekten eingeschaltet
 +   - Über die URL "http://<DOCKER_HOST_IP>:50080/" kann man direkt auf die Graphite Webseite zugreifen