# Icinga2 Satellite
[![Build Status](https://git.ao-it.net/docker/icinga-satellite/actions/workflows/docker-build.yml/badge.svg?branch=main&event=push)](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
```