Check infomaniak-events¶

Overview¶

Monitors the Infomaniak status page for open events and incidents. Alerts when active events are reported.

Important Notes:

Works with the Infomaniak API v2
The API call may take more than 10 seconds. The default timeout is 28 seconds.
Known service categories that can be filtered with --service:
- administration_console
- certificate
- cloud
- drive
- email_hosting
- hosting
- housing
- jelastic
- public_cloud
- radio
- swiss_backup
- web_hosting
- webmail
Links:
- API Documentation: https://developer.infomaniak.com/docs/api/get/2/events
- API Tokens: https://manager.infomaniak.com/v3/$ACCOUNT_ID/ng/accounts/token
- Infomaniak Status Page: https://infomaniakstatus.com/

Data Collection:

Queries the Infomaniak API for current events
Requires a Bearer Token with scope "event" from Infomaniak
Displays event type, title, services, start/end time, and duration in a table

Fact Sheet¶

Fact	Value
Check Plugin Download	https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/infomaniak-events
Nagios/Icinga Check Name	`check_infomaniak_events`
Check Interval Recommendation	Every minute
Can be called without parameters	No (`--token` is required)
Runs on	Cross-platform
Compiled for Windows	No

Help¶

usage: infomaniak-events [-h] [-V] [--always-ok] [--ignore-regex IGNORE_REGEX]
                         [--insecure] [--no-proxy] [--service SERVICE]
                         [--timeout TIMEOUT] --token TOKEN [--test TEST]

Monitors the Infomaniak status page for open events and incidents. Alerts when
active events are reported.

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --always-ok           Always returns OK.
  --ignore-regex IGNORE_REGEX
                        Any English event title matching this Python regex
                        will be ignored. Can be specified multiple times.
                        Example: `--ignore-regex "(?i)linuxfabrik"`.
  --insecure            This option explicitly allows insecure SSL
                        connections.
  --no-proxy            Do not use a proxy.
  --service SERVICE     Only report events for this service category. Can be
                        specified multiple times. If not specified, all
                        categories are reported. Example: `--service
                        swiss_backup --service public_cloud`.
  --timeout TIMEOUT     Network timeout in seconds. Default: 28 (seconds)
  --token TOKEN         Infomaniak API token.
  --test TEST           For unit tests. Needs "path-to-stdout-file,path-to-
                        stderr-file,expected-retc".

Usage Examples¶

./infomaniak-events --token=TOKEN --service=public_cloud --service=swiss_backup --ignore-regex='(?i)acronis'

Output:

information: Wave of fraudulent e-mails () - see https://infomaniakstatus.com/en/

Type        ! Title                            ! Services     ! Start               ! End                             ! Duration 
------------+----------------------------------+--------------+---------------------+---------------------------------+----------
impacting   ! Public Cloud: service disruption ! public_cloud ! 2023-05-10 19:30:15 ! 2023-05-10 20:12:02 (1M 3W ago) ! 41m 47s

States¶

OK if all events are in state "terminated".
WARN if an active event is reported (type is not "critical").
CRIT if an active event of type "critical" is reported.
UNKNOWN on invalid --ignore-regex patterns or invalid command-line arguments.
--always-ok suppresses all alerts and always returns OK.

Perfdata / Metrics¶

Name	Type	Description
event	Number	0 = no active event, 1 = at least one active event in progress.

Credits, License¶

Authors: Linuxfabrik GmbH, Zurich
License: The Unlicense, see LICENSE file.