checkId: check.notify.webhook.configured plugin: stellaops.doctor.notify severity: warn tags: [notify, webhook, quick, configuration]

Webhook Configuration

This Stella Ops Doctor diagnostic confirms that the generic (custom) webhook notification channel is configured correctly before Doctor attempts delivery. It validates local configuration only and performs no network I/O, so it runs in air-gapped deployments; reachability is covered separately by check.notify.webhook.connectivity.

What It Checks

Verifies that the generic webhook notification channel is properly configured. The check reads Notify:Channels:Webhook and validates:

URL (Url or Endpoint): must be set and be a valid HTTP or HTTPS URL.
Enabled flag (Enabled): if explicitly false, reports a warning.
Also reads Method (defaults to POST) and ContentType (defaults to application/json) for evidence.

The check only runs when the Notify:Channels:Webhook configuration section exists.

Why It Matters

Generic webhooks integrate Stella Ops notifications with third-party systems (PagerDuty, OpsGenie, custom dashboards, SIEM tools). A missing or malformed URL prevents these integrations from receiving events.

Common Causes

Webhook URL not set in configuration
Malformed URL (missing protocol http:// or https://)
Invalid characters in URL
Webhook channel explicitly disabled

How to Fix

Docker Compose

environment:
  Notify__Channels__Webhook__Url: "https://your-endpoint/webhook"
  Notify__Channels__Webhook__Method: "POST"
  Notify__Channels__Webhook__ContentType: "application/json"

Security note: Webhook URLs frequently embed bearer tokens or signing secrets. Inject them via Docker secrets or a vault rather than committing them to compose files or environment manifests.

Bare Metal / systemd

{
  "Notify": {
    "Channels": {
      "Webhook": {
        "Url": "https://your-endpoint/webhook",
        "Method": "POST",
        "ContentType": "application/json"
      }
    }
  }
}

Kubernetes / Helm

notify:
  channels:
    webhook:
      url: "https://your-endpoint/webhook"
      method: "POST"

Verification

stella doctor run --check check.notify.webhook.configured

check.notify.webhook.connectivity — tests whether the webhook endpoint is reachable
check.notify.queue.health — verifies the notification delivery queue is healthy