hubio-sync status

Show the status of migrations.

Synopsis

hubio-sync status [flags]

Description

The status command displays the current status of migrations, including:

  • Currently running migrations
  • Recent migration history
  • Success/failure statistics

Flags

FlagDescription
--jsonOutput in JSON format

Examples

Human-Readable Output

hubio-sync status

Output:

Migration Status
================

Active Migrations:
  [1] mysql-prod-to-s3-archive-20251203-143000
      Source: src_abc123 → Destination: dst_xyz789
      Status: InProgress (45.2%)
      Started: 2025-12-03 14:30:00

Recent Migrations:
  [1] postgres-backup (Completed)
      Duration: 5m 23s, Bytes: 1.2 GB
  [2] daily-sync (Failed)
      Duration: 2m 10s, Bytes: 512.4 MB
      Error: connection timeout

Summary:
  Running: 1, Completed: 5, Failed: 1

JSON Output

hubio-sync status --json

Output:

[
  {
    "id": "abc123-def456",
    "name": "mysql-prod-to-s3-archive-20251203-143000",
    "mode": "InitialMigration",
    "state": "InProgress",
    "source_id": "src_abc123",
    "destination_id": "dst_xyz789",
    "progress_percent": 45.2,
    "bytes_transferred": 1234567890,
    "files_transferred": 1234,
    "started_at": "2025-12-03T14:30:00Z"
  }
]

No Migrations

hubio-sync status

Output:

Migration Status
================

No migrations recorded.

To start a migration, run:
  hubio-sync migrate -s <source> -d <destination>

Migration States

StateDescription
PendingJob created but not yet started
InProgressCurrently running
PausedTemporarily paused, can be resumed
CompletedSuccessfully finished
FailedEncountered an error

Information Displayed

Active Migrations

For migrations currently running or paused:

  • Job name and ID
  • Source and destination IDs
  • Current state and progress percentage
  • File count (if available)
  • Start time

Recent Migrations

For completed or failed migrations:

  • Job name and final state
  • Duration and bytes transferred
  • Error message (if failed)

Summary

Aggregated counts of:

  • Running migrations
  • Completed migrations
  • Failed migrations

Data Storage

Migration status is stored in a local jobs file:

PlatformPath
macOS~/.local/share/hubio-sync/jobs.json
Linux~/.local/share/hubio-sync/jobs.json
Windows%LOCALAPPDATA%\hubio-sync\data\jobs.json

See Also