Integrations

KubeWatch integrations fall into two categories: monitoring integrations (databases and services you want to observe) and notification integrations (channels where alerts are delivered).

Monitoring integrations

Supported services

Adding a monitoring integration

1. Navigate to Integrations → Add Integration
2. Select the service type
3. Enter the connection string (e.g., postgresql://user:password@host:5432/dbname)
4. Click Test Connection to verify KubeWatch can reach the service
5. Click Save

The integration will appear in the Integrations list with a connection status indicator. Metrics begin appearing within one push interval (15 seconds by default).

Using integration metrics in alerts

Integration metrics follow the naming convention {integration_type}.{metric_name}, for example:

postgres.active_connections > 100 for 2m
redis.memory_used_percent > 85 for 5m
kafka.consumer_group_lag > 10000 for 10m

Create these as alert rules just like container metrics, go to Alerts → New Rule and type the metric name manually.

Connection string security

Connection strings are encrypted at rest using AES-256 and are never exposed in API responses or logs. You can rotate a connection string by editing the integration.

Notification integrations

Slack

1. Create an Incoming Webhook in your Slack workspace: api.slack.com/messaging/webhooks
2. Go to Integrations → Notifications → Add Slack
3. Paste the webhook URL
4. Optionally set a default channel override
5. Click Test to send a test message

Alert notifications include the rule name, current metric value, threshold, container/agent name, and a deep link to the dashboard.

PagerDuty

1. In PagerDuty, create a new integration on a service (Events API v2)
2. Copy the Integration Key
3. Go to Integrations → Notifications → Add PagerDuty
4. Paste the Integration Key
5. Click Test

KubeWatch creates a PagerDuty incident when an alert fires and resolves it automatically when the alert resolves.

Email

On the hosted SaaS plan, KubeWatch sends email via its own mail relay, no SMTP configuration needed. Just add recipient addresses.

On the self-hosted plan, configure your SMTP server:

1. Go to Integrations → Notifications → Add Email
2. Enter: SMTP host, port, username, password, TLS setting
3. Enter recipient addresses (comma-separated)
4. Click Test

Generic Webhook

Send alert payloads to any HTTP endpoint:

1. Go to Integrations → Notifications → Add Webhook
2. Enter the URL
3. Optionally add custom headers (e.g., Authorization: Bearer ...)
4. Click Test, KubeWatch sends a sample payload

Webhook payload format:

{
  "alert": {
    "id": "alert_abc123",
    "ruleName": "High CPU on prod-web",
    "state": "firing",
    "metric": "cpu_percent",
    "value": 94.2,
    "threshold": 90,
    "operator": ">",
    "firedAt": "2026-06-12T10:00:00Z"
  },
  "container": {
    "name": "web-app",
    "id": "container_xyz",
    "agentName": "prod-k8s"
  }
}