Desempenho no MySQL: índices e slow log
Para achar a consulta que pesa no Mautic ou no WordPress, o MySQL oferece o slow query log, o registro das consultas que passam dos limites de duração e de linhas examinadas configurados. Você compara esses registros com o plano do EXPLAIN para entender como o servidor lê as tabelas.
Ficha e sumário da página
- Referência técnica
- MySQL 8.4.13 LTS
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Linhas lidas e linhas devolvidas
O manual do MySQL descreve o índice pelo que ele evita. Sem índice, o servidor começa na primeira linha da tabela e lê até a última para encontrar as que interessam. Com um índice na coluna usada no filtro, ele vai direto às posições certas. Numa tabela pequena, o otimizador pode preferir a leitura completa. Numa email_stats com milhões de linhas, um índice adequado pode evitar grande parte dessa leitura. O ganho depende do filtro e da quantidade de linhas que a consulta precisa devolver.
O sinal está na distância entre dois números: as linhas que o servidor examinou e as linhas que ele mandou de volta. Como exemplo de diagnóstico, uma consulta que devolve dez contatos depois de examinar dois milhões de linhas merece uma conferência do plano. A diferença entre esses números não prova sozinha que falta um índice: junções e agregações também podem exigir muitas leituras. Uma consulta com poucas linhas examinadas ainda pode esperar por travas ou pelo disco.
O que um índice é por dentro
No InnoDB, cada tabela tem um índice agrupado, que guarda as próprias linhas. Ele usa a chave primária quando ela existe. Sem ela, o motor escolhe um índice único com colunas não nulas ou cria uma chave interna. Nas tabelas com chave primária, os índices secundários guardam as colunas indexadas junto dessa chave. Uma busca por e-mail na tabela leads do Mautic pode encontrar o valor no índice secundário e usar a chave para buscar a linha completa, como a página InnoDB e tipos de coluna explica.
O índice tem custo. Cada INSERT e cada UPDATE na coluna indexada precisa atualizar o índice também. Cada índice ainda ocupa disco e espaço no buffer pool. Por isso as tabelas do Mautic e do WordPress já saem com os índices que as consultas do próprio app usam, como o índice composto type_status_date em wp_posts. Um índice extra só reduz o tempo de uma consulta real que filtra ou ordena pela coluna indexada.
Num índice composto, a ordem das colunas define quais buscas ele atende. Um índice em (lead_id, date_sent) permite localizar os envios de um contato pela primeira coluna ou combinar contato e data. Um filtro só por data não usa esse mesmo prefixo de busca. O otimizador ainda pode escolher uma varredura do índice ou um skip scan quando as condições permitem, por isso você confere o acesso escolhido no EXPLAIN.
O plano da consulta
Antes de executar um SELECT, o otimizador do MySQL escolhe um plano: qual índice usar, a ordem de junção das tabelas e quantas linhas espera ler. O comando EXPLAIN mostra esse plano sem executar a consulta. O EXPLAIN ANALYZE executa a consulta e mostra também o tempo real de cada etapa.
typeComo a tabela é lida: por índice exato, por faixa ou inteira.ALL, a leitura da tabela inteira.possible_keysOs índices que poderiam servir ao filtro.NULL: nenhum índice combina com o WHERE.keyO índice que o otimizador escolheu.NULL mesmo com índices possíveis.rowsA estimativa de linhas que o servidor vai examinar.Um número muito maior que o resultado esperado.O plano depende das estatísticas que o InnoDB guarda sobre cada índice, como o número aproximado de valores distintos. Quando a tabela muda muito, a estimativa de rows pode se afastar da realidade. O comando ANALYZE TABLE atualiza essas estatísticas.
O que o slow query log registra
O EXPLAIN responde sobre uma consulta que você já tem em mãos. O slow query log responde à pergunta anterior: quais consultas estão demorando. Ele vem desligado e é ligado pela variável slow_query_log. O limite fica em long_query_time, com padrão de 10 segundos e resolução de microssegundos. O tempo gasto esperando as travas iniciais fica fora do tempo de execução.
Consulta
SELECT ... FROM email_statsChega pela conexão do Mautic, com o usuário do Mautic.
Plano
type: ALLSem índice para o filtro, o InnoDB lê a tabela inteira.
Limite
long_query_timeA execução passa do limite configurado, 10 segundos por padrão.
Entrada no log
Rows_examinedO servidor grava o comando com tempo, linhas lidas e linhas devolvidas.
Cada entrada traz uma linha de cabeçalho com quatro números. Query_time traz o tempo de execução e Lock_time o tempo para obter as travas. Rows_sent traz as linhas devolvidas e Rows_examined as linhas examinadas. Uma linha anterior registra o usuário e o host da conexão. Com o Mautic e o WordPress no mesmo servidor, cada um com o próprio usuário, a entrada já mostra de qual app a consulta veio.
Duas variáveis ajustam o que entra. A min_examined_row_limit ignora as consultas que leram poucas linhas. A log_queries_not_using_indexes grava também as consultas que não usaram índice, mesmo as rápidas. Assim aparece cedo a tabela pequena lida inteira, antes de ela crescer. Esse modo enche o log depressa, por isso a variável log_throttle_queries_not_using_indexes limita quantas dessas entradas entram por minuto.
Ler o log sem ler o log inteiro
O slow log acumula várias entradas da mesma consulta, com valores diferentes no WHERE. O mysqldumpslow, que vem com o MySQL, agrupa as consultas que só diferem nos valores e resume cada grupo com o número de execuções, o tempo médio e o tempo total. Ordenado pelo tempo total, o resumo mostra primeiro as consultas que mais ocupam o servidor. Como exemplo de cálculo, uma consulta de meio segundo repetida mil vezes por hora soma 500 segundos a cada hora. Uma de vinte segundos que roda uma vez por dia soma vinte segundos no dia.
O Percona Server estende o mesmo log. Com a variável log_slow_verbosity, ele acrescenta campos como o uso de tabelas temporárias, as páginas lidas do InnoDB e o plano da consulta, conforme a documentação do slow log estendido. A página MySQL e Percona: o que muda traz esse e os outros acréscimos da Percona ao MySQL.
Continue na comunidade
Leve ao Discord da Promovaweb a consulta que trava o Mautic ou o backup que não volta. Com o trecho do slow log ou a mensagem do servidor na conversa, a comunidade compara o seu caso com bancos parecidos.
Uma VPS para o seu banco
O buffer pool do InnoDB e o PHP do Mautic e do WordPress dividem a memória da mesma VPS. A VPS da StayCloud em São Paulo vem com acesso root e disco NVMe para o banco e os apps.
Link de parceiro da Promovaweb.