icingaweb2/modules/monitoring/doc/04-Backends.md
Michael Friedrich 34bd8e14c3 Enhance the documentation and fix outdated information (preferences, etc.)
This applies a new structure for the main doc/ and modules/*/doc tree with

01-About.md
02-Installation.md
...

This allows us to link from the main doc directory into module specific
documentation entries.

Furthermore table formatting, examples, and missing settings have been added
where applicable.

This patch also takes care about proper URL anchors and file names and directories.

fixes #2950
2017-09-29 11:01:37 +02:00

31 lines
1.2 KiB
Markdown

# Backends <a id="monitoring-module-backends"></a>
The configuration file `backends.ini` contains information about data sources which are
used to fetch monitoring objects presented to the user.
The required [resources](../../../doc/04-Resources.md#resources-configuration-database) must be globally defined beforehand.
## Configuration <a id="monitoring-module-backends-configuration"></a>
Navigate into `Configuration` -> `Modules` -> `Monitoring` -> `Backends`.
You can select a specified global resource here, and also update its details.
Each section in `backends.ini` references a resource. By default you should only have one backend enabled.
### IDO Backend <a id="monitoring-module-backends-ido"></a>
Option | Description
-------------------------|-----------------------------------------------
type | **Required.** Specify the backend type. Must be set to `ido`.
resource | **Required.** Specify a defined [resource](../../../doc/04-Resources.md#resources-configuration-database) name which provides details about the IDO database resource.
Example for using the database resource `icinga2_ido_mysql`:
```
[icinga2_ido_mysql]
type = "ido"
resource = "icinga2_ido_mysql"
```