Observability

:::info Source Sourced from services/marketplace-service/OBSERVABILITY.md in the documentation repo. :::

1. Logs

Events: marketplace.listing.submitted|approved|suspended, marketplace.order.placed|paid|fulfilled|failed|refunded, marketplace.license.granted|revoked|expired, marketplace.saga.step_completed|.failed, marketplace.review.posted|flagged, marketplace.coupon.applied|rejected.

Attrs: listing_id, order_id, license_id, saga_id, provider_tenant_id, buyer_tenant_id, amount_micro.

Redact: card tokens, addresses.

2. Metrics

RED

• marketplace_api_requests_total{endpoint,status} counter
• marketplace_api_duration_seconds{endpoint} histogram

Domain KPIs

• marketplace_orders_placed_total{currency} counter
• marketplace_gmv_micro_total{currency,plan_kind} counter (Gross Merchandise Value)
• marketplace_orders_fulfilled_total / ..._failed_total counters
• marketplace_licenses_granted_total, ..._revoked_total
• marketplace_refund_rate gauge (rolling 24h)
• marketplace_saga_duration_seconds{saga=purchase} histogram
• marketplace_saga_compensated_total{step} counter
• marketplace_conversion_rate{funnel=view_to_buy} gauge

USE

• marketplace_saga_open_count gauge
• marketplace_outbox_lag_seconds gauge

3. Traces

Spans: marketplace.order.place, marketplace.purchase_saga.step, marketplace.license.grant, marketplace.listing.submit|approve, marketplace.review.submit.

4. Dashboards

• GMV + revenue (per currency, per plan kind).
• Purchase saga health (step duration, compensation rate).
• Refund rate + reasons.
• Top listings by revenue + conversion.
• Provider onboarding funnel.

5. Alerts

Alert	Threshold	Severity
saga-failure-rate	> 2% for 15 min	P1
saga-timeout	any saga > 30 min	P1
order-failed-spike	> 10% in 5 min	P2
refund-rate-spike	> 5% daily	P2
license-grant-failure	> 0.5%	P2
payout-failed	any	P2
outbox-lag	> 30s p99	P2

6. SLOs

SLI	Target
Purchase saga success rate	≥ 99%
Order→license p95	< 5 min
API availability	99.95%
Listing approval SLA	< 24h (human review)

7. Business Metrics (for Finance)

• Daily GMV, net revenue, provider payouts.
• Cohort retention of buyers.
• Conversion by funnel stage.