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 start

Configuration Reference

FlagDefaultDescription
--interval30sTime between health checks
--retries2Consecutive failures before alerting
--timeout10sPer-request deadline
--methodHEADHTTP 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.