Instale o agente New Relic eBPF para hosts Linux.

Você pode instalar o agente New Relic eBPF no seu host Linux para monitorar a integridade de todo o sistema. O agente eBPF fornece visibilidade profunda do desempenho do aplicativo sem exigir alterações de código ou implantar agente específico de linguagem.

Instale o agente New Relic eBPF.

Antes de você começar

Você deve atender aos pré-requisitos descritos na documentação de compatibilidade e requisitos do eBPF para hosts Linux.

Instalar o agente eBPF

Para instalar o agente eBPF:

Login em sua conta New Relic .
Vá para left navigation pane > + Integration & Agents > eBPF Agent.
Na tela Select an account, selecione a conta na qual deseja instalar o agente eBPF e clique em Continue.
Na página Select an installation method, selecione On a host e clique em Continue.
Na tela Enter your user key, selecione uma das seguintes opções e, em seguida, clique em Continue:
- Use an existing key: Se você já possui uma chave de usuário, forneça a chave de usuário. Para mais informações, consulte Chaves de usuário.
- Create a new key: Se você não tiver uma chave de usuário, clique em Create a new key para criar uma.
Na tela Configure the host integration, insira o nome da implantação para o host e, em seguida, clique em Continue.
Na tela Install the agent, execute o comando fornecido no seu terminal para instalar o agente eBPF via pacote Debian.
1. Copie e cole o comando exibido para instalar o agente eBPF em seu host Debian.
2. Para verificar a instalação, execute o seguinte comando:
  bash
```
$sudo systemctl status newrelic-ebpf-agent
```
Após a instalação bem-sucedida, o status desses serviços será exibido como ativo (em execução).
Dica
Você pode personalizar a configuração do agente eBPF editando o arquivo newrelic-ebpf-agent.yaml disponível em /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.yaml. Para obter mais informações sobre o parâmetro de configuração, consulte parâmetro de configuração.
Importante
On yum-based hosts, this installation command overwrites /etc/yum.repos.d/newrelic-infra.repo so that it points to a preview yum channel used to fetch the newrelic-ebpf-agent package. This replaces the baseurl that the infrastructure agent's own repository file normally uses, and affects RHEL-family hosts (RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux) as well as Amazon Linux (2, 2022, and 2023).
If you also manage the infrastructure agent or on-host integrations (for example nri-elasticsearch) through this same repository file, yum check-update may stop showing new versions for them after installing or upgrading the eBPF agent, because the preview channel carries a smaller, different package set.
To restore the standard update path for the infrastructure agent and its integrations, re-run the repository setup command for your OS from Add the infrastructure agent repository (RHEL-family) or Amazon Linux, then refresh the yum cache:
bash
```
$sudo yum clean all
$sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'
```
This doesn't affect Debian or Ubuntu hosts, where the eBPF agent is installed from a .deb package outside of the infrastructure agent's apt source list.

Acesse os dados do eBPF no New Relic

Depois que o agente eBPF estiver instalado, ele começará automaticamente a coletar dados do seu host Linux. Você pode acessar esses dados na interface de usuário OpenTelemetry do New Relic. Para obter mais informações sobre a interface OpenTelemetry New Relic, consulte Interface OpenTelemetry APM .

Para visualizar os dados do eBPF no New Relic:

Vá para one.newrelic.com > APM & Services.
No banner de pesquisa, defina os critérios de pesquisa como instrumentation.name = nr_ebpf:

Atualize o agente eBPF

Para atualizar o agente eBPF em um host Linux, execute novamente o comando de instalação na interface do usuário do New Relic. Este processo instalará a nova versão do agente e removerá automaticamente a versão anterior.

Importante

A atualização através de um gerenciador de pacotes não é suportada. Para uma atualização bem-sucedida, você deve usar o comando de instalação da interface do usuário do New Relic.

Importante

