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.

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.

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 o seguinte parâmetro 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 usar uma customSecretLicenseKey, você deve fornecer sua região `"US"` / `"EU"` . Caso contrário, deixe este 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	`""`
`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"`
`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	`""`

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

[]

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
PostgreSQL
MongoDB
Apache Cassandra
Redis
DynamoDB
MSSQL
Kafka
AMQP

DNS

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 exportação de intervalos. Opções válidas: `p1` , `p10` , `p50` , `p90` , `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.