ROLE ICINGA2_MASTER

This role configures icinga2 to act as a master. Furthermore, this role takes care of the configuration for all clients.

Requirements

When icinga2_master_ido_enabled is turned on the role tries to activate the IDO feature for icinga2. This needs a running database, either already existing or using the adfinis.mariadb role. Note: When using a multi-master setup, only one database must be used for both instances!

Role Variables

# The icinga2 master zone
icinga2_master_master_zone: monitoring-master

# A list of all icinga2 api users
icinga2_master_api_users: []
#  - username: root
#    password: 'passw0rd'
#    permissions: '*'
#  - username: token-generator
#    password: 'passw0rd'
#    permissions: 'actions/generate-ticket'

Templates can be adjusted using variables.

## Template settings

# If you have own templates for the configuration files in /etc/icinga2/conf.d
# consider adjusting the names here and add your template to
# templates/etc/icinga2/conf.d in the root of your playbook folder.
icinga2_master_template_confd_notifications: "notifications.conf"
icinga2_master_template_confd_templates: "templates.conf"
icinga2_master_template_confd_commands: "commands.conf"
icinga2_master_template_confd_groups: "groups.conf"
icinga2_master_template_confd_timeperiods: "timeperiods.conf"
icinga2_master_template_confd_users: "users.conf"

# These variables can be adjusted if you have custom templates for the global
# templates directory which gets synced to all clients.
icinga2_master_template_globaltemplates:
  - "services.conf"
  - "templates.conf"

# If the nagios plugin directory differs, you can also change it:
icinga2_master_nagios_plugin_dir: /usr/lib/nagios/plugins

If you want to use Twilio for the alerting, you can create an account. After that, you can receive an Application SID and Auth token from the twilio console. If you plan to make phone calls, please create a TwiML application.

## Twilio alerting

# The account sid from https://www.twilio.com/console
#icinga2_master_twilio_account_sid: 'account_sid'

# The auth token from https://www.twilio.com/console
#icinga2_master_twilio_auth_token: 'auth_token'

# Whether twilio sms are enabled or not
icinga2_master_twilio_sms_enabled: False

# The twilio phone numer used to send sms
#icinga2_master_twilio_sms_from: '+41123456789'

# Twilio SMS scripts additional commands
# Can be used to execute custom scripts after the SMS is sent
# defaults to an empty list, add command lines as necessary
# Example:
#icinga2_master_twilio_sms_additional_commands:
#  # Execute a custom script after the sms has been sent to also send
#  # the notification to mattermost
#  - "/etc/icinga2/scripts/mattermost.sh "${NOTIFICATION_MESSAGE}""
icinga2_master_twilio_sms_additional_commands: []

# Whether twilio calls are enabled or not
icinga2_master_twilio_phone_enabled: False

# The twilio phone number used to make calls
#icinga2_master_twilio_phone_from: '+41123456789'

# The twilio application on how to handle the call. You can either choose
# application sid or appication url. Choose only one. default is not defined.
# https://www.twilio.com/docs/voice/make-calls
#icinga2_master_twilio_phone_application_sid: 'application_sid'
#icinga2_master_twilio_phone_application_url: 'application_url'

Role Special Hostgroups

The following names will be used in the context of ansible group selectors and are evaluated inside of the role Their special meaning should be described in more depth (!!TODO!!).

• monitoring_client
• monitoring_master
• monitoring_sat

Dependencies

This role depends on the role adfinis.icinga2_agent, which installs the icinga2 binary.

Example Playbook

- hosts: monitoring-master
  roles:
     - { role: adfinis.icinga2_agent }
     - { role: adfinis.icinga2_master }

License

GPL-3.0

Author Information

icinga2_master role was written by:

• Adfinis AG | Website | Twitter | GitHub