Overview
Every backup, restore, sync, and verification action in Ironcore Backup Solution runs as a tracked task with a unique identifier (UPID). Tasks expose live progress, structured logs, exit status, and final transferred bytes. As a project member you monitor tasks for your project; administrators see tasks across the whole platform. This page covers the Task Browser, common monitoring queries, and how to interpret the dashboards.Prerequisites
- An active Polystack account with project membership
- At least one backup, restore, or verification job has executed
Dashboard Overview
The Backup Solution > Dashboard page is the primary monitoring view.Datastore Usage
Used bytes, deduplication ratio, free space, and projected fill date based
on recent growth.
Running Tasks
All active backup, restore, sync, and verify operations with progress
indicators that auto-refresh every 5 seconds.
Job Calendar
Upcoming and past scheduled jobs visualised in a calendar. Click any cell to
open the matching task log.
Recent Failures
The five most recent failures across all task types, with one-click access
to logs and remediation tips.
Task Browser
The Tasks page lists every operation with filterable columns.| Column | Description |
|---|---|
| Time | Start timestamp |
| End | Completion timestamp or running |
| User | User or API token that triggered the task |
| Type | backup, restore, sync, verify, gc, prune, tape |
| Source / Target | Workload, datastore, or remote site |
| Status | OK, FAILED, WARNING, running |
| Bytes | Bytes transferred or processed |
| UPID | Unique task ID for log retrieval |
- Dashboard
- CLI
Filter the view
Filter by Type, Status, Time range, or User. Combine
filters to drill down — for example, show all failed sync tasks in the
last 24 hours.
Open a task
Click the task row to open the detail panel. The panel shows
per-stage progress, transferred bytes, errors, and the streaming log.
Task States
| State | Meaning |
|---|---|
queued | Waiting for a worker slot |
running | Actively executing |
ok | Completed without errors |
warning | Completed but with non-fatal issues (for example, a skipped exclude path) |
failed | Errored out |
cancelled | Stopped by operator before completion |
Verification Reports
Verification jobs produce structured reports per snapshot.| Result | Meaning |
|---|---|
| OK | Every chunk matched its SHA-256 fingerprint |
| CORRUPT | At least one chunk failed the SHA-256 check — manifest references unreadable data |
| MISSING | A referenced chunk is absent from the datastore |
| STALE | The snapshot is past the configured keep-verified window and is due for re-verification |
- Dashboard
- CLI
Open a snapshot in Snapshots. The Verification tab shows the last
result, the verifier (which job), and the duration. Click Verify now to
trigger a one-shot pass.
Bandwidth and Throughput
The Statistics panel exposes per-job and per-datastore throughput.| Metric | Description |
|---|---|
| Effective transfer rate | Bytes per second of actual chunk transfer to the datastore |
| Source read rate | Bytes per second read from the workload |
| Deduplication hit rate | Percentage of chunks already present in the datastore |
| Compression ratio | Average post-Zstandard size against raw size |
| Pre-encrypt size vs. on-disk size | Combined effect of deduplication and compression |
Email and Webhook Notifications
Project-scoped notification groups can be attached to backup jobs. Successful runs, warnings, and failures dispatch to the notification group as defined by your administrator. The same events surface in the in-Dashboard notification inbox. For per-event control, see Notifications.Troubleshooting
Task appears stuck in `queued`
Task appears stuck in `queued`
A worker slot is unavailable, or the scheduler is paused. Check Backup
Solution > Workers for queue depth and worker health. Contact your
administrator if no workers are online.
Task ended `WARNING` — what does that mean?
Task ended `WARNING` — what does that mean?
Non-fatal issues such as a skipped exclude path, a missing optional source,
or partial deduplication failure. The task log lists each warning with the
affected path.
Per-snapshot verification has stayed `STALE` for weeks
Per-snapshot verification has stayed `STALE` for weeks
The platform-wide verification job is not running. Contact your
administrator to start a verification schedule.
Bandwidth dropped suddenly
Bandwidth dropped suddenly
A bandwidth limit may have been applied to the sync job or the datastore.
Confirm with your administrator. If unintentional, raise or remove the
limit.
Next Steps
Troubleshooting
Resolve failed backups and restores
Notifications
Configure email and webhook delivery channels (administrator)
Verification and Validation
Schedule integrity verification and recovery drills
Backup Jobs
Set up scheduled jobs for recurring protection