Skip to content
Snippets Groups Projects
README.md 955 B
Newer Older
Nik | Klampfradler's avatar
Nik | Klampfradler committed
# Matrix passive check generator for Icinga 2
Nik | Klampfradler's avatar
Nik | Klampfradler committed
A [maubot](https://github.com/maubot/maubot) that sends pings to the
[echo](https://github.com/maubot/echo) plugin and sends any replies as
passive check result to Icinga 2.

## Mechanism

This maubot plugin leverages the ping fnuctionality of the echo plugin.
It sends ping messages to a room in configurable intervals, and waits for a
"Pong!" reply from the echo plugin. Both bots occupy this room (and preferrably
should be alone there).

The echo bot sends a tiem diff providing information on how long it took the
ping to arrive. This time is then reported as a passive check result to an Icinga 2
instance.

## Icinga 2 configuration
In Icinga, create a check roughly mimicing the following:

```
object Service "matrix_roundtrip" {
    host_name = "matrix01.teckids.org"
    check_command = "passive"
    enable_active_checks = false
    enable_passive_checks = true
    enable_perfdata = true
}
```