Receive Environment Status Alerts

Last modified: November 1, 2024

Introduction

You can receive alerts for Mendix application environments in two ways: via email or by using webhooks. You can find detailed information for both of these options below.

Alerts are triggered by any of the following circumstances:

  • The app goes offline unexpectedly
  • The application logs a message with level Critical
  • The health check fails
  • An infrastructure problem occurs

Email Alerts

You can select the Email Alerts checkbox on the Alerts page to set up email alerts for an environment. For this, you need an Application Operator, Business Engineer, or Scrum Master role. Or, if a Mendix Admin has defined a new team role for you, that role must have Cloud Access.

To enable email alerts, follow these steps:

  1. From Apps, open your app.

  2. Click Alerts in the navigation pane.

  3. Select the environment for which you want to set the alerts from the drop-down list at the top of the page. It is possible to set this option separately for each environment.

  4. Select the Email Alerts checkbox. Your changes will save automatically.

    The Email Alerts checkbox

Alerts Using Webhooks

As an alternative to alert emails, you can set a webhook to receive alerts.

Webhooks are set on the application level.

For details on webhooks, see the Webhooks page.

Setting Alerts Webhooks

To set a new webhook in the Mendix Portal, follow these steps:

  1. From Apps, open your app.
  2. In the navigation pane, click Webhooks.
  3. Click New Webhook.
  4. Name your webhook and provide the webhook receiver URL and Validation Secret as described in the Configuring a Webhook section of the Webhooks page.
  5. Choose Alerts from Available Events.
  6. Click Save.

After you set a new webhook, the receiver endpoint will start getting alerts when they are triggered.

Issue: Receiving Too Many Alerts

Under some circumstances, a critical alert in one instance of a multi-instance app can cause emails to be sent out constantly. The other instances of your app will continue to run without reporting issues, so it will appear to be working.

If you cannot resolve the issue in the instance reporting the critical error, you will need to restart your app to ensure that all instances are healthy. Otherwise, you will continue to receive regular email alerts.

Read More