icinga2-formula

A salt formula that installs and configures Icinga2. Based on the Icinga2 Puppet module by the Icinga2 team.

Available states

icinga2
icinga2.client
icinga2.features.api
icinga2.features.ido-pgsql
icinga2.features.debuglog
icinga2.features.graphite
icinga2.features.mainlog
icinga2.master
icinga2.web
icinga2.web.modules.audit
icinga2.web.modules.businessprocess

`icinga2`

Configure Icinga2 repository
Install Icinga2
Configure Icinga2 with a set of defaults
Manage Icinga2 service

`icinga2.client`

Installs Icinga2 as a client agent, creating client certificates against an Icinga2 master. Requires permissions for remote signing.

# Example client/agent configuration
icinga2:
  lookup:
    master_fqdn: icinga.example.com
    master_minion_id: icinga
    constants:
      PluginContribDir: /usr/local/lib/monitoring-plugins
    conf:
      zone:
        master:
          endpoints:
            - icinga.example.com
        ZoneName:
          endpoints:
            - NodeName
          parent: master
        # Enable the global-templates zone so that
        # commands are automatically synced
        global-templates:
          global: True
      endpoint:
        NodeName: {}
        icinga.example.com:
          host: icinga.example.com

`icinga2.features.api`

Enable and configure the api feature.

# Example ApiListener configuration.
icinga2:
  lookup:
    features:
      api:
        ca_path: /var/lib/icinga2/ca/ca.crt

`icinga2.features.ido-pgsql`

Enables and configures the ido-pgsql feature.

# Example IdoPgsqlConnection configuration
icinga2:
  lookup:
    features:
      ido-pgsql:
        host: localhost
        port: 5432
        name: icinga
        user: root
        password: password

`icinga2.features.debuglog`

Enable and configure the debuglog feature. Use the icinga2.features.debuglog.disabled state to disable the feature.

# Example FileLogger configuration
icinga2:
  lookup:
    features:
      debuglog:
        path: LogDir + "/debug.log"

`icinga2.features.graphite`

Enable and configure the graphite feature.

# Example GraphiteWriter configuration
icinga2:
  lookup:
    features:
      graphite:
        enable_send_thresholds: True
        enable_send_metadata: True

`icinga2.features.mainlog`

Enable and configure the mainlog feature.

# Example FileLogger configuration
icinga2:
  lookup:
    features:
      mainlog:
        severity: critical

`icinga2.master`

Installs and configures an Icinga2 master with a CA for generating client certs for Icinga2 agents. Requires permissions for remote signing.

# Example Icinga2 master configuration
icinga2:
  lookup:
    master_fqdn: icinga.example.com
    master_minion_id: icinga
    constants:
      TicketSalt: iamarandomstring
      PluginContribDir: /usr/local/lib/monitoring-plugins
    plugins:
      - itl
      - plugins
      - plugins-contrib

`icinga2.web`

Installs and configures Icingaweb2.

icinga2:
  lookup:
    web:
      user: www-data
      group: icingaweb2

      global:
        show_stacktraces: 1

      logging:
        log: syslog
        level: ERROR

      db:
        host: localhost
        port: 5432
        name: icingaweb2
        user: root
        password: password
        type: pgsql

`icinga2.web.modules.audit`

Enable the Icingaweb2 audit module.

`icinga2.web.modules.businessprocess`

Enable the Icingaweb2 businessprocess module.

# Extend the state to specify
# a particular version/tag
extend:
  icingaweb2_businessprocess_module_dir:
    git.latest:
      - rev: v2.1.0

Changes

2018-06-21

Pillar key for IDO features have changed to match the feature name:

ido_pgsql > ido-pgsql
ido_mysql > ido-mysql

hemebond / icinga2-formula