Home / Docs

Documentation

How DiffMon works across monitoring, alerts, security, and API integration.

Alerts and notifications

Email alerts with request IDs, throttling, and options for muted channels.

Alerts and notifications

DiffMon sends concise alerts with the context you need to triage changes quickly.

Email alerts

  • Include request ID, status code, latency, and a link to the diff.
  • Sent to the monitor owner or the first available org owner if none is set.
  • Respect mute windows so you can pause noisy monitors during maintenance.

Webhooks

Pair alerts with webhooks for automation. Webhooks include the same request metadata for correlation.

Policy-driven routing and suppression

Use Policy rules to control notification behavior after diffs are computed:

  • suppress known low-value noise
  • route high-impact changes to additional destinations
  • escalate severity labels for downstream incident tooling

Delivery safeguards

  • Global/domain rate limits prevent alert storms.
  • Retry with jitter on transient failures.
  • Alerts stop when monitors are paused or deleted.
TypeScript
await dispatchNotification(monitor.id, {
  type: 'diff.detected',
  payload: diff,
  createdAt: new Date(),
});

Best practices

  • Keep alerts pointed at a shared inbox or ticket queue.
  • Add ignore rules before muting; it keeps true positives flowing.
  • Use the audit log to verify who muted or unmuted alerting.