66 lines
1.9 KiB
Markdown
66 lines
1.9 KiB
Markdown
# Icinga2 Satellite
|
|
[](https://git.ao-it.net/docker/icinga-satellite/actions?workflow=docker-build.yml&actor=0&status=0)
|
|
|
|
## Requirements
|
|
* need a running icinga2 master instance
|
|
* ticket & zone config in master instance
|
|
* see: [Icinga: Master Setup](https://icinga.com/docs/icinga-2/latest/doc/06-distributed-monitoring/#master-setup)
|
|
|
|
ATTENTION: primary designed for:
|
|
* [AO-IT: icinga-stack](https://git.ao-it.net/docker/icinga-stack)
|
|
* [AO-IT: icinga2](https://git.ao-it.net/docker/icinga2)
|
|
* [AO-IT: icingaweb2](https://git.ao-it.net/docker/icinga-satellite)
|
|
|
|
Maybe you need more setup setps if you use other base!
|
|
|
|
## usage
|
|
### master instance
|
|
## example zone.conf
|
|
* [Icinga: Zones](https://icinga.com/docs/icinga-2/latest/doc/06-distributed-monitoring/#zones)
|
|
* [Icinga: Endpoints](https://icinga.com/docs/icinga-2/latest/doc/06-distributed-monitoring/#endpoints)
|
|
|
|
> DO NOT copy&paste this config !
|
|
> Replace first all $VARS
|
|
|
|
```
|
|
object Endpoint "master.example.com" {
|
|
}
|
|
object Zone "master" {
|
|
endpoints = [ "master.example.com" ]
|
|
}
|
|
|
|
// your new config to do:
|
|
object Endpoint "$ICINGA_SATELLITE_CN" {
|
|
host = "1.2.3.4" // ip or
|
|
host = "$ICINGA_SATELLITE_CN" // hostname
|
|
}
|
|
object Zone "$ICINGA_SATELLITE_ZONE" {
|
|
parent = "$ICINGA_PARENT_CN"
|
|
endpoints = [ "$ICINGA_SATELLITE_CN" ]
|
|
}
|
|
// end: new config to do
|
|
|
|
object Zone "global-templates" {
|
|
global = true
|
|
}
|
|
|
|
object Zone "director-global" {
|
|
global = true
|
|
}
|
|
|
|
```
|
|
|
|
create new zone on master
|
|
```
|
|
mkdir zones.d/$ICINGA_SATELLITE_ZONE
|
|
nano zones.d/$ICINGA_SATELLITE_ZONE/hosts.conf
|
|
```
|
|
|
|
### satellite node
|
|
```
|
|
git clone https://git.ao-it.net/docker/icinga-satellite
|
|
cd icinga-satellite
|
|
cp env.sample .env
|
|
nano .env # set your env
|
|
docker compose up
|
|
``` |