On yum-based hosts (RHEL-family and Amazon Linux), re-running the installation command also overwrites /etc/yum.repos.d/newrelic-infra.repo again. If you rely on that file to keep the infrastructure agent or its on-host integrations updated via yum, repeat the repository restore steps after each eBPF agent upgrade.

Para obter o comando de instalação mais recente:

Vá para one.newrelic.com > + Integration & Agents > eBPF Agent.
Siga o fluxo de instalação para obter o comando atualizado.
Execute o comando no seu host para atualizar o agente.
Reinicie o serviço do agente ebpf usando o comando abaixo:
bash
```
$sudo systemctl restart newrelic-ebpf-agent
```

Parâmetro de configuração

O arquivo newrelic-ebpf-agent.yaml contém os seguintes parâmetros de configuração:

Dica

O agente eBPF gera automaticamente nomes de entidades de forma diferente dependendo do ambiente:

Em hosts ou Docker, esses nomes são uma combinação do nome do processo, seu diretório ou ID do contêiner e a porta de escuta. Por exemplo, ruby:/home/ubuntu/app:[5678] ou java:f4aead533895:[8080].
No Kubernetes, esses nomes são derivados do nome do serviço, por exemplo, mysql-database-service.
Atribuindo nome personalizado ao aplicativo:
Você pode atribuir um nome personalizado à sua aplicação definindo a variável de ambiente NEW_RELIC_APP_NAME tanto para Kubernetes quanto para aplicações on-host.

Esses parâmetros controlam a identidade do núcleo e o destino dos dados para o agente eBPF.

