checkId: check.notify.delivery.test plugin: stellaops.doctor.notify severity: warn tags: [notify, delivery, queue, health]

Notification Delivery Health

This Doctor check is the setup-wizard compatibility check for Notify delivery posture. It validates the local delivery configuration around queue transport, retry policy, throttling, digest behavior, and default channel selection.

What It Checks

The check reads Notify delivery settings and reports:

It does not send a test message. Queue runtime health is covered by check.notify.queue.health, and endpoint reachability is covered by the channel connectivity checks.

Why It Matters

Notifications can be configured but still unreliable if delivery retries are disabled, throttling is too aggressive, or the queue transport silently falls back to in-memory processing. This check catches those operator-facing configuration risks before production alerts depend on them.

Common Causes

How to Fix

Docker Compose

environment:
  Notify__Queue__Transport: "Redis"
  Notify__Queue__Redis__ConnectionString: "redis:6379"
  Notify__Delivery__MaxRetries: "3"
  Notify__Throttle__Enabled: "true"
  Notify__Throttle__Limit: "100"

Bare Metal / systemd

{
  "Notify": {
    "Queue": {
      "Transport": "Redis",
      "Redis": {
        "ConnectionString": "127.0.0.1:6379"
      }
    },
    "Delivery": {
      "MaxRetries": 3
    }
  }
}

Kubernetes / Helm

notify:
  queue:
    transport: redis
    redis:
      existingSecret: stellaops-notify-redis
  delivery:
    maxRetries: 3

Verification

stella doctor run --check check.notify.delivery.test