# backupally measure

Cruza o tamanho na origem com o histórico de backups (desde 0.27.0): quanto cada database ocupa no servidor (dados + índices), quanto foi o último backup comprimido, a taxa de compressão e o crescimento em relação ao run anterior. Serve para dimensionar storage e para perceber um banco que cresceu mais do que devia.

# Sintaxe

backupally measure [TASK_ID] [OPÇÕES]

# Exemplo

backupally measure mysql-prod

📏 Medição de volumes

📦 mysql-prod (database)
ITEM                                         ORIGEM       BACKUP     COMPR.     CRESC.
──────────────────────────────────────────────────────────────────────────────────────
app                                          1.8 GB       312 MB      83.1%      +2.1%
analytics                                    9.4 GB            —          —          —

──────────────────────────────────────────────────────────────────────────────────────
1 task(s) medida(s)
ORIGEM: dados + índices no servidor · BACKUP: último artefato comprimido

# O que significa cada coluna

# Quando aparece `—`

Compressão e crescimento saem como — quando falta um dos lados: task que nunca rodou, banco recém-adicionado, histórico sem o run anterior, ou origem que não dá para medir. Melhor não mostrar número nenhum do que mostrar um inventado.

Pelo mesmo motivo, o tamanho por item não é rateado a partir do total do run: o histórico guarda o total, e dividir seria inventar.

Task que não pôde ser medida (banco fora do ar, credencial inválida) aparece com ❌ e o motivo; as demais seguem. O comando só falha se nenhuma task puder ser medida.

# Banco em container

O host docker:<container>[/<rede>] vale aqui como no backup: a medição usa a mesma resolução do executor. Ver Banco em container Docker.

# Saída para automação

backupally measure -o json

Sai no envelope measure (schema_version: "2.0"). Em data.tasks, uma entrada por task com task_id, kind, source_total_bytes, last_backup_bytes e items[]; cada item traz item, source_bytes, last_backup_bytes, previous_backup_bytes, compression_pct e growth_pct (null onde a tabela mostra —). Erros por task vão em data.errors.