跳到主要内容

Provider Health Monitoring

Monitor the health and performance of your API providers in real-time.

Overview

  • Automatic health checks for all providers
  • Latency and error rate tracking
  • Rate limit detection
  • Real-time status dashboard

Configuration

{
"health_check": {
"enabled": true,
"interval_secs": 60,
"timeout_secs": 10
}
}

Health Status

Each provider can have one of these statuses:

StatusDescription
healthyProvider is responding normally
degradedHigh latency or occasional errors
unhealthyProvider is down or rate limited
unknownNo recent health data

Metrics Tracked

  • Latency: Average response time (ms)
  • Error Rate: Percentage of failed requests
  • Rate Limit: Whether provider is rate limiting
  • Uptime: Availability over time

Web UI

The Providers page shows real-time health indicators:

  • 🟢 Green: Healthy
  • 🟡 Yellow: Degraded
  • 🔴 Red: Unhealthy

API Endpoints

EndpointMethodDescription
/api/v1/health/providersGETGet all provider health status
/api/v1/health/providers/{name}GETGet specific provider health

Smart Failover

When a provider becomes unhealthy, GoZen automatically:

  1. Detects the failure
  2. Routes requests to the next healthy provider
  3. Continues monitoring the failed provider
  4. Resumes using it when it recovers