Inspect executions and evidence for a known monitor.
Practical procedure
- Read /pulse/monitors/{monitor_id}/occurrences to obtain its history.
- Open an individual occurrence using /pulse/occurrences/{occurrence_id}.
- Inspect state and materialized evidence before describing a change or a successful observation.
Define an evidence-backed Pulse monitor
Pulse monitors track an objective against selected Knowledge sources. A definition records cadence, timezone, source policy, materiality rule and notification mode. Review and approve the exact definition version before running it. An occurrence records a particular run; it is distinct from the monitor definition and from any resulting email delivery.
Contract example
Developer examples below describe routes on an authorized, configured GoCux control-plane base URL. They are request shapes or operation references, not claims that a particular public hostname exposes the API. Use the workspace for the corresponding human workflow; availability and permissions depend on the actual deployment.
Operation reference for this workflow
GET /pulse/monitors/{monitor_id}/occurrences
GET /pulse/occurrences/{occurrence_id}Inspect the result
Inspect occurrence state and available evidence before reporting a change. A new or missing source passage can change the support for a value even when the displayed value is unchanged. Notification mode can be none or email; choosing email is not evidence that delivery is configured or that a message reached its recipient.
What to keep explicit
Occurrence history is not an external monitor-events API with interchangeable event types. Preserve GoCux occurrence identities and evidence semantics. A notification failure is distinct from a failed comparison or an unchanged source.
Handle incomplete and refused work
Creation requires at least one unique Knowledge source identifier. Decisions and transitions use explicit version checks and Idempotency-Key. A stale definition or a monitor that is not active can return 409. A 503 is unavailable monitor storage or materialization, not a statement that nothing changed. Pause or archive intentionally when the monitoring objective ends.
Continue with related guides
Bu iş akışını çalışma alanınıza taşıyın.
Kapsamı belirleyin. Kanıtları inceleyin. Gereken adımları onaylayın.