Chokidar
Documentation

Get started with Chokidar

Everything you need to deploy, configure, and scale your monitoring infrastructure.

Quick Start

Get up and running with Chokidar in under 5 minutes.

Steps

  1. 1Create your account and organization
  2. 2Add your first site and configure the hierarchy
  3. 3Deploy an agent or create a network check
  4. 4View results on the dashboard within one interval
example
curl -X POST https://api.chokidar.bd/v1/sites \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"name":"production","region":"us-east-1"}'

Services

Chokidar supports a wide range of check types out of the box.

HTTP/S
Status codes, response time, body matching, SSL validation
TCP
Port connectivity with custom timeout and retry logic
Ping
ICMP echo requests with packet loss and latency metrics
SSL
Certificate expiry, chain validation, TLS version
SSH
Remote command execution and output validation
SNMP
OID walks, traps, and custom MIB polling
Prometheus
Scrape endpoints and evaluate PromQL expressions

Agents

Lightweight agents for host and service monitoring.

Installation
Guided install flow and token-based enrollment
Enrollment
Token-based enrollment with automatic site assignment
Streaming
Persistent agent connection with automatic reconnect behavior
Transport security
TLS in transit; additional hardening options are planned
Metrics
CPU, memory, disk, network, and process collection
example
# Install the agent
curl -sSL https://get.chokidar.bd | bash

# Enroll with your token
chokidar-agent enroll --token $TOKEN --server api.chokidar.bd:443

Alerts

Expression-based alerting with intelligent batching.

Expression Engine
Flee-based rules with variables: status, latency, value, error
Channels
Email, Webhook, Telegram, WhatsApp, Ntfy, and Gotify
Batching
30-second sliding window per (channel, recipient, severity)
Escalation
Auto-escalate critical alerts after configurable delays
example
{
  "name": "High Latency Alert",
  "expression": "latency > 1000",
  "severity": "warning",
  "channels": ["email", "telegram"],
  "cooldown": 300
}

Storage & Retention

Time-series data optimized for monitoring workloads.

Columnar Analytics
High-performance time-series storage optimized for monitoring workloads
Compression
Segment-wise compression for historical data
Retention
Configurable per-organization retention policies
Aggregates
Continuous aggregates for fast historical queries

Security

Enterprise-grade security built into every layer.

Multi-Tenancy
Row-level isolation with query filters
Authentication
Email/password login and OIDC support (feature-flagged)
OIDC SSO
Soon (Pro) — planned for managed plan rollout
OTel Ingestion & Log Analytics
Soon (Pro) — ingestion and analytics UI are planned
Audit Logs
Immutable audit trail for all operations
Encryption
AES-GCM for credentials at rest

Ready to dive deeper?

Explore the API reference or start building with our SDKs.

View launch roadmapTalk to engineering