Nome do parâmetro	Descrição	Tipo de dados	Valor de exemplo
`licenseKey`	Especifica sua chave de licença do New Relic, necessária para enviar dados.	Corda	`"22387565c...FFFFNRAL"`
`deploymentName`	Especifica um nome exclusivo para sua implantação para ajudar a identificar seus dados no New Relic.	Corda	`"my-deployment"`
`region`	Se estiver usando uma customSecretLicenseKey, você deve fornecer sua região `"US"` / `"EU"` / `"JP"` / `"GOV"` . Caso contrário, deixe esse valor como uma string vazia.	Corda	`""`
`customOtlpEndpoint`	URL do endpoint OTLP personalizado. Quando definido, isso tem precedência sobre os endpoints estáticos baseados em região.	Corda	`""`
`customOtlpEndpointTlsEnabled`	Se o TLS está habilitado no endpoint OTLP personalizado. Aplicável somente quando `customOtlpEndpoint` está definido.	Boleano	`true`
`customOtlpEndpointTlsCertPath`	Caminho para certificados CA personalizados para validação TLS do endpoint OTLP. Se vazio, os certificados CA padrão do sistema são usados.	Corda	`""`
`otlpProxy.host`	Nome do host do proxy HTTP/HTTPS para rotear dados de telemetria OTLP por meio de um proxy corporativo. Se vazio, nenhum proxy é usado.	Corda	`"proxy.example.com"`
`otlpProxy.port`	Porta do proxy para o proxy OTLP.	Inteiro	`""`
`otlpProxy.scheme`	Esquema de URL do proxy. Valores aceitos: `http` , `https` .	Corda	`"http"`
`otlpProxy.user`	Nome de usuário para autenticação básica do proxy. Se vazio, nenhuma autenticação é utilizada.	Corda	`""`
`otlpProxy.password`	Senha para autenticação básica de proxy. Usado apenas em conjunto com `otlpProxy.user` .	Corda	`""`
`otlpProxy.url`	URL completa do proxy. Quando definido, isso substitui as configurações individuais de `otlpProxy.host` , `port` , `scheme` , `user` e `password` . Formato: `http://[user:pass@]host:port` .	Corda	`""`
`logLevel`	Define o nível de log do agente. As opções são `OFF` , `FATAL` , `ERROR` , `WARNING` , `INFO` , `DEBUG` em ordem crescente de verbosidade.	Corda	`"INFO"`
`logFilePath`	Especifica o caminho do arquivo para logs do agente. Se estiver vazio ou o caminho for inválido, os logs serão enviados para a saída padrão (stdout).	Corda	`"/var/log/newrelic-ebpf-agent"`
`reportApmData`	Controla o relatório de dados de APM. Valores aceitos: `"true"` (sempre enviar), `"false"` (nunca enviar), `"auto"` (enviar apenas quando nem o agente APM nem o OTel estiver anexado).	Corda	`"auto"`
`reportNetworkMetrics`	Controla o relatório de métricas de rede. Quando habilitado, o agente coleta e relata métricas de rede, incluindo estatísticas TCP. Valores aceitos: `"true"` (sempre enviar), `"false"` (nunca enviar), `"auto"` .	Corda	`"auto"`
`reportLogs`	Controla o relatório de log de aplicativo. Valores aceitos: `"true"` (sempre enviar), `"false"` (nunca enviar), `"auto"` (enviar a menos que o agente APM anexado esteja coletando logs ativamente por si mesmo, ou um agente OTel esteja anexado). Consulte Detecção automática e recuo para obter detalhes.	Corda	`"false"`
`agentMetadataReporting`	Habilita o relatório de metadados do agente e da entidade. Por padrão, o agente exporta os metadados do agente e da entidade para a New Relic via HTTP. Defina como `false` para desabilitar totalmente o caminho de exportação HTTP do relatório de metadados.	Boleano	`true`
`ai_monitoring.enabled`	Controla o relatório de telemetria da GenAI. Valores aceitos: `"true"` (sempre enviar), `"false"` (nunca enviar), `"auto"` (enviar apenas quando nenhum APM de linguagem ou agente OTel já estiver relatando dados de AI Monitoring para a entidade).	Corda	`"false"`
`ai_monitoring.samplingLatency`	Define o limite de amostragem baseado em latência para exportar spans da GenAI. Suporta valores de `p0` a `p99` .	Corda	`"p50"`
`ai_monitoring.samplingErrorRate`	Define o limite da taxa de erros para uma rota da GenAI onde ultrapassá-lo significa que os spans correspondentes da rota são exportados. Opções: `1` – `100` .	Corda	`""`
`ai_monitoring.genAICaptureMessageContent`	Quando `true` , captura o conteúdo completo do prompt e da conclusão para interação do GenAI. Só entra em vigor quando `ai_monitoring.enabled` for `true` ou `auto` . Use com cautela.	Boleano	`false`
`httpPathNormalizationPatterns`	Define padrões de normalização de caminho HTTP. Cada padrão deve conter pelo menos um curinga `*` . Use um prefixo `!` para padrões de exclusão para preservar os caminhos como estão (ignorar o auto-cluster). O agente aplica esses padrões antes do auto-cluster e eles têm precedência sobre ele.	Lista	`["/api/users/", "/api/orders/", "!/health/*"]`
`httpBodyLimitBytes`	Define o número máximo de bytes capturados de um corpo de solicitação/resposta HTTP. Padrão: `1048576` (1 MB) quando `ai_monitoring.enabled` for `true` ou `auto` , caso contrário, `1024` (1 KB). Aumente esse valor se o New Relic truncar as cargas do AI Monitoring.	Inteiro	`2097152`
`includePortInServerEntityIdentification`	A configuração permite incluir ou excluir portas dos nomes de entidades descobertos automaticamente. Normalmente, os nomes aparecem como `processName:cwd/container_name:[port]` , por exemplo, `python:frosty_merkle:[80]` . Para excluir detalhes da porta, defina esta opção como `false` para nomes como `python:frosty_merkle` .	Boleano	`true`
`entityLabels`	Rótulos personalizados a serem adicionados a todas as entidades reportadas pelo agente eBPF. Esses rótulos aparecem como atributos `tags.*` no New Relic (por exemplo, `tags.environment` , `tags.datacenter` ).	Mapa	`{datacenter: "us-east-1", environment: "production"}`
`downloadedPackagedHeadersPath`	Define o caminho absoluto do diretório completo onde os cabeçalhos Linux necessários são baixados manualmente e colocados para uso pelo agente eBPF. Isso é útil em ambientes restritos onde o agente não consegue baixar os cabeçalhos Linux necessários. Os cabeçalhos necessários são identificados pelo agente com base na versão do kernel. Use somente após recomendação de suporte do NR.	Corda	`""`
`distroKernelHeadersPath`	Define o caminho absoluto do diretório completo onde os cabeçalhos do Linux estão presentes para o agente eBPF usar. Isso é útil quando os cabeçalhos Linux necessários não puderam ser instalados ou o caminho não pôde ser determinado. Use somente após recomendação de suporte do NR.	Corda	`""`

