Seiri Architecture

Seiri is a lightweight, real-time monitoring platform for webhooks, cron jobs, and background tasks.
It provides visibility, reliability, and alerting for your automated workflows with minimal setup — no projects or environments required.

Tip: All workflows are unified under webhooks. When creating a new webhook, select its type: Immediate, Scheduled, or Periodic.

---

Core Components

Seiri’s architecture can be broken down into the following components:

1. Event Source

• Webhook: Any HTTP request sent to your Seiri endpoint.
• Scheduled Job / Cron: Any task that posts execution status or heartbeat.
• All incoming requests are treated as events.

2. Seiri Receiver

• Handles incoming events reliably.
• Validates payloads and records metadata (headers, timestamps, status codes).
• Ensures no events are lost and supports multiple webhook types.

3. Event Logging

• Chronologically logs every event.
• Stores headers, timestamps, and delivery status.
• Serves as the foundation for retries, insights, and alerts.

4. Retry Queue

• Automatically retries failed events with exponential backoff.
• Supports manual replay for debugging or recovery.
• Guarantees delivery reliability without overloading your endpoints.

5. Alerting System

• Detects failed, delayed, or anomalous events.

• Sends notifications via multiple channels:

  • Email
  • Slack
  • Discord
  • Microsoft Teams
  • Telegram
  • Ntfy
  • Webhook callbacks

• Configurable thresholds reduce noise while ensuring critical issues are reported.

6. Analytics & Insights

• Aggregates metrics such as:

  • Success / failure rates
  • Latency
  • Delivery patterns
  • Event trends
  • Geographic distribution

• Provides a dashboard for visual inspection and decision-making.

Track performance, errors, retries, and delivery latency

Tip: Use the Insights dashboard to identify recurring errors and performance bottlenecks.

---

Seiri Event Flow

Below is a high-level flow diagram showing how events move through Seiri: