Integrations

Connect Relay to your existing tools for alerting, monitoring, and automation.

Available Integrations

Setting Up an Integration

1. Go to Organization Settings → Integrations
2. Click Add Integration and choose the type
3. Configure the connection details
4. Select which events to forward
5. Enable and save

Slack Integration

Connect to a Slack workspace via an incoming webhook URL.

Configuration:

• webhook_url — Your Slack incoming webhook URL
• channel — Override the default channel (optional)

Events are formatted with:

• Severity emoji (rotating light, warning, info)
• Bold severity label
• Contextual fields as attachments

PagerDuty Integration

Create PagerDuty incidents automatically from Relay anomaly alerts.

Configuration:

• integration_key — Your PagerDuty Events API v2 integration key

Severity mapping:

• Critical → PagerDuty critical
• High → PagerDuty error
• Medium → PagerDuty warning
• Low → PagerDuty info

Datadog Integration

Forward events and metrics to Datadog for unified monitoring.

Configuration:

• api_key — Your Datadog API key
• app_key — Your Datadog application key (optional)

Events appear as Datadog events with:

• source_type_name: relay-cloud
• Tags: service:relay-cloud, severity:{level}

Custom Webhook Integration

Forward events to any HTTP endpoint. Payloads are HMAC-SHA256 signed.

Configuration:

• url — Your endpoint URL
• secret — Used to sign payloads

Payload:

{
  "message": "Anomaly detected: connections spike",
  "severity": "high",
  "context": {
    "app": "my-app",
    "metric": "connections",
    "value": 5420
  },
  "timestamp": 1712300000
}

Verify with:

X-Relay-Signature: hmac_sha256(json_body, secret)

SIEM Integration

Export audit logs to security information and event management systems:

Configure in Organization Settings → SIEM Integration.

Notification Preferences

Each team member can configure their own notification routing:

• Email — Default for all alerts
• Slack — Real-time channel notifications
• PagerDuty — On-call escalation
• SMS — Emergency notifications via Twilio

Filter by severity: only receive critical and high alerts, for example.

Configure in Profile → Notification Preferences.