Adendo ao NAS RAIDZ1: como scrub e trim são agendados de verdade — e o alerta que não veio

Ilustração do agendamento de scrub e trim no OpenZFS

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Uma breve continuação da montagem do NAS RAIDZ1. A cheatsheet daquele post te deu zpool scrub storage como um comando que você pode rodar. O que ela não respondeu é se alguma coisa o roda por você — e, já que um scrub só serve se você realmente fica sabendo quando ele encontra algo, se o sistema te avisa quando isso acontece. As duas perguntas acabaram tendo respostas mais interessantes do que “sim, obviamente”.

Índice

🔍 Scrub e trim, um parágrafo para cada

zpool scrub lê cada bloco alocado no pool e o confere com o checksum armazenado. Uma divergência — um bit que mudou silenciosamente em algum lugar da mídia física — é reconstruída a partir da paridade RAIDZ e regravada automaticamente. Esse é todo o mecanismo que torna o ZFS imune ao problema do bit rot silencioso, ao qual o post original dedicou vários parágrafos: não é que a corrupção não possa acontecer, é que o scrub transforma “corrupção que ninguém nunca vai notar” em “corrupção que é corrigida antes que alguém note”. zpool trim é específico para SSDs. Ele informa ao firmware do drive quais blocos o ZFS deixou de usar (arquivos apagados, dados sobrescritos), para que o SSD possa apagar e preparar esse espaço com antecedência em vez de correr para fazer isso no meio de uma escrita. Pule isso por tempo suficiente e o desempenho de escrita cai silenciosamente à medida que o drive fica sem blocos pré-apagados — o equivalente de SSD a nunca levar o lixo para fora e se perguntar por que ficou mais lento trabalhar na cozinha. Nenhum dos dois serve como algo pontual. A ideia toda é que rodem num agendamento.

📅 Quem realmente puxa o gatilho

Fui procurar a resposta em vez de supor, e ainda bem que fiz isso — o lugar óbvio para procurar estava errado. O OpenZFS no Debian traz dois mecanismos de agendamento lado a lado, e só um deles estava fazendo alguma coisa:

$ systemctl list-unit-files | grep zfs-scrub
zfs-scrub-monthly@.timer   disabled   enabled
zfs-scrub-weekly@.timer    disabled   enabled

Os dois disabled. Se eu tivesse parado aqui, a resposta honesta teria sido “não, nada roda isso”. Mas o zfsutils-linux também instala um arquivo cron simples, independente desses timers, e esse está ativo:

# /etc/cron.d/zfsutils-linux

# TRIM the first Sunday of every month.
24 0 1-7 * * root if [ $(date +\%w) -eq 0 ] && [ -x /usr/lib/zfs-linux/trim ]; then /usr/lib/zfs-linux/trim; fi

# Scrub the second Sunday of every month.
24 0 8-14 * * root if [ $(date +\%w) -eq 0 ] && [ -x /usr/lib/zfs-linux/scrub ]; then /usr/lib/zfs-linux/scrub; fi

Trim no primeiro domingo, scrub no segundo, ambos às 00:24. O script /usr/lib/zfs-linux/scrub que ele chama também não é um zpool scrub $everything às cegas — ele percorre cada pool, verifica se a saúde está ONLINE e lê, por pool, uma propriedade definida pelo usuário chamada org.debian:periodic-scrub para decidir se o inclui:

$ zfs get -H -o value org.debian:periodic-scrub storage
-

- significa não definida, o que o script trata como auto — o scrub acontece. Defini-la como disable num pool tiraria esse pool sem mexer no próprio cron job, o que é um botão mais limpo do que editar o script. Resumindo: dois sistemas de agendamento estão instalados, só o mais antigo, baseado em cron, está ligado, e a decisão real por pool é uma propriedade, não um nome de pool fixo no código. Nada disso dá para descobrir pelo zpool status — você precisa checar systemctl, /etc/cron.d e a propriedade diretamente, que foi exatamente o que acabei fazendo depois de me fazerem a pergunta muito razoável “isso é realmente automatizado, ou você só me mostrou o comando manual?” Mensal também é o intervalo certo a se querer aqui, aliás — são SSDs, e uma cadência semanal de scrub é mais um padrão da era dos HDDs que, em flash, basicamente só adiciona desgaste sem benefício extra.

🔔 Alguma coisa te avisa quando o scrub encontra um problema?

Esta é a parte que realmente me surpreendeu. A infraestrutura para te avisar existe, está instalada e está rodando:

$ systemctl status zfs-zed
● zfs-zed.service - ZFS Event Daemon (zed)
     Active: active (running)

O ZED (o ZFS Event Daemon) observa eventos do pool — scrub terminando, um resilver concluído, um dispositivo mudando de estado — e a config dele até nomeia um destinatário:

# /etc/zfs/zed.d/zed.rc
ZED_EMAIL_ADDR="root"
ZED_NOTIFY_INTERVAL_SECS=3600

Parece configurado. E está configurado — do ponto de vista do próprio ZED. Mas o mecanismo de entrega real, enterrado no zed-functions.sh, é nada glamoroso:

: "${ZED_EMAIL_PROG:="mail"}"

O zed_notify_email chama um binário literalmente chamado mail. E nesta máquina:

$ which mail mailx msmtp
$