Importante

O eBPF agent suporta proxies HTTP CONNECT usando apenas o esquema http://. Devido a limitações do gRPC, o esquema https:// (uma conexão criptografada por TLS diretamente para o proxy) não é suportado. No entanto, seus dados de telemetria são sempre criptografados com TLS de ponta a ponta entre o agente e o endpoint OTLP da New Relic. O prefixo http:// determina apenas como o agente se comunica com o proxy para estabelecer o túnel. O próprio proxy vê apenas tráfego criptografado e nunca tem acesso aos seus dados. Para obter instruções completas de configuração, consulte Configurar um Proxy para o eBPF agent.

Configure filtros para descartar todos os tipos de dados (métricas de rede e dados APM) com base na configuração fornecida.

Nome do parâmetro	Descrição	Tipo de dados	Valor de exemplo
`allDataFilters.dropServiceNameRegex`	Padrão de expressão regular para corresponder nomes de entidades para descartar TODOS os dados (métricas de rede + dados APM). Por exemplo: `"java-app\|otel-collector\|\\bservice1\\b"` . Use dropServiceNameRegex ou keepServiceNameRegex para filtrar nomes de serviços, não ambos. Se ambos forem fornecidos, keepServiceNameRegex tem precedência.	Corda	`""`
`allDataFilters.keepServiceNameRegex`	Padrão de expressão regular para corresponder nomes de entidades para sempre manter TODOS os dados. Isso ignora todos os filtros de descarte. Por exemplo: `"critical-service\|important-app\|\\bmust-monitor\\b"` . Use dropServiceNameRegex ou keepServiceNameRegex para filtrar nomes de serviços, não ambos. Se ambos forem fornecidos, keepServiceNameRegex tem precedência.	Corda	`""`
`allDataFilters.dropApmAgentEnabledEntity`	Eliminar todos os dados de aplicações/entidades que tenham agentes APM NewRelic/OpenTelemetry em execução.	Boleano	`false`

Nome do parâmetro

Descrição

Tipo de dados

Valor de exemplo

allDataFilters.dropServiceNameRegex

Padrão de expressão regular para corresponder nomes de entidades para descartar TODOS os dados (métricas de rede + dados APM). Por exemplo:

"java-app|otel-collector|\\bservice1\\b"

. Use dropServiceNameRegex ou keepServiceNameRegex para filtrar nomes de serviços, não ambos. Se ambos forem fornecidos, keepServiceNameRegex tem precedência.

Corda

""

allDataFilters.keepServiceNameRegex

Padrão de expressão regular para corresponder nomes de entidades para sempre manter TODOS os dados. Isso ignora todos os filtros de descarte. Por exemplo:

"critical-service|important-app|\\bmust-monitor\\b"

. Use dropServiceNameRegex ou keepServiceNameRegex para filtrar nomes de serviços, não ambos. Se ambos forem fornecidos, keepServiceNameRegex tem precedência.

Corda

""

allDataFilters.dropApmAgentEnabledEntity

