BackupAlly Documentação 880e6e8

backupally history

Mostra o histórico de backups executados, lido de /var/lib/backupally/logs (desde a 0.25.0; ver Configuração Global para a migração dos diretórios que antes ficavam em /tmp).

Sintaxe 

backupally history [OPÇÕES]

Opções

Opção Descrição Padrão
-l, --limit <N> Número de backups a mostrar 10
-t, --target <NOME> Filtrar por nome de task (substring, no nome sanitizado) -
--task <ID> Filtrar por id de task, match exato (desde 0.35.0) -
-s, --show <ID> Mostrar detalhes de um backup específico -
--full Mostrar log completo (com --show) false
--log-dir <DIR> Diretório de logs /var/lib/backupally/logs
-o, --format <FORMAT> human, json, yaml human

history não tem -c/--config — sempre lê o diretório de logs padrão (ou --log-dir), independente de qual config.toml gerou o backup.

`--target` vs `--task`

  • --target é substring no nome da task sanitizado (ex.: Prova_fase_1) — mysql casa com mysql-prod e mysql-staging;
  • --task (desde 0.35.0) é match exato no task_id — backup-1 não casa com backup-10. Use quando precisar do histórico de uma task específica sem risco de pegar outra com nome parecido.
backupally history --task mysql-prod -o json --limit 20

Saída 

BACKUP ID                       TARGET       STARTED              STATUS      SIZE
mysql-prod_20260919_030000      mysql-prod   2026-09-19 03:00:00  completed   15.2 MB
mysql-prod_20260918_030000      mysql-prod   2026-09-18 03:00:00  completed   14.9 MB

`-o json`

history.list, data.items[]:

Campo Tipo Semântica
backup_id string id da run: <nome sanitizado>_<AAAAMMDD_HHMMSS>, na hora local do servidor
task_id string | null id da task. null em log anterior à 0.35.0
target string nome da task sanitizado, não o id
started_at string RFC 3339 UTC início real — use este campo para hora, não o backup_id
status string completed | partial | failed | inprogress
duration_secs float
total_size_bytes int tamanho da origem empacotada
compressed_size_bytes int após compressão
uploaded_size_bytes int enviado ao(s) storage(s)
storages_uploaded int
targets_processed / targets_failed int
errors string[] mensagens de erro, se houver
log_file string caminho do log no servidor
artifacts[] objeto[] um item por (storage, banco) gravado com sucesso — [] em log anterior à 0.35.0

`artifacts[]` (desde 0.35.0)

Campo Tipo Nota
storage_id string id do [[storage]] que recebeu o artefato
driver string local | b2 | s3
key string só o nome do arquivo. Mantido por compatibilidade: baixa quando o diretório/prefixo do storage não tem variável
remote_path string | null a chave completa, como foi gravada, a partir da raiz do storage (b2/s3: a chave no bucket com o prefixo expandido; local: relativo à parte fixa do path, tudo antes do primeiro ${...}). É o que `storage download` e `restore --from-storage` usam para achar o arquivo em qualquer layout. null em log anterior à 0.35.0 e em storage local com raiz relativa ou / — ver limitações de segurança
sha256 string | null SHA-256 (hex minúsculo) do arquivo enviado. Usado para conferir integridade no download/restore. null em log anterior à 0.35.0
size_bytes int
database string | null só em backup por banco 
backupally history -o json --task mysql-prod --limit 1 | jq '.data.items[0].artifacts'
[
  {
    "storage_id": "b2-prod",
    "driver": "b2",
    "key": "mysql-prod_20260919_030000.ally",
    "remote_path": "mysql-prod/mysql-prod_20260919_030000.ally",
    "sha256": "a1b2c3d4e5f6...",
    "size_bytes": 15890432,
    "database": null
  }
]

Status

  • inprogress: a run está rodando — o log é gravado no meio do pipeline e regravado no fim. inprogress muito depois de started_at costuma indicar que o processo morreu;
  • partial: o backup existe e é utilizável, mas algum item falhou;
  • completed/failed: como o nome diz.

Compatibilidade

Log anterior à 0.35.0 não tem task_id nem artifacts — os campos saem null/[], e ferramentas que já leem history continuam funcionando sem mudança. Ver `--capabilities` para descobrir, sem depender de versão, se o binário instalado já grava esses campos (history.task_id, history.artifacts, history.artifacts.remote_path, history.artifacts.sha256).

Ver também

By Borlot.com.br on 25/09/2026

Tags

cli history histórico auditoria