dephealth 0.5.0

SDK for monitoring microservice dependencies via Prometheus metrics

dephealth

SDK for monitoring microservice dependencies via Prometheus metrics.

Features

• Automatic health checking for dependencies (PostgreSQL, MySQL, Redis, RabbitMQ, Kafka, HTTP, gRPC, TCP)
• Prometheus metrics export: app_dependency_health (Gauge 0/1), app_dependency_latency_seconds (Histogram), app_dependency_status (enum), app_dependency_status_detail (info)
• Async architecture built on asyncio
• FastAPI integration (middleware, lifespan, endpoints)
• Connection pool support (preferred) and standalone checks

Installation

# Basic installation
pip install dephealth

# With specific checkers
pip install dephealth[postgres,redis]

# All checkers + FastAPI
pip install dephealth[all]

Quick Start

Standalone

from dephealth import DepHealth

dh = DepHealth()
dh.add("postgres", url="postgresql://user:pass@localhost:5432/mydb")
dh.add("redis", url="redis://localhost:6379")

await dh.start()
# Metrics are available via prometheus_client
await dh.stop()

FastAPI

from fastapi import FastAPI
from dephealth_fastapi import DepHealthFastAPI

app = FastAPI()
dh = DepHealthFastAPI(app)
dh.add("postgres", url="postgresql://user:pass@localhost:5432/mydb")

Health Details

details = dh.health_details()
for key, ep in details.items():
    print(f"{key}: healthy={ep.healthy} status={ep.status} "
          f"latency={ep.latency_millis():.1f}ms")

Configuration

Parameter	Default	Description
interval	15	Check interval (seconds)
timeout	5	Check timeout (seconds)

Supported Dependencies

Type	Extra	URL Format
PostgreSQL	postgres	postgresql://user:pass@host:5432/db
MySQL	mysql	mysql://user:pass@host:3306/db
Redis	redis	redis://host:6379
RabbitMQ	amqp	amqp://user:pass@host:5672/vhost
Kafka	kafka	kafka://host1:9092,host2:9092
HTTP	—	http://host:8080/health
gRPC	grpc	host:50051 (via FromParams)
TCP	—	tcp://host:port

Authentication

HTTP and gRPC checkers support Bearer token, Basic Auth, and custom headers/metadata:

http_check("secure-api",
    url="http://api.svc:8080",
    critical=True,
    bearer_token="eyJhbG...",
)

grpc_check("grpc-backend",
    host="backend.svc",
    port=9090,
    critical=True,
    bearer_token="eyJhbG...",
)

See quickstart guide for all options.

License

Apache License 2.0 — see LICENSE.