1. Guides
  2. Results and evidence
  3. Execution logs
Website
  • Overview
  • Quickstart
  • How RestoreTrust works
  • Requirements
  • Organizations and projects
  • Project workers
  • Test schedules
    • File checks
  • Validation gates
  • Time zones and dates
  • Manual runs
  • Notifications
  • Check results
  • Execution logs
  • Reports
  • Evidence and verification
  • Team and roles
  • API keys
  • Billing and plans

Execution logs

Use stage-specific check logs to diagnose file selection, download, restore, and probe failures safely.

Loading documentation…

Check results< PreviousReportsNext >

Powered by heyo

On this page

Available viewsDiagnose a failure

Check logs explain what the project worker observed while processing an artifact. Use them to diagnose a failure; do not treat them as standalone proof that restored data is correct.

Available views

Depending on the check type and how far it progressed, the check can show:

  • a full or merged execution view
  • download and file-handling output
  • database restore output
  • database service output
  • health-probe output

A log can be empty or incomplete if the check failed before that stage started, timed out, or could not report its final output.

Job log batches use a best-effort telemetry path. A busy or disconnected agent can drop log batches, so gaps in the displayed log do not by themselves mean a stage was skipped. Lifecycle and result events follow a separate durable handoff; use the check's status, timings, and probe results for the outcome. The worker detail page's Logs tab reads the currently connected agent's container log on demand and is not a historical archive.

Diagnose a failure

  1. 1

    Start with the status

    Use the terminal category—configuration, download/file, restore, probe, quota, infrastructure, timeout, or other—to choose the most relevant log.

  2. 2

    Check configuration facts

    Confirm the selected artifact, source, worker, database version, format and encryption settings, and referenced secret metadata. Correct a mismatch before retrying.

  3. 3

    Read the earliest relevant error

    Later messages are often consequences of the first failed stage. Compare the timestamp and stage with the check's general timing information.

  4. 4

    Correct and run manually

    Save the schedule or cluster change, then start a manual check. The old check remains an accurate record of the earlier attempt.

Common categories include:

  • File selection: no match, stale file, unexpected size, or inaccessible path
  • Download: DNS, network, source authorization, or incomplete transfer
  • Decode: declared container, compression, ZIP password, or age setting does not match the artifact
  • Restore: incompatible version, unsupported dump content, or insufficient resources
  • Probe: invalid query/operation, unavailable target, type mismatch, or unmet expected value
Keep secrets and sensitive rows out of logs

Do not place credentials in names, descriptions, paths, or probe text. Keep probes read-only and return only the value needed for comparison. Logs are diagnostic records that authorized project members may view.

Logs are supporting context. For a compact outcome record use Reports; for independently verifiable check data use Evidence and verification.