Skip to main content

​
Overview

Alert channels define how XIMP delivers notifications when alert rules fire. Channels must be configured before creating alert rules that reference them. This page covers creating and testing all supported channel types, and configuring escalation policies for critical alerts.
Administrator Access Required — This operation requires the admin role. Contact your Xloud administrator if you do not have sufficient permissions.
SMTP email alerts and webhook notifications can be configured directly in XDeploy:

Open Configuration

Navigate to XDeploy → Configuration and select the Monitoring tab.

Configure alert channels

Scroll to the Alert Configuration section and set the notification channels:
SettingDescription
SMTP ServerMail server hostname and port
SMTP From AddressSender email address for alert notifications
SMTP RecipientsComma-separated recipient email addresses
SMTP TLS ModeTLS encryption mode (STARTTLS or SSL)
Webhook URLEndpoint URL for Slack, Microsoft Teams, or custom webhooks

Test the channels

Use the Test Email and Test Webhook buttons to verify delivery before saving. This sends a test notification to confirm connectivity and credentials.
Always test channels immediately after configuration. Discovering a broken channel during a real incident delays response significantly.

Save and deploy

Click Save Configuration, then navigate to XDeploy → Operations and run a Reconfigure for the monitoring services.
Alert channels are configured and tested.
Prerequisites
  • Administrator credentials with the admin role
  • SMTP, webhook, PagerDuty, or Slack credentials depending on the channel type

​
Creating Alert Channels

Navigate to Alert Channels

Navigate to Monitoring → Alerting → Channels → Add Channel.

Configure the channel

Select the channel type and complete the required fields:
Channel TypeRequired Fields
EmailSMTP server, port, from address, recipient list, TLS mode
WebhookURL, HTTP method, optional Authorization header
PagerDutyIntegration key (from PagerDuty service), severity mapping
SlackIncoming webhook URL, target channel name
TeamsIncoming webhook URL

Test the channel

Click Test after saving to send a test notification. Verify delivery before assigning the channel to production alert rules.
Use the Test button immediately after creating a channel. Discovering a broken channel during a real incident delays response significantly.

​
Escalation Policies

Configure multi-tier escalation for critical infrastructure alerts:

Navigate to Escalation Policies

Navigate to Monitoring → Alerting → Escalation Policies → New Policy.

Define escalation tiers

TierTriggerChannelDelay
Tier 1Alert firesPagerDuty on-callImmediate
Tier 2Not acknowledgedSlack ops channel5 minutes
Tier 3Still unacknowledgedPage on-call manager15 minutes
Escalation policies only apply to alert rules with the policy assigned. Verify every critical alert rule has an escalation policy — a rule without one stops at Tier 1 and never escalates.

Assign to alert rules

Open the target alert rule and set the Escalation Policy field. The policy applies to all future alert events for that rule.
Alert rule references the escalation policy. Future alert events will escalate per the configured tiers.

​
Channel Configuration Reference

Email channel configuration
name: ops-email
type: email
smtp:
  server: smtp.example.com
  port: 587
  username: ximp@example.com
  password: <SMTP_PASSWORD>
  tls: starttls
from: ximp@example.com
recipients:
  - ops-team@example.com
  - oncall@example.com
PagerDuty channel configuration
name: pagerduty-oncall
type: pagerduty
integration_key: <PAGERDUTY_INTEGRATION_KEY>
severity_mapping:
  critical: critical
  warning: warning
  info: info
Generate the integration key in PagerDuty under Services → Integrations → Add Integration → Events API v2.
Slack channel configuration
name: slack-ops
type: slack
webhook_url: https://hooks.slack.com/services/T.../B.../...
channel: "#ops-alerts"
username: "XIMP Alerts"
icon_emoji: ":alert:"
Generate the webhook URL in Slack under Apps → Incoming Webhooks → Add to Slack.

​
Next Steps

Metrics & Alerts (User Guide)

How users create alert rules that reference these channels

Alert Rules (Advanced)

Silence rules, inhibition, and escalation policy usage

Security

Dashboard access control and credential management

Troubleshooting

Diagnose channel delivery failures and SMTP connectivity issues