Instalar e configurar a integração do New Relic eBPF

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. Não está disponível para clientes sujeitos às regulamentações HIPAA ou FedRAMP.

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.

Compatibilidade e requisitos

Versões do kernel Linux 5.4 e posteriores.
Privilégios de root
Apoie arm64 e x86-64 arquitetura.
É necessário um mínimo de 2 GB de RAM para instalação do host.
Suporta as seguintes distribuições:
- Ubuntu 20.04 e posterior
- Debian 11 e posterior
- CentOS Stream 9 e posterior
- RHEL 8 e posterior

Instalar o agente eBPF

Para instalar o agente eBPF:

Login em sua conta New Relic .
Vá para o painel de navegação esquerdo > + Integration & Agents > eBPF Agent.
Na tela Selecionar uma conta, selecione a conta na qual deseja instalar o agente eBPF e clique em Continue.
Na página Selecionar um método de instalação, selecione On a host e clique em Continue.
Na tela Insira sua chave de usuário, selecione uma das seguintes opções e clique em Continue:
- Usar uma chave existente: Se você já tiver uma chave de usuário, forneça-a. Para obter mais informações, consulte Chaves do usuário.
- Criar uma nova chave: se você não tiver uma chave de usuário, clique em Create a new key para criar uma.
Na tela Configurar a integração do host, insira o nome da implantação do host e clique em Continue.
Na tela Instalar o agente, execute o comando fornecido no seu terminal para instalar o agente eBPF.
1. Copie e cole o comando exibido para instalar o agente eBPF no seu host.
2. Para verificar a instalação, execute o seguinte comando:
  - Para agente eBPF:
    bash
```
$sudo systemctl status newrelic-ebpf-agent
```
  - Para cliente eBPF:
    bash
```
$sudo systemctl status newrelic-ebpf-agent-client
```
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.conf disponível em /etc/newrelic-ebpf-agent/newrelic-ebpf-agent.conf. 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:

Acesse one.newrelic.com > APM e serviços.
No banner de pesquisa, defina os critérios de pesquisa como instrumentation.name = nr_ebpf:

Configurar o painel eBPF

O dashboard de rede eBPF fornece visibilidade profunda sobre a integridade da rede do seu sistema rastreando métricas críticas de DNS e TCP diretamente do kernel. Você pode diagnosticar problemas de conectividade analisando as taxas de sucesso e falha de resoluções de DNS e conexões TCP. Identifique o desempenho gargalo monitorando latências importantes como handshakes TCP, entrega de pacotes e duração de conexões de curta duração. O dashboard também ajuda você a rastrear taxas de transferência de dados visualizando bytes enviados, recebidos e quaisquer pacotes descartados.

Para configurar o dashboard de rede eBPF:

Acesse one.newrelic.com > Dashboards.
Nos Dashboards, clique em + Create a dashboard.
Na janela Create a dashboard, clique em Browse pre-built dashboards.
Na barra de pesquisa, digite eBPF e selecione eBPF.
(Opcional) Na janela exibida, clique em Edit para alterar a conta.
Clique em Setup eBPF Agent para configurar a fonte de dados ou clique em Skip this step se o agente eBPF já estiver configurado.
Clique em View dashboard para visualizar os dados coletados pelo agente eBPF.

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.

