Identificação de serviço de banco de dados com NRDOT

Obtenha uma correlação perfeita entre o desempenho dos seus aplicativos e do banco de dados com comentários em consultas SQL. Este mecanismo permite que o receiver de banco de dados da Distribuição da New Relic para OpenTelemetry (NRDOT) identifique exatamente qual serviço é responsável por cargas específicas do banco de dados, consultas lentas ou eventos de bloqueio.

Importante

O New Relic vincula o monitoramento do desempenho de aplicativos (APM) do New Relic (New Relic APM) e as entidades de banco de dados comparando o endereço e a porta de conexão do banco de dados do seu aplicativo com o endereço e a porta de conexão do agente de monitoramento de banco de dados. Essa vinculação funciona de forma confiável quando ambos os lados relatam exatamente o mesmo endereço e porta. No entanto, a vinculação automática pode falhar se o seu aplicativo rotear o tráfego por meio de um balanceador de carga ou proxy, ou se os dois componentes usarem formatos de endereço diferentes (como um endereço IP em vez de um nome de domínio).

Pré-requisitos

Agente Java: versão 9.1.0 ou posterior.
Agente .NET: versão 10.52.0 ou posterior.

Habilitar correlação APM-DB para o agente Java

Para habilitar essa correlação, adicione a propriedade sql_metadata_comments à seção transaction_tracer do seu arquivo de configuração do agente Java (newrelic.yml). Para mais informações, consulte a documentação de configuração do agente Java.

transaction_tracer:
  sql_metadata_comments: nr_service_guid

Habilitar correlação APM-DB para o agente .NET

Para habilitar essa correlação, adicione a propriedade sqlMetadataComments à seção transactionTracer do seu arquivo de configuração do agente .NET (newrelic.config). Para mais informações, consulte a documentação de configuração do agente .NET.

Se você estiver usando um script de inicialização ou wrapper para lançar seu executável, defina a variável NEW_RELIC_TRANSACTION_TRACER_SQL_METADATA_COMMENTS_ENABLED como 1.

# Add this environment variable alongside your other CoreCLR / New Relic variables
$env:NEW_RELIC_TRANSACTION_TRACER_SQL_METADATA_COMMENTS_ENABLED = "1"

Como funciona

Quando sua aplicação envia uma consulta ao banco de dados, o agente APM insere automaticamente um GUID de entidade APM no início do texto SQL como um comentário. Essa prática comum na indústria não afeta a lógica de execução das suas instruções SQL.

Prefixação de comentários: O agente APM prefixa uma string de comentário ao SQL de saída (por exemplo, /* nr_service_guid="MTE2MDAzMTl8QVBNfEFQUExJ" */ SELECT * FROM orders...).
Execução: O banco de dados executa a consulta normalmente. O comentário é armazenado nos esquemas de desempenho internos do banco de dados (como sys.dm_exec_requests ou v$session).
Extração: O receptor do banco de dados busca essas consultas (ativas, lentas ou bloqueantes).
Enriquecimento: O receptor analisa o comentário, extrai o nr_service_guid e o anexa como uma dimensão às suas métricas de banco de dados.

Benefícios da etiquetagem de serviços

Adicionar metadados de serviço no início oferece visibilidade de alta fidelidade do seu ecossistema de banco de dados:

Atribuição em nível de serviço: Veja instantaneamente qual microsserviço é responsável por um pico na CPU ou memória do banco de dados
Análise refinada de consultas lentas: filtre os logs de consultas lentas por client_name para entender se um gargalo no banco de dados está isolado em uma versão específica do aplicativo
Resolução de bloqueios e deadlocks: Identifique rapidamente o "proprietário" de uma consulta bloqueadora para agilizar a solução de problemas entre equipes

Impacto na segurança e no desempenho

Projetamos este mecanismo para ser invisível às suas operações de banco de dados:

