Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add typed methods for Load Balancing Analytics Events and Pool Health endpoints

Aperta
#2,693 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
58/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
python

Direzione di ricerca

Inizia dagli endpoint REST documentati e dai punti di ingresso del client load_balancers.analytics.events.list e load_balancers.pools.health.get, quindi confronta le risorse tipizzate dell'SDK nelle vicinanze. Il lavoro è completato quando entrambi gli endpoint sono disponibili tramite metodi tipizzati ed espongono i campi documentati relativi agli eventi e allo stato di salute per origine, invece di richiedere with_raw_response.get().

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

kind: enhancement

Feature Request

The Python SDK is missing typed methods for two Load Balancing endpoints that are documented in the Cloudflare REST API:

1. Load Balancing Analytics Events

REST endpoint: GET /accounts/{account_id}/load_balancing_analytics/events

Returns per-origin health state change events with timestamps, pool health status, failure reasons, and response codes. This is critical for monitoring when individual origins go unhealthy.

Current workaround:

resp = client.with_raw_response.get(
    f"/accounts/{account_id}/load_balancing_analytics/events",
    cast_to=object,
    options={"params": {"per_page": 200, "page": 1, "since": "...", "until": "..."}}
)
data = resp.json()

Desired:

events = client.load_balancers.analytics.events.list(
    account_id=account_id,
    since="2026-03-18T00:00:00Z",
    until="2026-03-18T23:59:59Z",
)
2. Pool Health Details

REST endpoint: GET /accounts/{account_id}/load_balancers/pools/{pool_id}/health

Returns per-PoP, per-origin health status including response codes, RTT, and failure reasons. Useful for diagnosing which specific origins are failing and from which regions.

Current workaround:

resp = client.with_raw_response.get(
    f"/accounts/{account_id}/load_balancers/pools/{pool_id}/health",
    cast_to=object,
)
data = resp.json()

Desired:

health = client.load_balancers.pools.health.get(
    pool_id=pool_id,
    account_id=account_id,
)
Use Case

We built an origin health monitor that detects when individual load balancer origins are unhealthy while the pool remains healthy (silent degradation / lost redundancy). Both endpoints are essential for this use case and are documented in the Cloudflare API docs, but require falling back to raw HTTP via with_raw_response.get().

References
Lingua principale
Python
Stelle
509
Fork
150
Merge medio
3h 15m
PR unite (30g)
1

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di cloudflare/cloudflare-python

Tutte le issue di cloudflare/cloudflare-python

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.