Getting Started

What is Distributed Metrics?

Distributed Metrics is Bitping’s monitoring platform. Unlike traditional uptime services that check from a handful of datacenters, Bitping runs checks from real residential and mobile devices around the world. This gives you an accurate picture of how your endpoints perform for actual users, not just synthetic probes.

Every check generates Prometheus-compatible metrics that are stored, graphed, and alertable directly in the Bitping dashboard.

Supported Protocols

Protocol What it monitors Key metrics
HTTP Websites, APIs, webhooks Success rate, P95 response time, status codes
DNS Domain resolution Success rate, P95 lookup time, record validation
ICMP Ping/reachability Success rate, P95 latency, packet loss
HLS Live video streams Buffer health, P95 total duration, TTFB

Key Features

  • Global coverage – Checks run from real nodes in 190+ countries
  • Geographic filtering – Target checks to specific countries, continents, ISPs, or network types (residential, mobile, proxy)
  • Interactive dashboards – Time-series graphs, multi-country comparisons, and world heat maps
  • Threshold alerting – Set limits on any graph and get notified via email or webhook
  • YAML or form config – Edit your monitoring setup with a visual form or raw YAML
  • PromQL native – All queries use standard Prometheus Query Language

Getting Started

  1. Navigate to Metrics in the sidebar
  2. The setup wizard walks you through selecting protocols and adding endpoints
  3. Once created, your instance begins provisioning and starts collecting data within seconds
  4. View your dashboards, configure alerts, and refine your monitoring from the metrics pages

Dashboard Views

Each protocol dashboard includes three sections:

  • Overview – Aggregated success rate and performance across all endpoints
  • By Country – Compare how your endpoints perform across different regions
  • Geographic Distribution – Interactive world map with color-coded performance data

Use the time range selector (1h, 6h, 24h, 7d, 14d) and endpoint/country filters to drill into the data that matters.

Instance Lifecycle

Your metrics instance goes through the following phases:

Phase Meaning
Provisioning Setting up infrastructure for your instance
Running Actively collecting metrics
Disabled Paused (by you, payment, or admin)
Failed Configuration or infrastructure error

You can stop and restart your instance at any time from the config page without losing historical data.