Medir o TTFB com curl para decidir quem migra para o Brasil
O procedimento de laboratório para levantar o TTFB de cada site da carteira com curl, em uma tarde, e um critério único, com faixas em números, para separar quem entra na fila de migração de quem precisa de cache ou de índice no banco.

Resposta curta: meça a mediana de 11 amostras de time_starttransfer com curl, de link residencial e conexão nova, e compare com os 114 ms que a troca de Miami por São Paulo devolve. Se essa fatia não muda a faixa em que o site está, o gargalo é outro e a migração não aparece no número.
Neste artigo
- O que esta medição decide e o que ela não decide
- TTFB é `time_starttransfer`, medido de link residencial e com conexão nova
- O comando curl que mostra onde o tempo foi
- Medir 40 sites em uma tarde e gravar o resultado num CSV
- As quatro colunas que você preenche à mão
- Quando 114 ms mudam a faixa do site e quando não mudam
- Como dizer não ao cliente que pediu a migração
- Checklist de oito passos antes de assinar a migração
O que esta medição decide e o que ela não decide
A pergunta "vale a pena trazer o site para o Brasil" tem uma resposta de arquitetura e uma resposta de medição. A de arquitetura, com a conta do que a distância custa e do que ela não custa, está em hospedagem no Brasil ou fora: o custo dos 114 ms. Este texto é a outra metade: o procedimento para medir o TTFB de cada site da carteira, com o mesmo critério para todos, e separar quem ganha com a migração de quem só perde uma noite de trabalho.
O número de referência que usamos na triagem é o teto do ganho geográfico. Em laboratório, atender um usuário brasileiro a partir de Miami em vez de São Paulo custou 114 ms a mais, em mediana. É o máximo que a troca de cidade devolve, e só devolve inteiro se todo o resto ficar igual: mesma stack, mesma versão de PHP, mesmo TLS, mesmo disco, mesma configuração de cache.
A triagem, então, é uma subtração. Quanto pesa 114 ms dentro do tempo que o site do seu cliente leva hoje. Para responder isso você precisa de um TTFB confiável por site, e a maior parte dos TTFB que circulam em prints de ferramenta online não é confiável.
TTFB é `time_starttransfer`, medido de link residencial e com conexão nova
TTFB aqui é o que o curl chama de time_starttransfer: o tempo entre o início do comando e a chegada do primeiro byte da resposta, que é a primeira linha de cabeçalho e não o início do corpo, incluindo DNS, TCP e TLS. É a definição que vale porque é a que a ferramenta mede de fato, e é a que mais se aproxima da espera do usuário olhando a tela branca.
Três regras que mudam o resultado:
- De link residencial, nunca de datacenter. Se você roda o teste de um VPS, está medindo o backbone do datacenter, que costuma ter rota privilegiada e não se parece com a operadora do usuário final. Rode do seu notebook, no Wi-Fi de casa ou do escritório, ou peça para o cliente rodar da cidade dele.
- Conexão nova a cada amostra. Cada invocação do
curlabre uma conexão. Não reaproveite keep-alive, senão você mede a segunda requisição, que já pulou handshake, e o custo da distância desaparece do número. - Arquivo pequeno. Você quer o tempo até o primeiro byte, não a banda. Um
favicon.ico, umrobots.txtou um CSS pequeno serve. HTML de home também serve, mas aí você mede rede mais aplicação juntas, e vai querer os dois números separados.
O comando curl que mostra onde o tempo foi
curl -o /dev/null -s -w 'dns:%{time_namelookup} tcp:%{time_connect} tls:%{time_appconnect} ttfb:%{time_starttransfer} total:%{time_total}\n' https://exemplo.com.br/
O valor sai em segundos com decimais. A leitura é direta:
dnsalto e o resto normal: problema de resolução, não de servidor. Trocar de hospedagem não resolve.- diferença entre
tcpetlsgrande: handshake TLS custando round-trips, e é justamente aqui que a distância aparece antes de qualquer linha de PHP rodar. ttfbmenostls: esse pedaço é tempo de servidor mais um round-trip. Dentro dele estão o envio da requisição, o processamento (PHP pensando, banco respondendo) e a volta do primeiro byte.
Essa subtração é o coração da triagem, desde que você desconte esse round-trip antes de acusar a aplicação. Regra prática: se sobram centenas de milissegundos depois do handshake, o gargalo é a aplicação, porque nenhum RTT Brasil-Estados Unidos chega perto disso.
Por que 11 amostras e não uma
Uma amostra isolada não vale nada: um retransmit de TCP ou uma limpeza de cache do WordPress no meio do caminho estragam o número. Rode 11 e pegue o valor do meio.
for i in $(seq 1 11); do
curl -o /dev/null -s -w '%{time_starttransfer}\n' https://exemplo.com.br/
done | sort -n | sed -n '6p'
Onze amostras ordenadas, a sexta é a mediana. O valor sai em segundos. Simples o bastante para você confiar no resultado sem revisar a lógica.
Se quiser forçar a ida até a origem, ignorando cache de borda, acrescente um parâmetro diferente a cada volta:
for i in $(seq 1 11); do
curl -o /dev/null -s -w '%{time_starttransfer}\n' "https://exemplo.com.br/?cb=$i"
done | sort -n | sed -n '6p'
Agora você tem dois números por site: o que o usuário recebe hoje (sem cache-buster) e o que a origem entrega (com cache-buster). A diferença entre eles é o quanto o cache está trabalhando, e isso vai decidir metade dos casos.
Medir 40 sites em uma tarde e gravar o resultado num CSV
O valor do processo não está em medir um site, está em medir quarenta e ter um critério igual para todos. Ponha as URLs em um arquivo, uma por linha, e gere um CSV. O script abaixo já converte para milissegundos, que é a unidade que vai para a planilha e para o cliente.
#!/bin/bash
# ttfb.sh - mediana de 11 amostras de TTFB por site, em milissegundos
while read -r url; do
mediana=$(for i in $(seq 1 11); do
curl -o /dev/null -s -w '%{time_starttransfer}\n' "$url"
done | sort -n | sed -n '6p' | awk '{printf "%.0f", $1 * 1000}')
echo "$url;$mediana"
done < sites.txt
chmod +x ttfb.sh
./ttfb.sh > medicao-$(date +%F).csv
Se você rodar o curl cru em vez do script, lembre que ele imprime segundos: multiplique por 1000 antes de lançar na planilha, senão a coluna mistura 0,35 com 350 e a triagem vai por água abaixo.
Repita a medição depois de qualquer mudança, no mesmo horário e do mesmo link. Medição de antes e depois feita em redes diferentes não compara nada. E guarde o CSV: quando o cliente perguntar daqui a seis meses se "melhorou", você tem o número, não a impressão.
As quatro colunas que você preenche à mão
O script entrega uma coluna. As outras quatro decidem, e nenhuma delas sai do curl de TTFB.
| Coluna | O que registrar | Como levantar |
|---|---|---|
| TTFB mediano | saída do script, em ms | ttfb.sh |
| Cache de HTML | HIT, MISS ou DYNAMIC | curl -sI nos headers |
| País dominante | país com maior fatia de sessões em 90 dias | GA4 do cliente |
| Região do servidor | cidade e provedor atuais | painel ou whois do IP |
| Servidor + 1 RTT | TTFB menos time_appconnect, em ms |
curl -w completo |
Para a coluna de cache:
curl -sI https://exemplo.com.br/ | grep -i -E 'cf-cache-status|x-cache|x-litespeed-cache|age|server'
cf-cache-status: HIT, x-cache: HIT ou x-litespeed-cache: hit significam que o HTML veio da borda, e que a origem já responde só o que o cache não cobre. Cuidado com a leitura invertida: cf-cache-status: DYNAMIC em Cloudflare significa que o HTML não está sendo cacheado.
Para a coluna de servidor mais um RTT, quando o excedente depois do handshake for alto, levante o diagnóstico antes de falar de geografia:
- ative o
slow query logdo MySQL com threshold de 1 segundo por um dia e leia o que aparece; - rode o Query Monitor em uma página de staging e veja quantas queries e quantos plugins entram na home;
- confira se o OPcache está ligado e se a versão do PHP não é uma que já saiu do suporte;
- olhe se
wp_optionstem transient expirado acumulado e opções comautoload = yesque ninguém precisa em toda requisição.
É recomendação contra o interesse de quem vende hospedagem, e é verdade: em site lento por aplicação, ler o log de consulta lenta resolve mais do que trocar de plano.
Quando 114 ms mudam a faixa do site e quando não mudam
Antes da régua, as faixas. Elas são convenção nossa, não norma: o que vale é fixar uma tabela de faixas, escrever na planilha e aplicar a mesma para os quarenta sites.
- Rápido: até 250 ms.
- Aceitável: de 250 a 500 ms.
- Lento: de 500 a 1.200 ms.
- Muito lento: acima de 1.200 ms.
Com o TTFB mediano em mãos, o piso otimista depois da migração é o TTFB atual menos 114 ms. Aplicando a subtração e reclassificando:
| TTFB hoje | Faixa hoje | Piso otimista | Faixa depois | Decisão |
|---|---|---|---|---|
| 180 ms | Rápido | 66 ms | Rápido | Não entra na fila. A faixa não muda. |
| 350 ms | Aceitável | 236 ms | Rápido | Candidato. A migração sobe uma faixa. |
| 700 ms | Lento | 586 ms | Lento | Cache e aplicação primeiro, remeça depois. |
| 1.400 ms | Muito lento | 1.286 ms | Muito lento | Fora da fila. O gargalo está no PHP, no banco ou em plugin. |
A régua: se os 114 ms não mudam a faixa em que o site está, ele não entra na fila de migração. Um site muito lento a 1,4 s continua muito lento a 1,29 s. Um site de 700 ms continua lento a 586 ms, e aí o trabalho é cache e banco, não geografia. Um site de 350 ms vira um site rápido de 236 ms, e isso aparece no Core Web Vitals e na percepção de quem clica.
Se você achar as faixas apertadas ou largas demais para a sua carteira, mexa nos limites, mas mexa antes de medir e use os mesmos para todos os sites. Critério que muda de site para site vira justificativa, não triagem.
Combinando as colunas, candidato a migração é o site com TTFB alto, HTML sem cache, público majoritariamente brasileiro e tempo de servidor baixo. Qualquer outra combinação pede outra intervenção antes, e os casos em que a migração não devolve nada estão detalhados no artigo sobre o custo dos 114 ms.
Como dizer não ao cliente que pediu a migração
O cliente leu em algum lugar que servidor no Brasil é mais rápido, e ele não está errado, está incompleto. A recusa funciona quando vem com número e com um próximo passo, não quando vem como opinião técnica.
Frase pronta, adapte os valores aos seus:
"Medi o tempo de resposta do site a partir de uma conexão residencial, com conexão nova e 11 amostras: a mediana está em 980 ms. Desse total, no máximo 114 ms vêm da distância até o servidor nos Estados Unidos, que é exatamente o que uma migração para São Paulo devolveria. Os outros 866 ms são o tempo que o próprio site leva para montar a página, mais o custo de abrir a conexão, e esse pedaço continuaria praticamente igual depois da mudança. Proponho atacar primeiro esses 866 ms, com cache de página e revisão das consultas ao banco. Se depois disso os 114 ms ainda incomodarem, a migração fica simples e barata de fazer, e aí ela aparece no número."
Quando a coluna de país dominante aponta para fora do Brasil, a versão é outra:
"Nos últimos 90 dias, a maior parte das sessões vem de fora do Brasil. Mover o servidor para São Paulo melhoraria o tempo de quem acessa daqui e pioraria o de quem acessa de lá, que hoje é o grosso do seu tráfego. O caminho que atende os dois é colocar uma CDN na frente e manter a origem onde está."
Duas coisas essa frase faz por você: transfere a discussão de "acho" para "medi", e reposiciona a migração de solução única para última etapa de uma sequência. O cliente costuma aceitar, porque ele não queria um servidor no Brasil, queria um site rápido.
Checklist de oito passos antes de assinar a migração
Quando a triagem der sim, migre com esse roteiro, na ordem:
- Medir e salvar o TTFB mediano atual, em milissegundos, do link residencial, com o script, e anotar data e horário.
- Registrar os headers de cache e o país dominante do GA4 no mesmo documento.
- Calcular
time_starttransfermenostime_appconnect, descontar mentalmente um round-trip e confirmar que o tempo de processamento está baixo. Se não estiver, parar aqui e tratar a aplicação. - Conferir que o destino tem a mesma versão de PHP ou mais nova, OPcache ligado e limites de memória iguais ou maiores. Migrar para um ambiente mais pobre anula os 114 ms.
- Baixar o TTL do DNS para 300 segundos pelo menos 24 horas antes da troca, para poder reverter rápido.
- Migrar, validar em
/etc/hostsantes de apontar o DNS, e só então trocar o registro. - Remedir 48 horas depois, mesmo horário, mesmo link, mesmas 11 amostras, e comparar com o número do passo 1.
- Mandar os dois números para o cliente, antes e depois, em milissegundos. É o entregável que justifica a fatura.
O passo 7 é o que a maioria pula e o único que transforma a migração em argumento comercial reutilizável. Com dez sites medidos antes e depois, você para de discutir com cliente sobre hospedagem e passa a mostrar planilha.
Como medimos
Sondas em São Paulo, Rio de Janeiro, Belo Horizonte e Porto Alegre, em redes residenciais de operadoras diferentes, não em datacenter. Isso importa: medir de datacenter para datacenter dá números bonitos que o visitante nunca vai experimentar. Cada amostra é o tempo até o primeiro byte de uma requisição HTTPS a um arquivo de 1 KB, com conexão nova, sem reaproveitar sessão TLS. Descartamos as amostras com erro de rede, que foram 0,3% do total. Usamos mediana em vez de média porque picos isolados de roteamento distorcem a média e não representam a experiência comum.