Documentation
Monitoring Layer

Alert Protocols

Logship allows you to configure proactive monitors that track your telemetry stream in real-time. When specific thresholds are reached, we dispatch high-fidelity JSON payloads to your designated endpoints.

Core Concepts

Every alert rule is defined by four primary vectors:

Environment

Target specific deployment tiers like Production or Staging.

Level Filter

Monitor specific event severities. Trigger on CRITICAL errors while ignoring debug noise.

Threshold

Define the volume of events required to trigger the protocol (e.g., 50 errors in 5 minutes).

Webhook Sink

The destination URL where we'll dispatch the secure incident notification payload.

Payload Architecture

When a rule triggers, Logship sends a POST request with a JSON body following this structure:

application/json
{
  "event": "alert.triggered",
  "rule": {
    "id": "rule_98b50e2ddc",
    "name": "Production Error Spike"
  },
  "metrics": {
    "count": 124,
    "window_minutes": 5,
    "level": "error"
  },
  "timestamp": "2024-05-12T14:30:00Z"
}

Start Monitoring Now

Navigate to your dashboard and initialize your first monitor in under 60 seconds. No complex configuration required.

Open Alerts Dashboard