Operations: observability

export async function emitToBricqs(/* ... */) {
  const start = Date.now();
  try {
    const res = await fetch(/* ... */);
    const body = await res.json();

    log.info({
      event: "bricqs.event.posted",
      participant_id,
      event_type,
      idempotency_key,
      status: res.status,
      duplicate: body.duplicate,
      latency_ms: Date.now() - start,
    });

    return body;
  } catch (err) {
    log.error({
      event: "bricqs.event.failed",
      participant_id,
      event_type,
      idempotency_key,
      error: err instanceof Error ? err.message : String(err),
      latency_ms: Date.now() - start,
    });
    throw err;
  }
}

1. Bricqs 5xx error rate
   Threshold: > 1% of POST /events for 5 consecutive minutes.
   Action: page on-call. Check Bricqs status; pause non-critical event sources.

2. Webhook delivery failures
   Threshold: 3+ failed deliveries to your endpoint in 10 minutes.
   Action: page on-call for your webhook handler. The most common cause is a
   timeout on your side; check downstream dependencies (CRM, ESP).

3. Rules-engine evaluation latency
   Threshold: p95 > 5s for 10 minutes.
   Action: review recently-launched challenges. A misconfigured count evaluator
   on a high-volume event can saturate the engine. Pause and reconfigure.