Grafana

Fluidify Regen supports Grafana Unified Alerting (Grafana v9+). Grafana uses a webhook format similar to Prometheus Alertmanager with some additional fields.

Webhook URL

POST https://your-domain.com/api/v1/webhooks/grafana

Grafana configuration

In Grafana, go to Alerting → Contact points
Click Add contact point
Set Name to Fluidify Regen
Set Integration to Webhook
Set URL to your webhook URL
Click Test to send a test alert
Click Save contact point

Then add it to a notification policy:

Go to Alerting → Notification policies
Edit the default policy or add a new one
Set Default contact point to Fluidify Regen

How alert fields map to Regen

Grafana field	Regen field	Notes
`alerts[].labels.alertname`	Title	—
`alerts[].annotations.summary`	Description	Falls back to `annotations.description`
`alerts[].labels.severity`	Severity	`critical`, `warning`, `info`
`alerts[].status`	Status	`firing` or `resolved`
`alerts[].fingerprint`	ExternalID	Used for deduplication
`alerts[].values`	Annotations	Query results stored (e.g. `{"A": 95.2}`)

Example payload

{
  "receiver": "fluidify-regen",
  "status": "firing",
  "alerts": [
    {
      "status": "firing",
      "labels": {
        "alertname": "HighCPUUsage",
        "severity": "warning",
        "grafana_folder": "Infrastructure"
      },
      "annotations": {
        "summary": "CPU usage above 85% on web-01"
      },
      "startsAt": "2024-01-15T10:30:00Z",
      "endsAt": "0001-01-01T00:00:00Z",
      "generatorURL": "https://grafana.yourcompany.com/alerting/...",
      "fingerprint": "abc123def456",
      "values": {
        "cpu_usage": 87.3
      },
      "valueString": "[ var='A' labels={instance='web-01'} value=87.3 ]"
    }
  ],
  "groupLabels": { "alertname": "HighCPUUsage" },
  "commonLabels": { "severity": "warning" },
  "commonAnnotations": {},
  "externalURL": "https://grafana.yourcompany.com"
}

Legacy Grafana alerting (v8 and below)

Grafana v8 and below use a different payload format. Use the Generic webhook source instead:

POST https://your-domain.com/api/v1/webhooks/generic

See Generic webhook for the schema.