Como Monitorar o MySQL com Uptime Kuma: Guia Prático

O Que é Uptime Kuma?

O Uptime Kuma é uma ferramenta open source para monitorar o MySQL e sua disponibilidade, assim como servidores e outras aplicações. Leve e intuitiva, ela permite criar monitores personalizados, configurar alertas via Telegram, Slack e outras plataformas, além de exibir status em páginas públicas. Para entender melhor suas funcionalidades, confira nosso artigo anterior sobre Uptime Kuma.

MySQL em Poucas Palavras

O MySQL é um sistema de gerenciamento de banco de dados relacional (SGBD) open source, amplamente usado em aplicações web. Ele organiza dados em tabelas, permite consultas via SQL e é essencial para sites dinâmicos, como lojas virtuais e plataformas de conteúdo. Monitorar o MySQL com Uptime Kuma garante que esse pilar crítico esteja sempre operacional.

Por Que Monitorar o MySQL com Uptime Kuma?

Ao contrário de ferramentas complexas como o Grafana, o Uptime Kuma destaca-se pela simplicidade. Enquanto o Grafana exige configuração avançada e integração com Prometheus ou outros coletores, monitorar o MySQL com Uptime Kuma oferece verificação rápida de disponibilidade via interface web, ideal para receber alertas imediatos e evitar downtime.

Tabela: Benefícios de Monitorar o MySQL com Uptime Kuma vs. Riscos sem Monitoramento

Grafana vs. Uptime Kuma: Foco no Essencial

Embora o Grafana seja poderoso para análises detalhadas (ex: Queries lentas no MySQL), monitorar o MySQL com Uptime Kuma prioriza a ação rápida. O Grafana depende de integrações complexas (Prometheus, Exporters), enquanto o Uptime Kuma é ideal para quem precisa de respostas imediatas, não apenas diagnósticos.

Passo a Passo: Como Monitorar o MySQL com Uptime Kuma

No exemplo que seguiremos abaixo vamos montar um cenário de monitoramento onde trabalharemos com um Monitor do Serviço do MySQL;

O nosso objetivo é saber por meio de uma página de status personalizada se a falha de Uptime deixou nosso servidor de banco de dados inacessível;

1 – Monitorando o Serviço do MySQL

• Acesse o painel do Uptime Kuma;
• Clique em “Adicionar Monitor”;

• Na tela de configuração clique em “Tipo de Monitor” e Selecione “MySQL/MariaDB”;

• Escolha o nome do monitoramento de acordo com sua preferência;
• Logo em seguida configuraremos a conexão com o MySQL via “String De Conexão”, para facilitar irei explicar a estrutura:

• No nosso caso não iremos nos conectar em um banco específico, por isso iremos remover o nome do banco de dados da string de conexão, e por motivo de segurança iremos colocar a senha separadamente no campo específico para a senha no Uptime KUMA, pois se colocada na string de conexão ela ficará exposta para qualquer usuário visualizar, então iremos utilizar esta string da seguinte forma:

mysql://usuário@ip_do_servidor:porta

• Substitua os dados da string acima a pelos seus dados de acesso;
• Logo em seguida iremos colocar a senha de acesso:

• No próximo campo iremos inserir a “Query” que será executada no MySQL, no nosso teste usaremos a Query abaixo:

SHOW STATUS;

A Query “SHOW STATUS”, no MySQL, exibe variáveis de status do servidor, que são métricas em tempo real sobre o funcionamento do banco de dados. Ela retorna informações como:

1. Número de conexões ativas (Threads_connected).
2. Consultas executadas desde o início do serviço (Queries).
3. Tempo de atividade do servidor (Uptime).
4. Erros ocorridos (Aborted_connects).

Mas como o Uptime KUMA é somente um monitor de Uptime, no nosso caso ela será utilizada somente para saber se o serviço geral está acessível. Isso acontece porque na nossa String de conexão nós não definimos um banco específico para acesso, então caso o Uptime Kuma não consiga executar esta Query no MySQL, isso significa que o serviço está inacessível por algum motivo.

