icinga-stack/README.md

Full Icinga2 stack with Grafana

: Icinga
: IcingaWeb2
: icinga-satellite (optional)

what is this

This is a auto setup Icinga stack, means:

• AO-IT: icinga2

  • as Icinga2
    • with IcingaDB
      • MariaDB (App DB)
      • Redis (App Cache)
    • with InfluxDB (Performance Data)

• AO-IT: icingaweb2

  • as IcingaWeb2
    • with Icinga DB Web
    • with Grafana
      • icingaweb2-module-grafana
    • with OIDC / OAuth
      • icingaweb2-module-oidc
    • MariaDB (Config DB)

• AO-IT: icinga-satellite (optional, not in this repo)

required

• basic know how of icinga
  • for monitoring config it self not for setup

usage

git clone https://git.ao-it.net/docker/icinga-stack
cd icinga-stack
mv env.sample .env
# MUST SET: GRAFANA_HOST
# HIGH RECOMMEND TO CHANGE:
# - API_ROOT_PASS
# - ICINGA_API_ICINGAWEB_PASS
nano .env   # set your env

setup reverse proxy here caddy create a file ./files/Caddyfile with content:

mon.example.com {
    reverse_proxy icingaweb2:8080
}
graph.example.com {
    reverse_proxy grafana:3000
}

... or unkomment port expose on grafana and icingaweb2
... or use own reverse proxy

docker compose up

Access IcingaWeb on port http://your-ip:8080

• Intial basic checks should be visible.
• All Database connections should work.
• If you can access the $GRAFANA_HOST address you should see graphs as well.
  • maybe need a few min until first checks a done.

To change icinga2 config:
Go in your file system and change them.
Than you can run:

docker exec icinga-stack-icinga2-1 icinga2 daemon -C -X 
docker exec icinga-stack-icinga2-1 /usr/lib/icinga2/safe-reload /etc/default/icinga2

To check and reload them for activate the new icinga2 config.

env

For detailed information of environment variables check the original repos (above)