blog
Infraestrutura web

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.

JR · · 10 min de leitura · 2 tabelas · 6 blocos de código

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
  1. O que esta medição decide e o que ela não decide
  2. TTFB é `time_starttransfer`, medido de link residencial e com conexão nova
  3. O comando curl que mostra onde o tempo foi
  4. Medir 40 sites em uma tarde e gravar o resultado num CSV
  5. As quatro colunas que você preenche à mão
  6. Quando 114 ms mudam a faixa do site e quando não mudam
  7. Como dizer não ao cliente que pediu a migração
  8. 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.

114 ms a mais, em mediana, para atender um usuário brasileiro a partir de Miami em vez de São Paulo 1.440 amostras · julho de 2026 · medido pela Napoleon Host

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:

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:

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.

Onde o tempo vai até o primeiro byteDNSResolver o nome do domínioTCPAbrir conexão com o servidorTLSHandshake, onde a distância pesaPrimeiro byteServidor processa e responde
Cada campo do curl isola uma parte do tempo. O que sobra depois do TLS é servidor mais um round-trip.

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:

É 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.

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.

Triagem: quem entra na fila de migraçãoMedir TTFB mediano11 amostras, link residencialSubtrair 114 msPiso otimista depois da migraçãoMudou de faixa?Se não mudou, não migraChecar cache do HTMLHIT, MISS ou DYNAMICChecar país dominanteGA4, 90 diasEntra na filaServidor rápido, público brasileiro
Triagem aplicada igual para todos os sites da carteira.

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:

  1. Medir e salvar o TTFB mediano atual, em milissegundos, do link residencial, com o script, e anotar data e horário.
  2. Registrar os headers de cache e o país dominante do GA4 no mesmo documento.
  3. Calcular time_starttransfer menos time_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.
  4. 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.
  5. Baixar o TTL do DNS para 300 segundos pelo menos 24 horas antes da troca, para poder reverter rápido.
  6. Migrar, validar em /etc/hosts antes de apontar o DNS, e só então trocar o registro.
  7. Remedir 48 horas depois, mesmo horário, mesmo link, mesmas 11 amostras, e comparar com o número do passo 1.
  8. 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.

Leia também