ConverterHQDevelopers
API v1

Observability

Korelasikan request, Jobs, Tasks, usage, dan webhooks di produksi.

Observability dimulai dari ID yang dapat dikorelasikan dan state durable. Simpan X-Request-ID serta client_reference_id untuk menelusuri insiden ke eksekusi persis.

Korelasi request

Log X-Request-ID, HTTP status, endpoint, latency, dan project_id tanpa merekam API secret atau isi file.

State Jobs dan Tasks

Pantau queue latency, engine duration, attempts, error code, dan success rate per pair. Retry harus tetap terlihat, bukan menimpa histori.

Delivery event

Ukur signature failure, 2xx rate, handler latency, retry backlog, dan usia event terakhir. Gunakan replay setelah insiden diperbaiki.

Usage dan biaya

Pantau calls, credits, bytes, dan concurrency per project. Alert biaya harus menggunakan counter komersial otoritatif, bukan estimasi lokal.