Notifications

Configure notifications to be alerted when important events occur in your application environments.

Overview

Quave Cloud can send notifications for various deployment and scaling events. You can configure which events trigger notifications and choose between email and Slack notifications.

Configuring Notifications

Access notification settings from the Notifications tab in your account settings.

Available Channels

• Email: Receive notifications via email
• Slack: Send notifications to a Slack channel (requires webhook URL configuration)

Notification Settings Types

The following events can trigger notifications. Events marked as Enabled by Default are automatically enabled for new environments.

Build Events

Event	Description	Enabled by Default
Building	Docker image is being built	No
Waiting for image	Waiting for Docker image to be available	No
Build failed	Build process failed (compilation, Dockerfile errors)	Yes
Image in waiting failed to build	Docker image build failed	Yes
Built	Build completed, ready to deploy	No
Image in waiting is ready	Image is ready for deployment	No

Deploy Events

Event	Description	Enabled by Default
Deploying	Containers are being deployed	No
Deploy failed to complete	Deployment timed out or failed health checks	Yes
Deploy failed to start	Containers failed to start	Yes
Deployed	Code deployment completed successfully	No

Scaling Events

Event	Description	Enabled by Default
Scaling	Container count is being adjusted	No
Scaled	Scaling operation completed successfully (containers adjusted)	No

Lifecycle Events

Event	Description	Enabled by Default
Build canceled	Build was manually canceled	Yes
Canceled due to new deploy	Canceled because a new deployment was triggered	No
Stopping	Containers are being stopped	No
Stopped	Environment stopped gracefully after successful operation	Yes
Restarts	Notification when containers restart unexpectedly (first restart, then at most once every 3 hours)	Yes

Container Restart Notifications

Quave Cloud monitors your containers for unexpected restarts and notifies you when they occur. This helps you quickly identify and address issues like crashes, out-of-memory errors, or application bugs.

When You Get Notified

To prevent notification fatigue, restart notifications follow a rate-limited schedule:

• First restart: You are notified immediately when a container first restarts
• Subsequent restarts: You will receive at most one notification every 3 hours if restarts continue

This means you will receive a maximum of approximately 8 restart notifications per day per container, even if the container is in a crash loop.

What the Notification Contains

Each restart notification includes:

• Container name: Which container or replica restarted
• Restart count: Total number of restarts recorded
• Exit code: The error code that caused the restart
• Error message: Details about why the container terminated (when available)
• Version: The application version that was running

Common Exit Codes

Exit Code	Meaning	Typical Cause
137	OOMKilled	Container exceeded memory limit
1	Error	Application crashed or threw an unhandled exception
143	SIGTERM	Container received termination signal

For a complete list of error codes, see our Troubleshooting guide.

Disabling Restart Notifications

If you prefer not to receive restart notifications, you can disable them:

1. Go to Account then Notifications or App Env then Notifications
2. Find Restarts on the list
3. Toggle off Email and/or Slack notifications as desired

Best Practices

1. Enable failure notifications - At minimum, enable notifications for build and deploy failures to catch issues early
2. Configure Slack for team visibility - Use Slack channels to keep your entire team informed of deployment events
3. Customize per environment - Consider different notification settings for production vs staging environments
4. Use dedicated channels - Create dedicated Slack channels for different apps or environments to reduce noise
5. Keep restart notifications enabled - Container restarts often indicate issues that need attention, even if the container auto-recovers

Slack Integration

To configure Slack notifications:

1. Create a Slack webhook URL in your Slack workspace
2. Go to the Notifications tab in your account settings
3. Enable Slack notifications for desired events
4. Enter the webhook URL for the Slack channel

tip

You can configure different Slack channels for different events or environments to better organize your notifications.