Runtime Activity
Inspect the lifecycle after a runtime decision, including commits, releases, usage, and diagnostics.
Decision evidence explains why Valqio allowed or denied a request. Runtime Activity explains what happened after that decision entered the usage lifecycle.
Use Runtime Activity when you need to answer:
- Did the app consume usage, reserve value, commit, or release?
- Did a retry reuse the same request identity?
- Did a reservation settle or expire?
- Did a deny happen before product work ran?
- Does support have a trace that matches the app request?
- Does billing sync have enough evidence for a draft invoice line?
Common outcomes
| Outcome | Meaning | What to check next |
|---|---|---|
| Preview only | A non-consuming decision was evaluated. | Run app traffic when you need integration proof. |
| Blocked before work | Valqio denied the request before product work ran. | Confirm the reason code and customer-facing response. |
| Usage recorded | Runtime activity captured successful usage. | Compare quantity, subject, meter, and idempotency key. |
| Reservation committed | Reserved value was consumed after work succeeded. | Confirm the commit request identity and billing impact. |
| Reservation released | Reserved value was returned after work failed or was cancelled. | Confirm release reason and retry behavior. |
| Needs investigation | Activity or projection diagnostics need review. | Compare decision evidence, app logs, and billing-sync state. |
Support trace
For support or engineering investigations, collect non-secret identifiers:
- request ID
- idempotency key
- subject type and key
- product action or meter key
- reservation ID, when present
- reason code
Never include runtime API keys or provider secrets in support tickets.
Relationship to billing
Runtime Activity is upstream of billing sync. It should show the usage or settlement event that later appears in draft invoices and billing-provider exports, currently Stripe.
If a draft invoice line looks wrong, start with Runtime Activity, then compare the decision evidence, usage source context, and Stripe export state.