Notifications Setup: Icinga as a Source

Icinga Web Modules
1

Hi everyone,

I’m trying to use Icinga’s notifications module to send webhooks to Teams when a host is down for longer than a specified time. I’m relatively new to APIs, so I apologize if this is a basic question.

I’ve followed the documentation to enable the API and create my credentials. However, I’m unsure which URL endpoint to use when adding Icinga as a source. Currently, I’ve configured it as follows:

  • Name: Icinga
  • Type: Icinga
  • API URL: https://localhost:5665/v1
  • API Username: [redacted]
  • API Password: [redacted]
  • Verify API Certificate: disabled

Will this setup allow the notifications module to receive host state data and use the configured channel, or is a more specific endpoint needed?

Thanks!

  • Icinga Web 2 version 2.12.1
  • Modlues: doc 2.12.1, icingadb 1.1.3, notifications 0.1.0
  • Icinga 2 version: r2.14.2-1
  • PHP version: 8.3.6
  • Ubuntu 24.04.1 LTS, Kernel version: 6.8.0-51-generic
2

Thanks for trying Icinga Notifications and posting your question.

For adding an “Icinga” Source to Notifications, the base URL of the Icinga 2 API server is required, in your case this should be https://localhost:5665.
More information is available in the Notification Web documentation section about Icinga 2 as a Source, including links to the Icinga 2 documentation about the required ApiUser.

There are also a few blog posts about Icinga Notifications you may wanna read in addition to the docs, starting with https://icinga.com/blog/getting-started-with-icinga-notifications/.

One last unrelated thing: you provided “r2.14.2-1” as your Icinga 2 version. Unless the “-1” is another patch backport, I would urge you to upgrade to 2.14.3 as it closed a critical security issue.

3

Thank you, I appreciate all the linked resources!

This server is still in an isolated development environment, but I will definitely be upgrading to 2.14.3 at my earliest convenience.