Habilitar insights detalhados

É possível configurar as seguintes opções para obter insights mais profundos sobre as instâncias do MySQL:

• Monitorar um banco de dados específico
• Habilitar TLS
• Planos de consulta para instruções de gravação
• Habilitar o rastreamento da duração da espera de bloqueio

Monitorar um banco de dados específico

Por padrão, o campo database é omitido da configuração do receiver, e o receiver monitora todos os bancos de dados que o usuário de monitoramento pode acessar. Para restringir o monitoramento a um único schema, defina database como o nome desse schema:

receivers:
  nrmysql:
    endpoint: <YOUR_HOST>:<YOUR_PORT>
    username: <YOUR_DB_USERNAME>
    password: <YOUR_DB_PASSWORD>
    database: <YOUR_DATABASE_NAME>
    collection_interval: 30s

Habilitar TLS

O campo tls é opcional, mas omiti-lo não é o mesmo que desativar o TLS explicitamente: a configuração padrão do receptor define insecure: true, portanto, as conexões não são criptografadas a menos que você mesmo configure tls. A maioria das instâncias do Amazon RDS e do Aurora exige SSL/TLS, portanto, você normalmente precisará adicionar este bloco para esses ambientes.

receivers:
  nrmysql:
    endpoint: <YOUR_HOST>:<YOUR_PORT>
    username: <YOUR_DB_USERNAME>
    password: <YOUR_DB_PASSWORD>
    collection_interval: 30s
    tls:
      insecure: false
      insecure_skip_verify: false
      ca_file: <PATH_TO_CA_CERTIFICATE>

Planos de consulta para instruções de gravação

Definir explain_mode como procedure permite que o NRDOT Collector colete planos de EXPLAIN para instruções de gravação sem conceder privilégios DML ao usuário de monitoramento. Quando configurado, o receptor procura um procedimento SQL SECURITY DEFINER chamado <schema>.explain_statement. Se esse procedimento não existir ou se o usuário de monitoramento não tiver privilégios de execução sobre ele, o receptor reverterá para o modo inline. Nesse estado, as instruções de gravação falham ao coletar planos de consulta, e o log do coletor exibe o seguinte aviso: unable to execute explain statement.

Para definir o explain_mode como procedure, é necessário executar o seguinte como uma conta privilegiada (por exemplo, root) uma vez por esquema:

DELIMITER //
CREATE DEFINER = 'root'@'%' PROCEDURE <YOUR_SCHEMA>.explain_statement(IN q TEXT)
SQL SECURITY DEFINER
BEGIN
  SET @nr_explain_sql = CONCAT('EXPLAIN FORMAT=JSON ', q);
  PREPARE nr_explain_stmt FROM @nr_explain_sql;
  EXECUTE nr_explain_stmt;
  DEALLOCATE PREPARE nr_explain_stmt;
END//
DELIMITER ;
GRANT EXECUTE ON PROCEDURE <YOUR_SCHEMA>.explain_statement TO '<YOUR_DB_USERNAME>'@'%';

A etapa GRANT EXECUTE é necessária para mais do que executar a instrução CALL. Sem esse privilégio, o usuário de monitoramento não pode visualizar o procedimento em information_schema.ROUTINES, que o receptor usa para verificar a existência. Omitir GRANT EXECUTE produz o mesmo resultado que um procedimento ausente, fazendo com que o receptor reverta para o modo inline em ambos os casos.

Habilitar o rastreamento da duração da espera de bloqueio

O consumidor events_waits_current fornece informações sobre a duração da espera de bloqueio, mas requer configuração específica da plataforma:

Documentação relacionada