Add public bounded flush API

Aperta
#145 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
elixir
Ambito
backend

Direzione di ricerca

Inizia leggendo l’implementazione di PostHog.Sender e la specifica flush referenziata di sdk-specs per comprendere il comportamento della coda e il contratto richiesto. Definisci l’API pubblica PostHog.flush, il suo comportamento con le istanze denominate e i timeout, quindi aggiungi test e documentazione che mostrino code vuote, attese limitate, consegna immediata e comunicazione dello stato.

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

Descrizione

enhancement

Summary

Add a public bounded flush API.

Why

sdk-specs marks flush as applicable to both client and server SDKs. Backend users need deterministic delivery before process/request boundaries, tests, scripts, and serverless exits.

Current status

PostHog.Sender flushes on batch size, timer, and GenServer termination, but there is no public flush API. Python has a related issue about adding a max timeout to flush: https://github.com/PostHog/posthog-python/issues/79.

Suggested scope

  • Add a public PostHog.flush/1 or PostHog.flush/2 accepting a named instance and timeout.
  • Flush all sender queues immediately without waiting for threshold/timer.
  • Return safely when queues are empty.
  • Bound the wait with a timeout and return/report status rather than blocking indefinitely.
  • Preserve retryable failed events for future retry once retry queue support exists.
  • Add tests and docs.

References

Lingua principale
Elixir
Stelle
66
Fork
33
Merge medio
1g 22h
PR unite (30g)
21

Preparare l'ambiente

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 PostHog/posthog-elixir

Tutte le issue di PostHog/posthog-elixir

Issue simili

Altre issue su Elixir

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.