summaryrefslogtreecommitdiffstats
path: root/doc/01-Introduction.md
blob: 6d767aec70e6a7ecf2a4d628957fe11d4638675d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
<a id="Introduction"></a>Introduction
=====================================

Welcome to the Icinga Director, the bleeding edge configuration tool for
Icinga 2! Developed as an Icinga Web 2 module it aims to be your new
favorite Icinga config deployment tool. Even if you prefer plain text
files and manual configuration, chances are good that the Director will
change your mind.

Director is here to make your life easier. As an Icinga 2 pro you know
all the knobs and tricks Icinga2 provides. However, you are not willing
to do the same work again and again. Someone wants to add a new server,
tweak some thresholds, adjust notifications? They shouldn't need to
bother you.

No way, you might think. You do not trust your users, they might break
things. Well... no. Not with the Director. It provides an audit log that
shows any single change. You can re-deploy old configurations at any time.
And you will be allowed to restrict what your users are allowed to do in
a very granular way.

Doing automation? Want to feed your monitoring from your configuration
management tool, or from your CMDB? You'll love the endless possibilities
Director provides.


Basic architecture
------------------

Icinga Director uses the Icinga 2 API to talk to your monitoring system.
It will help you to deploy your configuration, regardless of whether you
are using a single node Icinga installation or a distributed setup with
multiple masters and satellites.

    +------------+     +--------------+    +------------+
    | Sat 1 / EU |     | Sat 2 / Asia |    | Sat 3 / US |
    +------------+     +--------------+    +------------+
            \           /                    /
             \         /                    /
           +-------------+       +-------------+
           |  Master 1   | <===> |  Master 2   |  (Master-Zone)
           +-------------+       +-------------+
                 ^                       ^
                 |   Icinga 2 REST API   :
                 |                       :
               +----------------------------+
               |       Icinga Director      |
               +----------------------------+

Using the Icinga 2 Agent? Perfect, the Director will make your life much
easier!