Back to Docs
Recipe
Uptime Monitoring
Configure Meridian to ping your endpoints on a schedule and alert your team when services go down. Combine with Discord webhooks for instant notifications.
Overview
Meridian sends HTTP HEAD requests to your targets at configurable intervals. If a target fails to respond with a 2xx status code after a specified number of retries, Meridian fires an alert through your connected notification channels.
Quick Start
# 1. Add a monitor
meridian monitor add \
--name "API Gateway" \
--url https://api.example.com/health \
--interval 60s \
--retries 3
# 2. Attach a Discord alert
meridian alert add \
--monitor "API Gateway" \
--type discord \
--webhook https://discord.com/api/webhooks/...
# 3. Start the agent
meridian agent startConfiguration Reference
| Flag | Default | Description |
|---|---|---|
| --interval | 30s | Time between health checks |
| --retries | 2 | Consecutive failures before alerting |
| --timeout | 10s | Per-request deadline |
| --method | HEAD | HTTP method for the check |
Alert Channels
Meridian supports Discord, Slack, and email alerts out of the box. Each monitor can have multiple channels attached. Alerts include the target URL, failure count, and a timestamp so your team can triage immediately.
Pro tip: Pair uptime monitoring with Meridian's status page recipe to give your users real-time visibility into service health.