Recurso	Detalhes do impacto
Lógica de execução	O otimizador do mecanismo de banco de dados ignora comentários SQL
Sobrecarga de banco de dados	A adição de uma string curta (tipicamente com menos de 50 caracteres) tem impacto insignificante na largura de banda da rede ou na memória
Dados privados	Apenas o GUID do serviço é inserido. Nenhum dado sensível da aplicação ou contexto do usuário está incluído no comentário

Gerenciamento de segredos

Você pode usar dois métodos seguros para gerenciar credenciais confidenciais (como senhas de banco de dados) na configuração do NRDOT Collector. Escolha o método que melhor se alinha à sua infraestrutura e políticas de segurança.

Criptografia AES (agnóstico de plataforma)

Este método permite armazenar credenciais criptografadas diretamente em seus arquivos de configuração, suportando fluxos de trabalho de controle de versão (GitOps).

Como funciona: Strings sensíveis são criptografadas usando AES-256 (modo GCM) offline. O coletor os descriptografa em tempo de execução usando uma chave mestra armazenada nas variáveis de ambiente do servidor
Benefício de segurança: Arquivos de configuração podem ser compartilhados ou enviados para repositórios com segurança, sem expor senhas em texto simples

Ideal para: Ambientes híbridos/multi-cloud, desenvolvimento local ou servidores Windows onde a integração com o OCI Vault não é viável

Exemplo de configuração

receivers:
  newrelicoracledb/cdb:
    endpoint: "10.x.x.36:1521"
    # Credentials are encrypted using the offline helper tool
    username: "${aes:YOUR_ENCRYPTED_USERNAME_STRING}"
    password: "${aes:YOUR_ENCRYPTED_PASSWORD_STRING}"
    service: "DB1104.privatesubnet.oracledb.oraclevcn.com"
    collection_interval: 15s

Gerenciador de segredos da AWS

Este método permite recuperar credenciais com segurança diretamente do AWS Secrets Manager em tempo de execução, eliminando completamente a necessidade de armazenar senhas nos seus arquivos de configuração.

Como funciona: O NRDOT Collector usa uma função do AWS IAM para se autenticar automaticamente e buscar os segredos necessários do AWS Secrets Manager durante a inicialização.
Benefício de segurança: Nenhum dado confidencial é armazenado em disco ou no controle de versão. O acesso é estritamente regido por políticas do AWS IAM, e as credenciais do banco de dados podem ser rotacionadas centralmente sem a necessidade de atualizar ou implantar novos arquivos de configuração
Ideal para: Ambientes de produção executados nativamente na AWS onde o gerenciamento centralizado de segredos, a auditoria de conformidade e a rotação automatizada são necessários
Exemplo de configuração
```
receivers:
  newrelicoracledb/pdb:
    endpoint: "10.x.x.36:1521"
    # Syntax: ${secretsmanager:SecretName#JSONKey}
    username: "${secretsmanager:oracle/credentials#username}"
    password: "${secretsmanager:oracle/credentials#password}"
    service: "PDBTEST"
```
Nota: Defina a Região da AWS:
bash
```
$export AWS_REGION=your-aws-region
```

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

Identificação de serviço de banco de dados com NRDOT

Importante

Pré-requisitos

Habilitar correlação APM-DB para o agente Java

Habilitar correlação APM-DB para o agente .NET

Opção 1: via variáveis de ambiente (script)

Opção 2: via newrelic.config

Como funciona

Benefícios da etiquetagem de serviços

Impacto na segurança e no desempenho

Gerenciamento de segredos

Criptografia AES (agnóstico de plataforma)

Criptografia AES (agnóstico de plataforma)

Exemplo de configuração

Gerenciador de segredos da AWS

Gerenciador de segredos da AWS

Exemplo de configuração

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

Identificação de serviço de banco de dados com NRDOT

Importante

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Habilitar correlação APM-DB para o agente Java

Habilitar correlação APM-DB para o agente .NET

Opção 2: via newrelic.config

Como funciona

Benefícios da etiquetagem de serviços

Impacto na segurança e no desempenho

Gerenciamento de segredos

Criptografia AES (agnóstico de plataforma)

Gerenciador de segredos da AWS

Pré-requisitos