Prometheus Integration

Overview

OpsWorker integrates with Prometheus via AlertManager webhooks. When Prometheus alerts fire, AlertManager sends them to OpsWorker for automatic investigation.

Setup

1. Get Your Webhook URL

In the OpsWorker portal, go to Integrations → select your cluster → Alert Manager. Copy the webhook URL.

2. Configure AlertManager

Add OpsWorker as a webhook receiver in alertmanager.yml:

receivers:
  - name: opsworker
    webhook_configs:
      - url: 'https://alerts.opsworker.ai/webhook/YOUR_CLUSTER_TOKEN'
        send_resolved: true

route:
  receiver: default
  routes:
    - receiver: opsworker
      continue: true  # Also send to other receivers

3. For Prometheus Operator (kube-prometheus-stack)

apiVersion: monitoring.coreos.com/v1alpha1
kind: AlertmanagerConfig
metadata:
  name: opsworker
  namespace: monitoring
spec:
  receivers:
    - name: opsworker
      webhookConfigs:
        - url: 'https://alerts.opsworker.ai/webhook/YOUR_CLUSTER_TOKEN'
          sendResolved: true
  route:
    receiver: opsworker

4. Verify

Trigger a test alert or check the OpsWorker portal for incoming signals.

What OpsWorker Receives

Field	Source
Alert name	alertname label
Severity	severity label
Namespace	namespace label
Pod	pod label
Description	description annotation
Summary	summary annotation
All labels	Preserved for rule matching

Tips

• Use continue: true to send alerts to both OpsWorker and your existing receivers
• OpsWorker handles alert grouping independently; no need to adjust AlertManager's group_by
• Works with Prometheus 2.x+ and all AlertManager versions

Next Steps

• Prometheus AlertManager Setup Guide — Detailed step-by-step
• Configure Alert Rules — Control which alerts get investigated