Health notifications

Magento Commerce Cloud monitors disk space usage on all applications and services in your Starter environment or your Pro Integration environment. A database disk that runs out of space could cause data corruption. The health status check occurs every 5 minutes and can notify you by email or other external service. There are three low-disk warnings for health notifications:

  • Warning—available disk space drops below 20%
  • Critical—available disk space drops below 10%
  • All-clear—available disk space returns above 20%, after a low-disk event

Email notifications

The health email integration requires an origination address and at least one recipient address. You can use the same email address for the from-address and the recipients address. The following example registers a health email integration with two recipients.

To register health notifications for email:

magento-cloud integration:add --type health.email --from-address you@example.com --recipients them@example.com --recipients others@example.com

Slack channel notifications

Slack is an external service that uses interactive apps called bots to post messages in a chat room. Before you can receive health notifications in Slack, you must create a new, custom bot user for your Slack group. After you configure the bot user for your channel, or channels, save the bot token provided by Slack to register your integration.

To register health notifications in a Slack channel:

magento-cloud integration:add --type health.slack --token SLACK_BOT_TOKEN --channel '#slack-channel-name'

PagerDuty notifications

PagerDuty is an external service that can notify on-call team members of important issues. Before you can receive health notifications in PagerDuty, you must create a PagerDuty integration that uses the Events API version 2. Use the Integration Key, or routing key, to register your integration.

To register health notifications for PagerDuty:

magento-cloud integration:add --type health.pagerduty --routing-key PAGERDUTY_ROUTING_KEY