Segundo adendo: o ZED vigia a saúde do meu pool, não a cintura dele

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
Este é curto, e uma consequência direta do post sobre snapshots. Adicionar snapshots diários trouxe algo que não existia antes neste NAS: uma coisa que cresce sozinha, em silêncio, para sempre, sem ninguém pedir. Então fui procurar o que quer que me avisasse quando o pool começasse a encher. A resposta foi levemente constrangedora.
Índice
🔍 O ZED tem opiniões, mas não sobre isso
O ZED está rodando. Está configurado. Eu consertei exatamente isso no último adendo, e o conserto se mantém:
$ systemctl is-active zed
active
$ grep ZED_EMAIL_ADDR /etc/zfs/zed.d/zed.rc
ZED_EMAIL_ADDR="you@example.com"
O problema é para que o ZED serve. Ele reage a eventos — um disco caindo, erros de checksum, um scrub terminando, um vdev degradando. Coisas que acontecem em um momento e têm um antes e um depois óbvios. Um pool enchendo devagar não é nada disso. Não há evento. Nenhuma escrita isolada cruza uma linha que o ZFS considere digna de anúncio. A capacidade só vai subindo, e o ZED — corretamente, pelo próprio design — não diz absolutamente nada. Da última vez o alarme existia e não conseguia alcançar ninguém. Desta vez nem existe alarme.
🧊 Por que “é só apagar alguma coisa” não é mais a saída de emergência de antes
No ext4, um disco cheio é chato. No ZFS é pior, por dois motivos que se somam. Primeiro, o desempenho de escrita cai de forma relevante depois de uns 80% — o alocador tem que se esforçar mais para achar espaço contíguo, e isso aparece. Segundo, e é esse que pega as pessoas: apagar arquivos pode falhar em um pool completamente cheio, porque apagar é, em si, uma escrita. Remover um arquivo significa atualizar metadados, e copy-on-write significa que atualizar metadados significa alocar um bloco. Sem blocos livres, sem delete. Agora coloque snapshots por cima. Como mostrado no post sobre snapshots, apagar um arquivo que um snapshot ainda referencia libera exatamente nada:
storage/demo USED: 200M REFER: 128K
REFER é o que está no diretório ao vivo: praticamente vazio. USED é o que o dataset realmente ocupa, porque um snapshot está segurando os blocos.
Então o movimento instintivo de recuperação — liberar espaço apagando coisas — não leva a lugar nenhum em um dataset com snapshots, e pode nem executar em um pool realmente cheio. Uma combinação que vale a pena não descobrir ao vivo.
🛠️ Cinco linhas e um timer
O check em si é banal, e essa é a ideia:
#!/bin/bash
# /usr/local/sbin/zfs-capacity-check.sh
set -euo pipefail
WARN="${1:-80}"
RECIPIENT="$(grep -hE '^ZED_EMAIL_ADDR=' /etc/zfs/zed.d/zed.rc 2>/dev/null
\
| head -1 | cut -d= -f2- | tr -d '"' | xargs)"
[ -n "$RECIPIENT" ] || exit 0
problems=""
while read -r pool cap; do
num="${cap%\%}"
[ "$num" -ge "$WARN" ] || continue
problems="${problems}Pool '${pool}' is ${cap} full (threshold: ${WARN}%).
"
done < <(zpool list -H -o name,capacity)
[ -n "$problems" ] || exit 0
# ... assemble report, pipe into mail ...
Duas pequenas decisões que valem ser mencionadas.
O destinatário é lido do zed.rc em vez de ficar fixo no código. Já existe exatamente um lugar nesta máquina onde está configurado “quem fica sabendo quando o armazenamento se comporta mal”, e criar um segundo é o jeito de os dois se desencontrarem em silêncio daqui a seis meses.
E o e-mail não diz só “o pool está cheio”. Ele lista os maiores snapshots, porque em uma máquina ZFS com snapshots automáticos essa é, de longe, a resposta para “para onde foi meu espaço” — e a mensagem que chega às 3 da manhã deveria trazer a resposta, não só a pergunta.
O timer tem o mesmo formato dos de snapshot: diário, Persistent=true, atraso aleatório.
✅ Testando a coisa que deveria me avisar
O último adendo terminou com um componente cuja única função era disparar um alarme falhando em silêncio. Não vou cair nessa duas vezes. Então, em vez de confiar em um check que corretamente reporta “nada de errado” em um pool com 49%, baixei o limite até ele ser obrigado a disparar:
$ /usr/local/sbin/zfs-capacity-check.sh 40
$ tail -2 /var/log/msmtp.log
Sep 02 21:19:09 host=smtp.strato.de ... recipients=you@example.com
smtpstatus=250 exitcode=EX_OK
Sep 11 14:47:14 host=smtp.strato.de ... recipients=you@example.com
mailsize=861 smtpstatus=250 exitcode=EX_OK
E-mail aceito, 250, EX_OK. A cadeia inteira funciona: script, mail, msmtp, Strato, entregue.
E olhe a linha de cima. 2 de setembro — é a mensagem de teste do ZED do adendo anterior, bem ali no mesmo log. Dois caminhos de alerta, com nove dias de diferença, ambos verificados do mesmo jeito, pelo mesmo motivo.
A lição
Uma ferramenta de monitoramento conta sobre as falhas que ela foi feita para imaginar. O ZED imagina discos morrendo, e é excelente nisso. Ele não imagina o seu pool enchendo devagarinho ao longo de dezoito meses, porque isso não é um evento — é a ausência de um. E essa é a parte incômoda do monitoramento em geral: o que ele cobre é decidido por quem o escreveu, e o que ele não cobre produz exatamente a mesma saída que tudo funcionando bem. Silêncio. Vale perguntar de vez em quando o que o seu monitoramento é estruturalmente incapaz de te dizer. Não o que ele está deixando de reportar — o que ele nunca foi projetado para perceber.
📚 Mais nesta série: o NAS RAIDZ1
- Montando um NAS RAIDZ1 no Debian 13 com OpenZFS: datasets, compressão e as mentiras que o dd me contou
- Adendo do NAS RAIDZ1: como scrub e trim são realmente agendados — e o alerta que não existia
- Todo mundo sorrindo — vamos tirar um snapshot! Trocando o rdiff-backup pelo ZFS no NAS RAIDZ1
- Duas coisas que faltavam nos meus SSDs: TRIM depois do BitLocker e um cache de escrita que meu servidor HPE desligou em silêncio