Eliminar todos os dados de aplicações/entidades que tenham agentes APM NewRelic/OpenTelemetry em execução.

Boleano

false

Configure filtros para descartar dados eBPF APM com base na configuração fornecida.

Nome do parâmetro	Descrição	Tipo de dados	Valor de exemplo
`apmDataFilters.dropEntityName`	Lista de nomes de entidades para descartar dados eBPF APM. Por exemplo: `["kube-dns", "otel-collector", "service1"]` .	Lista	`[]`
`apmDataFilters.keepEntityName`	Lista de nomes de entidades para sempre manter os dados do eBPF APM. Por padrão, todas as entidades são mantidas/habilitadas. Isso ignora o filtro `apmDataFilters.dropEntityName` . Por exemplo: `["critical-service", "important-app"]` .	Lista	`[]`
`apmDataFilters.jvmMetricsReporting`	Habilite o relatório de métricas da JVM. Quando habilitado, o agente coleta e reporta métricas da JVM para aplicações Java.	Boleano	`true`

Nome do parâmetro

Descrição

Tipo de dados

Valor de exemplo

apmDataFilters.dropEntityName

Lista de nomes de entidades para descartar dados eBPF APM. Por exemplo:

["kube-dns", "otel-collector", "service1"]

Lista

[]

apmDataFilters.keepEntityName

Lista de nomes de entidades para sempre manter os dados do eBPF APM. Por padrão, todas as entidades são mantidas/habilitadas. Isso ignora o filtro

apmDataFilters.dropEntityName

. Por exemplo:

["critical-service", "important-app"]

Lista

[]

apmDataFilters.jvmMetricsReporting

Habilite o relatório de métricas da JVM. Quando habilitado, o agente coleta e reporta métricas da JVM para aplicações Java.

Boleano

true

Configure filtros para descartar/manter dados de métricas de rede com base na configuração fornecida.

Nome do parâmetro	Descrição	Tipo de dados	Valor de exemplo
`networkMetricsDataFilter.dropEntityName`	Lista de nomes de entidades para descartar dados de métricas de rede. Por exemplo: `["kube-dns", "otel-collector", "service1"]` .	Lista	`[]`
`networkMetricsDataFilter.keepEntityName`	Lista de nomes de entidades para sempre manter os dados de métricas de rede. Por padrão, todas as entidades são mantidas/habilitadas. Isso ignora o filtro `networkMetricsDataFilter.dropEntityName` . Por exemplo: `["critical-service", "important-app"]` .	Lista	`[]`

Nome do parâmetro

Descrição

Tipo de dados

Valor de exemplo

networkMetricsDataFilter.dropEntityName

Lista de nomes de entidades para descartar dados de métricas de rede. Por exemplo:

["kube-dns", "otel-collector", "service1"]

Lista

[]

networkMetricsDataFilter.keepEntityName

Lista de nomes de entidades para sempre manter os dados de métricas de rede. Por padrão, todas as entidades são mantidas/habilitadas. Isso ignora o filtro

networkMetricsDataFilter.dropEntityName

. Por exemplo:

["critical-service", "important-app"]

Lista

[]

Configure filtros para controlar o log de aplicativo que o agente eBPF coleta e relata. Essas configurações só entram em vigor quando reportLogs é definido como "true" ou "auto".

