Validation & monitoring

Monitoring, metrics, and SLOs (Service Level Objectives)

Metrics to monitor

MetricHow to MeasureAlert Threshold
Success rateHTTP 200 responses / total requestsAlert if < 95% over 1 hour
CDS sync lagTime since last successful CDS syncAlert if > 36 hours
Ingestion completenessProperties ingested vs eligibleAlert if < 98% coverage
Response latencyTrack p50, p95, p99Alert if p95 > 10 seconds

Recommended health checks

Run the following checks periodically (e.g., hourly) to verify integration health.

  • Authentication check — Make a lightweight Reference Data API call (e.g., entity=continent) and verify HTTP 200 response.
  • Content freshness check — Select 5 random properties, fetch via Properties API, and compare key fields against your data store.
  • Reference data consistency — Verify your stored reference data counts match the totalCount values from the API.

SLOs

The following are indicative targets. Refer to your partner agreement for contractual SLAs.

MetricTarget
API availability99.9% uptime
Response latency (Properties API)p95 < 2.5 seconds
Response latency (Reference Data API)p95 < 2 seconds
Data freshnessContent reflects the source of truth within 24 hours

Did this page help you?