Ir para o conteúdo
Promovaweb

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
  1. Linhas lidas e linhas devolvidas
  2. O que um índice é por dentro
  3. O plano da consulta
  4. O que o slow query log registra
  5. Ler o log sem ler o log inteiro

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.

Coluna do EXPLAINO que mostraSinal de consulta lenta
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.

  1. Consulta

    SELECT ... FROM email_stats

    Chega pela conexão do Mautic, com o usuário do Mautic.

  2. Plano

    type: ALL

    Sem índice para o filtro, o InnoDB lê a tabela inteira.

  3. Limite

    long_query_time

    A execução passa do limite configurado, 10 segundos por padrão.

  4. Entrada no log

    Rows_examined

    O servidor grava o comando com tempo, linhas lidas e linhas devolvidas.

O caminho de uma consulta até o slow query log no MySQL 8.4, segundo o manual consultado em 13/11/2026: o servidor só grava a entrada quando a consulta passa do limite e leu linhas suficientes.

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.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.