/* * Encontre sua entidade em <DNT>**Todos os serviços da entidade - OpenTelemetry</DNT>. O nome da entidade é definido como o valor do `service.name` do aplicativo atributo de recurso. Para obter mais informações sobre como as entidades de serviço New Relic são derivadas do atributo de recurso OpenTelemetry, consulte [Serviços](/docs/OpenTelemetry/práticas recomendadas/OpenTelemetry-práticas recomendadas-resources/#services). * Use [NRQL](/docs/NRQL/get-started/introduction-NRQL (New Relic Query Language)/) para consultar diretamente [rastreamento](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gU3BhbiBTRUxFQ1QgY291bnQoKikgd2hlcmU gbmV3cmVsaWMuc291cmNlPSclb3RscCUnIFRJTUVTRVJJRVMifV0sImluaXRpYWxDaGFydFNldHRpbmdzIjp7ImNoYXJ0VHlwZSI6IkNIQVJUX0xJTkUiLCJsaW1pdCI6NzU0MiwibGlua2VkRW50aXR5R3VpZCI6bnVsbCwibGlua2VkRGFzaGJvYXJkSWQiOm51bGwsInlTY2FsZSI6eyJzdGF0aWMiOmZhbHNlLCJkb21haW4iOltudWxsLG51bGxdfSwieVplcm8iOnRydWV9fQo=), [métrica](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTWV0cmljIFNFTEVDVCBjb3VudCgqKSB3aGVyZS BuZXdyZWxpYy5zb3VyY2UgTElLRSAnJW90bHAlJyBUSU1FU0VSSUVTIN1dLCJpbml0aWFsQ2hhcnRTZXR0aW5ncyI6eyJjaGFydFR5cGUiOiJDSEFSVF9MSU5FIiwibGltaXQiOjc1NDIsImxpbmtlZEVudGl0eUd1aWQiOm51bGwsImxpbmtlZERhc2hib2FyZElkIjpudWxsLCJ5U2NhbGUiOnsic3RhdGljIjpmYWxzZSwiZG9tYWluIjpbbnVsbCxudWxsXX0sInlaZXJvIjp0cnVlfX0K), e [logs](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTG9nIFNFTEVDVCBjb3VudCgqKSB3aGVyZSB uZXdyZWxpYy5zb3VyY2U9JyVvdGxwJScgVElNRVNFUklFUyJ9XSwiaW5pdGlhbENoYXJ0U2V0dGluZ3MiOnsiY2hhcnRUeXBlIjoiQ0hBUlRfTElORSIsImxpbWl0Ijo3NTQyLCJsaW5rZWRFbnRpdHlHdWlkIjpudWxsLCJsaW5rZWREYXNoYm9hcmRJZCI6bnVsbCwieVNjYWxlIjp7InN0YXRpYyI6ZmFsc2UsImRvbWFpbiI6W251bGwsbnVsbF19LCJ5WmVybyI6dHJ1ZX19Cg==). * Consulte [Interface OpenTelemetry APM ](/docs/OpenTelemetry/get-started/APM-monitoramento/OpenTelemetry-APM-interface) para obter mais informações. Caso não encontre sua entidade e não veja seus dados com NRQL, consulte [OTLP resolução de problemas](/docs/OpenTelemetry/práticas recomendadas/OpenTelemetry-otlp-resolução de problemas). Você pode encontrar os dados coletados pelo agente eBPF na interface do usuário Opentelementry do New Relic. */

Parâmetro de configuração

O arquivo newrelic-ebpf-agent.conf contém o seguinte parâmetro de configuração:

Nome do parâmetro	Descrição	Tipo de dados	Valor de exemplo
`NEW_RELIC_LICENSE_KEY`	Especifica sua chave de licença do New Relic, necessária para enviar dados.	`String`	`22387565c...FFFFNRAL`
`DEPLOYMENT_NAME`	Especifica um nome exclusivo para sua implantação para ajudar a identificar seus dados no New Relic.	`String`	`fe`
`OTLP_ENDPOINT`	Define o endpoint OTLP para onde o agente envia dados de telemetria.	`String (Host:Port)`	`staging-otlp.nr-data.net:4317`
`NEW_RELIC_LOG_LEVEL`	Define o nível de log do agente. As opções são `OFF` , `FATAL` , `ERROR` , `WARNING` , `INFO` , `DEBUG` em ordem crescente de verbosidade.	`String`	`INFO`
`NEW_RELIC_LOG_FILE_PATH`	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).	`String (Path)`	`""`
`DROP_DATA_FOR_ENTITY`	Fornece uma lista separada por vírgulas de valores `NEW_RELIC_APP_NAME` . O agente removerá dados de processos que correspondem a esses nomes de aplicativos.	`String`	`""`
`TLS_ENABLED`	Habilita ou desabilita o TLS para comunicação entre o cliente e o agente eBPF.	`String`	`"true"`
`TLS_AUTOGENERATE_CERT_ENABLED`	Se definido como `true` , gera automaticamente um certificado autoassinado para TLS. Defina como `false` se você estiver fornecendo seus próprios certificados.	`String`	`"true"`
`TLS_CERT_PATH`	Especifica o caminho do diretório onde os certificados TLS gerados automaticamente são armazenados.	`String (Path)`	`/tmp/ebpf/certs/`
`TLS_CERT_FILE`	Especifica o caminho para seu arquivo de certificado público codificado em PEM personalizado. Obrigatório se `TLS_AUTOGENERATE_CERT_ENABLED` for `false` .	`String (Path)`	`""`
`TLS_KEY_FILE`	Especifica o caminho para seu arquivo de chave privada codificado em PEM personalizado. Obrigatório se `TLS_AUTOGENERATE_CERT_ENABLED` for `false` .	`String (Path)`	`""`
`TLS_CA_FILE`	Especifica o caminho para seu arquivo de Autoridade de Certificação (CA) codificado em PEM personalizado. Obrigatório se `TLS_AUTOGENERATE_CERT_ENABLED` for `false` .	`String (Path)`	`""`
`TABLE_STORE_DATA_LIMIT_MB`	Define a memória máxima (em MiB) que o agente eBPF pode usar para seu armazenamento de tabela de dados interno. Esta é a principal maneira de controlar o uso de RAM do agente.	Inteiro	`250`
`PROTOCOLS_HTTP_ENABLED`	Habilita ou desabilita todo o rastreamento do protocolo HTTP (métrica e spans).	`String`	`"true"`
`PROTOCOLS_HTTP_SPANS_ENABLED`	Habilita ou desabilita a exportação de spans para requests HTTP.	`String`	`"true"`
`PROTOCOLS_HTTP_SPANS_SAMPLING_LATENCY`	Define o limite de latência de amostragem para exportar intervalos HTTP. Os períodos para requests mais lentas que esse percentual são exportados. Opções: `p1` , `p10` , `p50` , `p90` , `p99` .	`String`	`"p50"`
`PROTOCOLS_HTTP_SPANS_SAMPLING_ERROR_RATE`	Define uma porcentagem de taxa de erros (1-100) para uma rota HTTP. Se a taxa de erros de uma rota exceder esse valor, seus trechos correspondentes serão exportados.	`String`	`""`
`PROTOCOLS_MYSQL_ENABLED`	Habilita ou desabilita todo o rastreamento do protocolo MySQL.	`String`	`"true"`
`PROTOCOLS_MYSQL_SPANS_ENABLED`	Habilita ou desabilita a exportação de spans para consulta MySQL.	`String`	`"false"`
`PROTOCOLS_PGSQL_ENABLED`	Habilita ou desabilita todo o rastreamento do protocolo PostgreSQL.	`String`	`"true"`
`PROTOCOLS_PGSQL_SPANS_ENABLED`	Habilita ou desabilita a exportação de spans para consulta do PostgreSQL.	`String`	`"false"`
`PROTOCOLS_CASS_ENABLED`	Habilita ou desabilita todo o rastreamento do protocolo Cassandra.	`String`	`"true"`
`PROTOCOLS_CASS_SPANS_ENABLED`	Habilita ou desabilita a exportação de spans para a Cassandra consulta.	`String`	`"false"`
`PROTOCOLS_REDIS_ENABLED`	Habilita ou desabilita todo o rastreamento do protocolo Redis.	`String`	`"true"`
`PROTOCOLS_REDIS_SPANS_ENABLED`	Habilita ou desabilita a exportação de spans para comandos do Redis.	`String`	`"false"`
`PROTOCOLS_MONGODB_ENABLED`	Habilita ou desabilita todo o rastreamento do protocolo MongoDB.	`String`	`"true"`
`PROTOCOLS_MONGODB_SPANS_ENABLED`	Habilita ou desabilita a exportação de spans para consulta do MongoDB.	`String`	`"false"`
`PROTOCOLS_KAFKA_SPANS_ENABLED`	Habilita ou desabilita a exportação de intervalos para mensagens do Kafka. Observação: o rastreamento do Kafka não relata métrica.	`String`	`"false"`
`PROTOCOLS_AMQP_SPANS_ENABLED`	Habilita ou desabilita a exportação de intervalos para mensagens AMQP (por exemplo, RabbitMQ). Observação: o rastreamento AMQP não relata métrica.	`String`	`"false"`
`PROTOCOLS_DNS_SPANS_ENABLED`	Habilita ou desabilita a exportação de spans para consulta de DNS. Observação: o rastreamento de DNS não relata métrica.	`String`	`"false"`

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

Instalar e configurar a integração do New Relic eBPF

Visualização

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

Instalar o agente eBPF

Dica

Acesse os dados do eBPF no New Relic

Configurar o painel eBPF

Dica

Parâmetro de configuração

Compatibilidade e requisitos