Nada. Nenhum mailutils, nenhum msmtp, nenhum MTA de qualquer tipo instalado. O zpool create nunca puxa um como dependência, então, a menos que você se lembre separadamente de instalar entrega de e-mail, o ZED tem um destinatário e nenhum jeito de alcançá-lo. O zedlet scrub_finish-notify.sh dispararia corretamente no próximo scrub, montaria a mensagem, a entregaria ao zed_notify_email, que tentaria rodar mail, receberia “command not found” e falharia — silenciosamente, do ponto de vista de quem estivesse esperando um e-mail de verdade aparecer. O journalctl -u zed vai ter a falha registrada se você for procurar. Nada vai trazê-la à tona se você não for. Quero ficar um segundo nisso, porque é uma piada genuinamente boa: o primeiro post inteiro era sobre um sistema de arquivos que se recusa a deixar corrupção passar despercebida — checksums em vez de confiança cega, autocorreção em vez de falha silenciosa. E a camada em cima dele, cujo único trabalho é avisar um humano quando essa maquinaria faz o trabalho dela, estava ela mesma falhando exatamente do jeito silencioso que o ZFS foi feito para evitar. A lição do último post se generaliza mais do que eu esperava: “aparentemente OK em silêncio” é uma propriedade da infraestrutura, não só dos discos.

🛠️ Corrigindo, de verdade

A lacuna é só um MTA faltando, não uma configuração errada do ZED, então a correção é de fato em três passos: instalar um cliente de e-mail, apontá-lo para um relay, dizer ao ZED para quem mandar e-mail.

apt-get install -y msmtp msmtp-mta bsd-mailx

O msmtp-mta cria um symlink do msmtp como /usr/sbin/sendmail, que é exatamente o que mail/mailx — e portanto o ZED — chamam por baixo dos panos. Este homelab já tem um relay de saída funcionando (Strato, usado em outros lugares para notificações de outros hosts), então apontei o /etc/msmtprc para a mesma conta em vez de montar algo novo:

# /etc/msmtprc — root-owned, chmod 600 (it holds a password)
defaults
auth           on
tls            on
tls_starttls   on
logfile        /var/log/msmtp.log

account        homelab
host           smtp.strato.de
port           587
from           homelab@apt-upgrade.me
user           homelab@apt-upgrade.me
password       ██████████████████

account default : homelab

chown root:root /etc/msmtprc && chmod 600 /etc/msmtprc logo em seguida — esse arquivo tem uma senha em texto puro, e o zfs-zed.service roda como root de qualquer forma, então só root é ao mesmo tempo correto e suficiente. O mesmo tratamento para o arquivo de log. Depois, o verdadeiro objetivo deste exercício todo — dizer ao ZED para parar de endereçar e-mails a uma conta local root que ninguém nunca vai ler, e mandá-los para algum lugar onde eu realmente vá vê-los:

sed -i 's/^ZED_EMAIL_ADDR=.*/ZED_EMAIL_ADDR="you@example.com"/' /etc/zfs/zed.d/zed.rc
systemctl restart zfs-zed

Sem aliases, sem spool de e-mail local, sem regra de encaminhamento para acompanhar — ZED_EMAIL_ADDR é literalmente o destinatário com o qual o mail é chamado, então apontá-lo direto para uma caixa de entrada real é mais simples do que fazer a entrega local funcionar primeiro e empilhar um encaminhamento por cima.

✅ Funcionamento confirmado

Em vez de esperar o segundo domingo do mês para descobrir se alguma coisa disso realmente funciona, mandei um teste manual pelo mesmíssimo caminho que o ZED usa — mail, que resolve para msmtp, que se autentica na Strato:

$ echo "This is a test message from the storage NAS (192.168.10.x) confirming that
msmtp + ZED mail delivery is now working via the Strato relay." | 
\
  mail -s "ZFS ZED delivery check - storage NAS" you@example.com

$ tail -1 /var/log/msmtp.log
host=smtp.strato.de tls=on auth=on user=homelab@apt-upgrade.me from=homelab@apt-upgrade.me
recipients=you@example.com mailsize=436 smtpstatus=250
smtpmsg='250 2.0.0 OK queued with id 990330282JJ9ENX' exitcode=EX_OK

smtpstatus=250 / exitcode=EX_OK significa que a Strato aceitou a mensagem para entrega — esse é o lado da história do msmtp. O lado da caixa de entrada confirmou alguns segundos depois:

From:    homelab@apt-upgrade.me
To:      you@example.com
Subject: ZFS ZED delivery check - storage NAS
Date:    Wed, 2 Sep 2026 21:19

This is a test message from the storage NAS (192.168.10.x) confirming that
msmtp + ZED mail delivery is now working via the Strato relay.

De ponta a ponta, do relay à caixa de entrada, em mais ou menos o tempo que levou para ler a linha do log. Essa é a correção inteira verificada — não “deve funcionar agora”, mas um e-mail de verdade que de fato chegou. Coisa pequena, mas que vale dizer com clareza: a correção aqui não é bem “instalar o msmtp”. É perceber que um componente cujo trabalho inteiro é dar o alarme pode falhar exatamente tão silenciosamente quanto aquilo que ele deveria vigiar — e que o único jeito de saber se ele realmente funciona é dispará-lo e conferir, não ler a config e supor.


📚 Mais nesta série: o NAS RAIDZ1

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes