• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Compatibilidade e pré-requisitos

Visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de uma prévia, de acordo com nossas políticas de pré-lançamento.

Antes de iniciar o monitoramento do MySQL com o NRDOT, é necessário garantir que o ambiente atenda a estes requisitos.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

Versões MySQL suportadas

O receptor detecta o produto e a versão do banco de dados na primeira conexão e ajusta seu comportamento de acordo — versões não suportadas/mais antigas ainda funcionam, mas com funcionalidade reduzida:

Versões

Planos de consulta em

db.server.top_query

Propagação do traceparent

client.port

/

network.peer.port

Sintaxe de status de réplica

5.7.x

Não

Sim

0

SHOW SLAVE STATUS

8.0.0

8.0.2

Não

Sim

0

SHOW SLAVE STATUS

8.0.3

8.0.21

Sim

Sim

0

SHOW SLAVE STATUS

8.0.22+

Sim

Sim

Preenchido

SHOW REPLICA STATUS

8.4.x

Sim

Sim

Preenchido

SHOW REPLICA STATUS

9.x

Sim

Sim

Preenchido

SHOW REPLICA STATUS

Importante

A detecção de versão não é fatal: se falhar, o receptor reverte para o comportamento do MySQL < 8 em vez de apresentar erro.

Requisitos de acesso à rede

Por padrão, o NRDOT se conecta via TCP (transport: tcp na configuração do receptor, o padrão). Se o coletor for executado no mesmo host que o banco de dados, é possível definir transport: unix e apontar endpoint para o soquete de domínio Unix do banco de dados (por exemplo, /var/run/mysqld/mysqld.sock), o que evita totalmente as verificações de rede abaixo. Para qualquer outra implantação — coletor e banco de dados em hosts, contêineres ou VPCs diferentes — o TCP é necessário.

Implantação

O que verificar

MySQL autogerenciado no EC2

Grupo de segurança

: adicionar uma regra de entrada na porta do banco de dados (padrão

3306

) a partir da origem do coletor — seu próprio ID de grupo de segurança (mesma VPC, preferencial em relação a um IP bruto) se o coletor for executado em uma instância de EC2 diferente, ou nenhuma regra será necessária se for executado como um sidecar na mesma instância. Verificar também

bind-address

em

my.cnf

: muitos padrões de distribuição incluem

bind-address = 127.0.0.1

, que recusa qualquer conexão TCP não local — defini-lo para o IP privado da instância ou

0.0.0.0

antes que um coletor remoto possa alcançá-lo.

Amazon RDS / Aurora para MySQL

Grupo de segurança da VPC

: adicione uma regra de entrada na porta da instância do RDS (padrão

3306

) a partir do grupo de segurança ou IP privado do coletor; o RDS não possui

my.cnf

no nível do sistema operacional para editar, portanto, este é o único acesso de rede.

Permissões

devem vir do usuário mestre do RDS — o RDS não possui conta

root

.

Privilégios restritos

:

SUPER

e

FILE

são restritos ou indisponíveis dependendo da versão do mecanismo do RDS e do grupo de parâmetros.

TLS

: as instâncias do RDS com a imposição "Require SSL/TLS" precisam que o coletor confie na CA do Amazon RDS — defina

tls.ca_file

(ou

tls.ca_pem

) para o

pacote de certificados do Amazon RDS

e deixe

tls.insecure

/

tls.insecure_skip_verify

em

false

.

Qualquer implantação remota/entre hosts

O MySQL trata

'<user>'@'localhost'

e

'<user>'@'%'

(ou um host/CIDR específico) como

contas diferentes

, mesmo com um nome de usuário idêntico — criar o usuário de monitoramento como

'<user>'@'localhost'

falha silenciosamente ao autenticar a partir de um coletor em execução em qualquer outro lugar, com um erro de acesso negado indistinguível de uma senha incorreta. Utilize

'<user>'@'%'

ou restrinja-o ao IP/CIDR privado específico do coletor.

Importante

Verificado em uma instância ativa do Amazon RDS para MySQL: a família de grupos de parâmetros mysql8.0 do RDS não expõe nenhum parâmetro performance_schema_consumer_* — apenas parâmetros de dimensionamento/buffer, além de performance_schema, slow_query_log e long_query_time, podem ser definidos lá. Isso significa que events_waits_current (necessário para mysql.events_waits_current.timer_wait e dashboards baseados em espera em geral) só pode ser ativado em tempo de execução no RDS e não sobrevive a uma reinicialização ou failover.

Configuração no lado do servidor recomendada

Configure esses parâmetros do servidor MySQL para garantir que o receptor possa coletar todas as métricas e planos de consulta disponíveis. A tabela a seguir lista os parâmetros e os seus valores recomendados:

Parâmetro

Valor recomendado

Por que

performance_schema

Habilitado

Amostras de consulta, principais consultas e detecção de bloqueio dependem disso

max_digest_length

4096

Texto de resumo mais longo antes que o MySQL o trunque

performance_schema_max_digest_length

4096

O mesmo, na camada do esquema de desempenho

performance_schema_max_sql_text_length

4096

Se uma instrução capturada for truncada, o receptor ignora

EXPLAIN

para ela totalmente. Planos de consulta desaparecem silenciosamente para instruções longas no padrão de

1024

bytes

Próximos passos

Depois de verificar se o seu ambiente atende a estes pré-requisitos:

  1. Escolha o método de instalação:
  1. Revisar as métricas disponíveis que serão coletadas
  2. Consultar a configuração avançada para obter recursos opcionais, como planos de consulta de instrução de gravação e rastreamento de duração de espera de bloqueio
  3. Consulte o guia de resolução de problemas para problemas comuns
Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.