Skip to content

Security

The monitoring module provides an additional set of restrictions and permissions that can be used for access control. The following sections will list those restrictions and permissions in detail:

Permissions

The monitoring module allows to send commands to an Icinga 2 instance. A user needs specific permissions to be able to send those commands when using the monitoring module.

Name Permits
monitoring/command/* Allow all commands.
monitoring/command/schedule-check Allow scheduling host and service checks.
monitoring/command/schedule-check/active-only Allow scheduling host and service checks. (Only on objects with active checks enabled)
monitoring/command/acknowledge-problem Allow acknowledging host and service problems.
monitoring/command/remove-acknowledgement Allow removing problem acknowledgements.
monitoring/command/comment/* Allow adding and deleting host and service comments.
monitoring/command/comment/add Allow commenting on hosts and services.
monitoring/command/comment/delete Allow deleting host and service comments.
monitoring/command/downtime/* Allow scheduling and deleting host and service downtimes.
monitoring/command/downtime/schedule Allow scheduling host and service downtimes.
monitoring/command/downtime/delete Allow deleting host and service downtimes.
monitoring/command/process-check-result Allow processing host and service check results.
monitoring/command/feature/instance Allow processing commands for toggling features on an instance-wide basis.
monitoring/command/feature/object/* Allow processing commands for toggling features on host and service objects.
monitoring/command/feature/object/active-checks Allow processing commands for toggling active checks on host and service objects.
monitoring/command/feature/object/passive-checks Allow processing commands for toggling passive checks on host and service objects.
monitoring/command/feature/object/notifications Allow processing commands for toggling notifications on host and service objects.
monitoring/command/feature/object/event-handler Allow processing commands for toggling event handlers on host and service objects.
monitoring/command/feature/object/flap-detection Allow processing commands for toggling flap detection on host and service objects.
monitoring/command/send-custom-notification Allow sending custom notifications for hosts and services.

Restrictions

The monitoring module allows filtering objects:

Keys Restricts
monitoring/filter/objects Applies a filter to all hosts and services.

This filter will affect all hosts and services. Furthermore, it will also affect all related objects, like notifications, downtimes and events. If a service is hidden, all notifications, downtimes on that service will be hidden too.

Filter Column Names

The following filter column names are available in filter expressions:

Column Description
instance_name Filter on an Icinga 2 instance.
host_name Filter on host object names.
hostgroup_name Filter on hostgroup object names.
service_description Filter on service object names.
servicegroup_name Filter on servicegroup object names.
all custom variables prefixed with _host_ or _service_ Filter on specified custom variables.