Skip to main content
RevoEngine provides several evidence surfaces because configuration changes, synchronous calls, background work, and AI activity answer different operational questions.

​
Start with the question

​
Correlation identifiers

Collect identifiers before opening a support case: The structured log field historically named jobId may carry an Endpoint Execution ID. In operator-facing workflows, interpret it as Execution ID unless you are viewing a durable Job record.

​
Activity and version history

Activity is snapshot-backed resource history. It supports:
  • resource-type inclusion and exclusion;
  • exact resource and creator filters;
  • term search;
  • absolute or relative time windows;
  • cursor pagination;
  • sanitized top-level diffs;
  • loading one full accessible historical version.
Use broad activity for recent workspace changes and exact resource history when investigating one object. Broad browsing defaults to a recent window; exact resource history can cover its complete retained timeline.
Activity is resource change evidence. It does not replace execution Trace or business-specific audit history such as Database row audit.

​
Logs

Open Security Admin → Logs for instance-wide structured logs. Filter early by time and identifiers, then narrow by service, severity, event name, account, or execution context. Good diagnostic filters are:
  1. a tight UTC time range;
  2. Operation ID or Execution ID;
  3. the Endpoint, Component, Job, Agent, or account identifier;
  4. warning and error severity;
  5. one lifecycle or event name.
Job details also provide job-scoped logs. Use these when the question starts with one Job ID; move to instance logs only when you need the surrounding dispatch or integration path.

​
Trace

Open Security Admin → Trace to follow an operation across service boundaries. Trace is most useful for:
  • matching ingress to downstream execution;
  • locating the slow or failing segment;
  • separating an authorization failure from a runtime failure;
  • distinguishing queue acceptance from actual processing;
  • correlating a webhook, event, job, or Agent dispatch.
Trace shows technical execution evidence. Resource Activity shows authored state changes. Use both when a changed definition caused a later runtime failure.

​
Endpoint statistics

Endpoint statistics summarize invocation volume and execution outcomes. Use them to locate a regression or traffic change, then open a representative Trace rather than drawing a root-cause conclusion from an aggregate alone. The statistics surface is cached briefly, so it is optimized for operational trends rather than an exact per-second ledger.

​
Job and event evidence

For background work, use this order:
For event-driven work, Event History shows resolved targets, concrete executions, and filter-skipped targets. Large messages are loaded only in the detail view. An accepted schedule, event, export, or refresh request means the work has been queued or started. Confirm a terminal state or finalized artifact before reporting success.

​
Database audit

Database row audit is a separate domain-specific ledger for Tables with audit enabled. It records insert, update, and delete snapshots from the enablement point onward, together with actor, row, operation, and time. Use the cross-Table Databases → Audit grid for investigation and the Table-specific audit route for one data source. Open one audit event to load complete before/after detail.

​
Instance Usage

Instance Usage combines current inventory and consumption signals, including:
  • accounts, groups, permissions, and API keys;
  • database, materialized-view, and audit storage;
  • file transfer and size;
  • Components, Endpoints, templates, schedules, events, webhooks, and processing time;
  • Secret counts;
  • Assistant token usage by period, model, account, and day.
Assistant analytics use one normalized UTC period. The lower bound is inclusive and the upper bound is exclusive. When no range is provided, the current UTC month through now is selected.

​
Sensitive data

Operational evidence is sanitized at platform boundaries, but application-authored logs can still expose data if you log it yourself.
Never record raw authorization headers, API keys, passwords, Secret values, signed Storage URLs, cookies, session credentials, or private runtime tokens.
When reporting a problem, share IDs, timestamps, sanitized status/error text, and reproduction steps. Replace tokens with variable names such as $REVO_API_KEY.

​
A practical investigation

When an asynchronous integration appears stuck:
  1. Capture UTC time, Job ID, and the initiating Event or Schedule ID.
  2. Check whether the Job is pending, processing, terminal, or part of a retry chain.
  3. Confirm the execution principal is active and still has required roles and ACL access.
  4. Inspect job logs for the first application error.
  5. Follow the Operation ID in Trace if dispatch or an external call is unclear.
  6. Inspect Event History to distinguish a filtered target from a failed execution.
  7. Verify any expected Storage artifact is finalized.
  8. Retry only after deciding whether previous external side effects may have completed.

​
Production checklist

  • Emit compact structured application logs.
  • Pass stable business correlation IDs through integrations.
  • Capture Operation ID, Execution ID, and durable object IDs.
  • Separate accepted, processing, and terminal states in your UI.
  • Set retention appropriate to your compliance needs.
  • Alert on terminal failures and retry exhaustion, not transient queue states alone.
  • Review Usage trends by UTC period and by execution principal.
  • Redact evidence before sharing it outside the instance.

Endpoints

Operate synchronous application APIs.

Automation

Understand Job, Event, Schedule, and Webhook evidence.

Databases

Enable and investigate row-level audit history.

AI and Agents

Inspect Assistant threads, Agent runs, approvals, and tool activity.
Last modified on September 5, 2026