ConverterHQDevelopers
API v1

Observability

Requests, Jobs, Tasks, Usage und Webhooks in Produktion korrelieren.

Observability beginnt mit korrelierbaren IDs und durablem Zustand. Speichern Sie X-Request-ID und client_reference_id, um einen Benutzerfehler zur exakten Ausführung zurückzuverfolgen.

Request-Korrelation

Loggen Sie X-Request-ID, HTTP-Status, Endpoint, Dauer und project_id, aber niemals API-Secrets oder Dateiinhalt.

Job- und Task-Zustand

Beobachten Sie Queue-Latenz, Engine-Dauer, attempts, Fehlercodes und Erfolgsrate je Paar. Retries müssen sichtbar bleiben statt Historie zu überschreiben.

Event-Lieferung

Messen Sie Signature-Fehler, 2xx-Rate, Handler-Latenz, Retry-Backlog und Alter des letzten Events. Replay hilft nach einem Deployment-Fehler.

Nutzung und Kosten

Verfolgen Sie Calls, Credits, Bytes und Concurrency je Projekt. Kostenalarme sollten auf autoritativen kommerziellen Zählern statt lokalen Schätzungen basieren.