Operate
Usage limits
Usage limits are FlowRelay plan controls, not traffic-shaping or spike-protection features.
Current plan meters #
FlowRelay tracks capacity for accepted events and governed operational work. The embedded Plan page and Agent Operations plan-usage response expose exact enforced meters so humans and authorized agents can self-throttle before work pauses.
| Meter | What it controls |
|---|---|
| Accepted events | Inbound events accepted by FlowRelay for processing during the plan period. |
| Diagnostics shares | Private, support-safe diagnostics bundles created for support, a partner, or an authorized agent. |
| Replay executions | Intentional reruns of retained events. Replay can repeat downstream actions. |
| Simple agent reads | Compact setup, grant, plan, billing-handoff, and recent-result reads. |
| Rich agent reads | Heavier event, endpoint, diagnostics, reliability, or history reads. |
| Action intents | Preview or proposal records for governed actions before anything changes. |
| Executed actions | Confirmed governed actions such as replay, diagnostics-share creation, endpoint tests, endpoint changes, or secret rotation. |
Common cases #
Use the action being taken, not the screen or actor, to predict which meters move.
| Case | Meters that move | Why |
|---|---|---|
| An authorized agent checks whether the store is installed, the grant is valid, usage is healthy, or the latest handoff succeeded. | Simple agent reads | FlowRelay is returning compact status so the agent can decide whether deeper investigation is needed. |
| A human or agent opens a failed event, endpoint snapshot, diagnostics preview, or event-history view to understand what happened. | Rich agent reads | FlowRelay is returning detailed operational context, not just a summary. |
| An agent prepares a replay, diagnostics share, endpoint test, endpoint change, or secret rotation for human approval. | Action intents | The proposal is recorded and auditable, but nothing has changed yet. |
| The merchant approves replaying one retained event. | Replay executions and executed actions | FlowRelay reruns the event, which can repeat downstream actions, and records the governed execution. |
| The merchant or authorized agent creates a redacted diagnostics share for support or a partner. | Diagnostics shares and executed actions | FlowRelay creates a private support bundle and records the governed execution. |
| The merchant approves an endpoint test, endpoint change, or secret rotation. | Executed actions | FlowRelay performs a governed operation. Replay and diagnostics-share meters move only when that operation also creates a replay or share. |
What usage limits do not control #
Usage limits are plan controls. They do not create configurable retry schedules, custom rate limits, endpoint-level throttling, user-managed queue buffering, automatic spike protection, or general webhook traffic management.
Recovery visibility at limits #
Diagnostics shares and replay executions are operator tools, not coverage percentages. Existing event history, receipts, error context, and recovery guidance stay visible when a limit is reached. The operator can upgrade, wait for the next period, or reduce limit-consuming work.
Operating guidance
Apply the concept through the receipt before changing setup, resending, or replaying.
- 01Open Plan or Home in FlowRelay to check accepted event, diagnostics share, replay, agent read, action-intent, and executed-action meters.
- 02Treat warning states as a capacity planning signal before production senders hit the limit.
- 03If the accepted-event cap is reached, new limit-consuming intake can be blocked while existing receipts, diagnostics, replay history, and recovery guidance remain readable.
- 04If governed operation caps are reached, reduce unnecessary agent reads or upgrade before asking an agent to continue high-volume work.
- 05Use plan meters for capacity planning. Usage limits do not provide configurable traffic shaping, endpoint throttling, or spike buffering.
FlowRelay