• Logo abaixo teremos algumas configurações como:
  • Intervalo de Heartbeat: esse será intervalo de tempo entre cada teste de conexão, no nosso caso o intervalo de tempo em segundos entre cada consulta no MySQL. O valor padrão (60 segundos) é na maioria das vezes suficiente, mas caso deseje alterar este valor pode fazer esta ação aqui;
  • Novas tentativas: número de novas tentativas em caso de falha, que o Uptime KUMA irá fazer antes de enviar uma notificação ao usuário;
  • Intervalo de repetição do Heartbeat: O Intervalo de tempo para uma nova tentativa em caso de falha;
  • Reenviar Notificação se OFFLINE X Vezes: A quantidade máxima de vezes em que a notificação será reenviada se o serviço estiver Offline.
  • Modo invertido: Inverte a verificação; Se o serviço estiver offline ele não enviará uma notificação, e se o serviço estiver online ele considerará como uma anomalia.
  • Monitor Group: Define o grupo de monitores em que o monitor que está sendo cadastrado estará;
  • Descrição: Você pode adicionar uma descrição para seu Monitor;
  • TAGS: Adicionar TAGS ao seu monitor;

Estas configurações podem ser alteradas posteriormente, como vamos montar um ambiente de teste iremos deixar estas configurações não valor padrão.

Após isso iremos clicar no botão salvar:

3. Criar Página de Status Personalizada

Para criar uma página de status personalizada no Uptime KUMA iremos seguir os seguintes passos:

• Clicar em “Página de Status” no canto superior direito:

• Em seguida em “Nova Página De Status”:

• Aqui iremos escolher o nome da página de status e o SLUG (Sufixo final EX: www.testedeuptime.com/MySQL):

Após escolher as informações da página iremos clicar em próximo:

• Nesta página temos muitas opções de configuração:
  • Barra Lateral:
    • Alterar o slug da página;
    • Alterar o título da página;
    • Adicionar uma descrição a página;
    • Modificar o texto de rodapé da página;
    • Escolher entre os temas claro, escuro ou automático;
    • Escolher mostrar ou não as TAGS dos monitores na página;
    • Manter ou remover a marca do Uptime KUMA do rodapé da página;
    • Mostrar se os certificados dos serviços que estão sendo monitorados (EX: certificados SSL de páginas web como, Sites) estão próximos de expirar;
    • Adicionar o nome dos domínios dos monitores;
    • Adicionar o ID do Google Analytics;
    • E inserir CSS personalizado;
  • Centro da página:
    • Mudar o logo da parte superior da página;
    • Criar um incidente;
    • Adicionar grupos de monitores a página;
    • Adicionar um monitor individual;

4. Vincular Monitor à Página

• Para adicionar o nosso monitor a nossa página de status, iremos clicar em “Adicionar Monitor” e então selecionaremos o monitor criado:

• Após adicioná-lo iremos clicar em salvar no canto inferior esquerdo:

Caso você queira personalizar a página de status conforme a sua necessidade, pode fazê-lo. No entanto, como nosso objetivo é fazer um teste, iremos apenas prosseguir.

Teste Prático: Simulando Falhas no MySQL

Agora que temos uma página de Status personalizada criada nos iremos simular uma falha no MySQL para isso iremos parar o serviço do MySQL:

• Recomendações:
  • Lembre-se de ter um usuário com privilégios administrativos no MySQL e no sistema operacional para fazer estes testes;
  • Não execute os comandos abaixo em bancos de dados ou servidores de produção, pois algum serviço importante pode ser afetado durante o processo de teste;
  • Faça este teste em seu computador local ou em um servidor de testes;

sudo systemctl stop mysql

sudo systemctl stop mysqld

sudo service mysql stop

net stop mysql

Verificando a falha na página de status

Após isso, ao retornar para a nossa página de status, o status do serviço deve mudar para offline:

Com isso, temos uma página pública para monitoramento do serviço de banco de dados. Caso queira, você pode criar vários monitores com queries diferentes para distintos tipos de operações, organizar monitores em grupos ou até mesmo criar múltiplas páginas para diversos serviços. O Uptime KUMA oferece grande versatilidade no monitoramento de uptime e, se desejar, ainda pode configurar notificações para mais de 78 serviços. Consulte a documentação oficial para mais detalhes: Documentação Oficial.

Conclusão

Monitorar o MySQL com o Uptime Kuma é uma solução eficiente para evitar paralisações críticas. Combinando simplicidade, alertas rápidos e transparência, a ferramenta ajuda a reduzir riscos operacionais e técnicos. Seja para pequenas aplicações ou grandes infraestruturas, essa abordagem garante que seu banco de dados permaneça sempre disponível.