Skip to main content

Let Profundis servers notify you

You can specify your Teams, Discord, etc webhook or SMTP infos directly in the Profundis web UI and let us notify you automatically when an event/host matching your alerts parameters has been discoverered.

warning

If you are worried about having your webhooks URLs or SMTP credentials stored in our database, you can use the Profundis alerting Docker image. This Docker image is also recommended if you want to split your notifications between different alert providers (e.g. be notified of an alert about xyz.com through Teams, but receive the rest of the notifications by email).

Configuration​

The configuration is pretty straightforward.

  • Log in and navigate on the Profundis alerting page.
  • Click on the alert settings button (wheel icon).
  • Select the notification type: Discord, Teams, etc (limited to 1 max).
  • Specify the required infos (e.g. the webhook URL).
  • Save.

Test your alerts​

You can check if your alerts really match by providing test data in the Test Playground interface. In this example we suppose you have an alert which is supposed to match all the subdomains of domain.com.

  • Navigate on the alerting page if you are not already there.
  • Click on the Test Playground button.
  • Click on Add test field -> Use host and specify sub.domain.com as value.
  • Click on the Send Test button.
  • You should have received an alert through the notification method you configured.

Troubleshooting​

I don't receive alerts​

  • Check that you have configured a notification method in the alert page -> settings button (wheel icon).
  • Check that your alert is correct. Check it on regex101.

Some of my alerts are missing​

We buffer your alerts and automatically retry to deliver them if the notification provider (e.g. Teams, Discord, etc) applies rate limit or refuses the connection. If the notification provider keeps refusing the messages (e.g. because your Profundis alert matches 400 items per hour but you deliver the notification via a SMTP which only accepts 100 sent emails per hour) the Profundis alerts will end up being dropped and you will never receive them. In this case, we recommend you use the Profundis alerting Docker image which has huge buffers and should be able to handle the messages spikes.