Welcome to CloudLine
Discord bot monitoring — what we measure, how to set it up, and where to look when something goes wrong.
CloudLine watches your Discord bot. It tells you whether the bot is alive, how fast it responds to slash commands, what errors it's throwing, and whether its host (CPU / RAM / event loop) is healthy. You paste a few lines of code into your bot, set up a webhook for alerts, and the dashboard fills with real telemetry within seconds.
This site is the operator's reference. The dashboard's own Heartbeat tab gives you a copy-paste install snippet for any language; what's here goes deeper into what the numbers mean and how to react when something turns red.
NOTE
New to CloudLine? Start with the Quick start below — the SDK and your first heartbeat take under five minutes.
Start here
Quick start
Install the SDK and see your first heartbeat in under five minutes.
Glossary
Uptime, heartbeat, incident, SEV1 — every dashboard term, in plain language.
Configure your alerts
Alert thresholds
When to be paged — for offline, latency, CPU, memory, errors, and gateway zombies.
Alert channels
Discord webhook and email — how to set each one up, and what the alert looks like.
Heartbeat secret
What the clb_live_… token is, how to rotate it, and how it's stored.
Already running? Go deeper
How monitoring works
The heartbeat flow, the alarm tick, where data lives.
Metrics explained
Every Telemetry tile — what it measures, what "normal" looks like, when to worry.
Reliability tiers
Excellent / Good / At-risk / Critical — what they mean, how they're computed.
Need to fix something?
No data showing
The bot is up but the dashboard says "—".
Slow slash commands
1000 ms+ p50 — where to look, what to fix.
Zombie state
Process is alive, gateway is dead. The most-asked incident.
SDK reference
Node.js / discord.js
@cloudline/bot-sdk on npm — install, options, manual mode.
Python / discord.py
cloudline-bot on PyPI — same surface, Pythonic naming.
Raw HTTP
For Go, Rust, Java, C#, PHP, Ruby — the heartbeat protocol by hand.
Custom metrics
monitor.gauge() / counter() — your own numbers next to the built-ins.
TIP
Use the sidebar or Cmd/Ctrl + K search to jump to any page. Every page links back here at the top.