Nome do parâmetro	Descrição	Tipo de dados	Valor de exemplo
`logDataFilters.applicationLogReporting.enabled`	Habilita a coleta de logs de entidades que correspondam aos filtros abaixo.	Boleano	`true`
`logDataFilters.applicationLogReporting.fileRegex`	Expressão regular para corresponder aos nomes de arquivos de log a serem incluídos.	Corda	`".*.log$"`
`logDataFilters.applicationLogReporting.logLevelThreshold`	Nível de log mínimo a relatar (por exemplo, `TRACE` , `DEBUG` , `INFO` , `WARN` , `ERROR` ).	Corda	`"INFO"`
`logDataFilters.applicationLogReporting.maxSamplesPerMinute`	Número máximo de amostras de log a coletar por minuto de uma entidade. Quando esse limite é atingido, os eventos são amostrados para manter uma distribuição uniforme ao longo do ciclo de coleta.	Inteiro	`10000`
`logDataFilters.applicationLogReporting.keepStdStreamEntityRegex`	Expressão regular para corresponder nomes de entidades para manter logs de STDOUT e STDERR. Use `.*` para encaminhar logs para todas as entidades.	Corda	`".*"`
`logDataFilters.applicationLogReporting.keepFileEntityRegex`	Expressão regular para corresponder nomes de entidades para manter logs de arquivos de log. Use `.*` para encaminhar logs para todas as entidades.	Corda	`".*"`

Esta seção permite que você habilite o monitoramento para protocolos de rede específicos e configure como os dados trace (spans) são coletados. Você pode habilitar ou desabilitar o monitoramento para protocolos como HTTP, MySQL e outros, e definir parâmetros para coleta de span com base em latência ou taxa de erros. Os seguintes protocolos são suportados:

HTTP
Thrift
MySQL
MariaDB
Aurora MySQL
PostgreSQL
MongoDB
Apache Cassandra
Redis
DynamoDB
MSSQL
Kafka
AMQP

DNS

O rastreamento do protocolo MySQL (protocols.mysql) também abrange o MariaDB e o Aurora MySQL, pois ambos os mecanismos usam o mesmo protocolo de rede que o MySQL. A configuração não requer uma seção mariadb ou aurora_mysql separada; ativar ou desativar protocols.mysql controla o rastreamento para todos os mecanismos suportados. O agente detecta automaticamente o tipo específico de banco de dados por conexão durante o handshake do servidor e o relata em cada registro. Você não pode configurar essa detecção manualmente.

Nome do parâmetro	Descrição	Tipo de dados	Valor de exemplo
`protocols.global.max_unlinked_spans`	Controla o número máximo de spans não vinculados relatados por protocolo. Defina como 0 para desabilitar o limite. Spans não vinculados são spans que o agente eBPF captura, mas não consegue associar ao seu pai.	Inteiro	`100`
`protocols.global.unlinked_spans_error_quota_percentage`	Reserva uma porcentagem configurável da cota de spans não vinculados para spans de erro, garantindo a visibilidade de erros mesmo quando spans normais chegam primeiro.	Inteiro	`30`
`protocols.<protocol-name>.enabled`	Se `true` , habilita o monitoramento para o protocolo especificado (por exemplo, `http` , `mysql` e quaisquer outros).	Boleano	`true`
`protocols.<protocol-name>.spans.enabled`	Se `true` , exporta intervalos trace para o protocolo habilitado.	Boleano	`true`
`protocols.<protocol-name>.spans.samplingLatency`	Define o limite de amostragem baseado em latência para exportar spans. Suporta valores de `p0` a `p99` .	Corda	`"p50"`
`protocols.<protocol-name>.spans.samplingErrorRate`	Somente para HTTP e Thrift. Exporta spans de qualquer rota onde a taxa de erro excede a porcentagem especificada (1-100).	Corda	`""`

Desinstale o agente eBPF.

Para desinstalar o agente eBPF de um host Linux, utilize as ferramentas de gerenciamento de pacotes do seu sistema:

bash

$sudo apt-get purge newrelic-ebpf-agent

Dica

Não é necessário interromper o serviço antes de executar o comando de desinstalação.

Instalação eBPF Kubernetes

Aprenda como configurar o agente New Relic eBPF para o seu cluster Kubernetes.

resolução de problemas eBPF

Aprenda a solucionar problemas com o agente eBPF da New Relic.

eBPF práticas recomenda

Conheça as práticas recomendadas para uso do agente New Relic eBPF.

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

Instale o agente New Relic eBPF para hosts Linux.