• /
  • 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

Modificar configuração do agente

|View as Markdown (English)

Para que o gateway processe os dados de telemetria dos seus agentes, reconfigure-os para rotear os dados para o seu cluster de gateway em vez de diretamente para a New Relic. A forma de fazer isso depende do tipo de agente: os agentes New Relic APM usam NEW_RELIC_HOST, as fontes OpenTelemetry usam as configurações de exportador OTLP e os encaminhadores de logs usam sua própria configuração de plug-in de saída. As seções abaixo abordam cada tipo de agente. Todos os exemplos usam o endpoint do gateway local do cluster. Substitua-o pelo seu endpoint real se os agentes forem executados fora do cluster.

Agente New Relic APM

NEW_RELIC_HOST é exclusivo do APM e não tem efeito nas fontes do OpenTelemetry, no agente de infraestrutura ou nos encaminhadores de logs. O endpoint do gateway deve ser acessível por HTTPS, para que os agentes APM se conectem através do proxy reverso no cluster (NGINX ou Kong) ou do ALB fora do cluster, não diretamente ao pod do gateway.

O exemplo a seguir mostra um arquivo de configuração do agente Node.js:

'use strict'
/**
* New Relic agent configuration.
*
* See lib/config/default.js in the agent distribution for a more complete
* description of configuration variables and their potential values.
*/
exports.config = {
/**
* Array of application names.
*/
app_name: ['My Application'],
/**
* Your New Relic Host endpoint.
*/
NEW_RELIC_HOST: 'GATEWAY_DNS_ENDPOINT_HERE',
/**
* Your New Relic license key.
*/
license_key: 'license key here',
logging: {
/**
* Level at which to log. 'trace' is most useful to New Relic when diagnosing
* issues with the agent, 'info' and higher will impose the least overhead on
* production applications.
*/
level: 'info'
},
/**
* When true, all request headers except for those listed in attributes.exclude
* will be captured for all traces, unless otherwise specified in a destination's
* attributes include/exclude lists.
*/
allow_all_headers: true,
attributes: {
/**
* Prefix of attributes to exclude from all destinations. Allows * as wildcard
* at end.
*
* NOTE: If excluding headers, they must be in camelCase form to be filtered.
*
* @name NEW_RELIC_ATTRIBUTES_EXCLUDE
*/
exclude: [
'request.headers.cookie',
'request.headers.authorization',
'request.headers.proxyAuthorization',
'request.headers.setCookie*',
'request.headers.x*',
'response.headers.cookie',
'response.headers.authorization',
'response.headers.proxyAuthorization',
'response.headers.setCookie*',
'response.headers.x*'
]
}
}

Coletor OpenTelemetry

Versão mínima: opentelemetry-collector-contrib v0.104.0

Use o exportador otlphttp apontado para a porta HTTP OTLP do gateway. Implante esta configuração como um ConfigMap do Kubernetes:

exporters:
otlphttp:
endpoint: http://pipeline-control-gateway.newrelic.svc.cluster.local:4318
tls:
insecure: true
service:
pipelines:
traces:
exporters: [otlphttp]
metrics:
exporters: [otlphttp]
logs:
exporters: [otlphttp]

Importante

Use o exportador otlphttp, não otlp. O chart do Helm renomeia otlp para otlp_grpc internamente, o que é inválido para esta versão do coletor.

agente de anexação automática do eBPF

Configure o agente de anexação automática do APM eBPF para enviar telemetria via OTLP gRPC definindo customOtlpEndpoint em seu arquivo de valores:

customOtlpEndpoint: "pipeline-control-gateway.newrelic.svc.cluster.local:4317"
customOtlpEndpointTlsEnabled: false
reportLogs: "true"

Isso roteia tanto as métricas quanto os logs pelo receptor OTLP gRPC do gateway na porta 4317. O TLS está desativado porque a conexão permanece dentro do cluster.

Agente de infraestrutura

Versão mínima: v1.62.0

Três chaves de configuração controlam qual telemetria o agente de infraestrutura roteia pelo gateway:

  • collector_url — roteia amostras de infraestrutura (como SystemSample e ProcessSample) e inventário. O gateway processa amostras. O inventário é repassado para a New Relic sem alterações (URL base, sem caminho final).
  • metric_url — roteia métricas dimensionais (URL base, sem caminho final).
  • logging_endpoint — roteia logs (URL completa, incluindo /log/v1).

Para rotear toda a telemetria do agente pelo gateway, defina collector_url, metric_url e logging_endpoint (no Kubernetes, defina newrelic-logging.endpoint em vez de logging_endpoint). collector_url e metric_url sozinhos não roteiam logs.

Importante

O registro do agente (identity-api.newrelic.com) e o canal de comando (infrastructure-command-api.newrelic.com) sempre se conectam diretamente à New Relic — eles ignoram o gateway, independentemente dessas configurações. Os hosts ainda precisam de saída para ambos os endpoints.

Rotear amostras de infraestrutura, métricas e inventário pelo gateway

Kubernetes (valores do Helm do nri-bundle):

newrelic-infrastructure:
common:
agentConfig:
collector_url: "http://pipeline-control-gateway.newrelic.svc.cluster.local"
metric_url: "http://pipeline-control-gateway.newrelic.svc.cluster.local"

Host (/etc/newrelic-infra.yml):

license_key: YOUR_LICENSE_KEY
collector_url: http://GATEWAY_ADDRESS
metric_url: http://GATEWAY_ADDRESS

Substitua GATEWAY_ADDRESS por pipeline-control-gateway.newrelic.svc.cluster.local para agentes em execução dentro do cluster, ou pelo endereço do balanceador de carga do gateway para agentes em hosts externos.

Rotear logs pelo gateway

Nas implantações nri-bundle do Kubernetes, o encaminhamento de logs é gerenciado pelo chart newrelic-logging, não pelo agente de infraestrutura. Defina o endpoint de logging nos seus valores do Helm:

newrelic-logging:
endpoint: "http://pipeline-control-gateway.newrelic.svc.cluster.local/log/v1"

Para instalações baseadas em host, defina logging_endpoint em /etc/newrelic-infra.yml:

license_key: YOUR_LICENSE_KEY
logging_endpoint: http://pipeline-control-gateway.newrelic.svc.cluster.local/log/v1

Use http:// para o endpoint local do cluster. Use https:// apenas ao rotear através de um proxy reverso no cluster (NGINX ou Kong) com o cert-manager implantado.

Em seguida, defina quais arquivos de log encaminhar em /etc/newrelic-infra/logging.d/logging.yml:

logs:
- name: my-app-logs
file: /var/log/my-app.log

Reinicie o agente de infraestrutura para aplicar as alterações.

Matriz de compatibilidade: Agentes e versões suportados

A tabela a seguir lista os agentes do New Relic APM, agentes de infraestrutura e coletores de logs suportados para uso com o gateway. Observe que o suporte para o recurso Gateway não substitui as políticas gerais de fim de vida útil (EOL) da New Relic ou quaisquer políticas de EOL específicas do agente.

Tipo de agente/Linguagem

Versões disponíveis

Agente New Relic APM

Veja as versões específicas da linguagem abaixo:

    .NET

8.17.438 e posteriores

    Go

2.2.0 e posterior

    Java

4.9.0 e posterior

    NodeJS

6.10.0 e posterior

    PHP

10.0.0 e posterior

    Python

4.10.0 e posterior

    Ruby

6.1.0 e depois

Agente de infraestrutura

1.62.0 e posteriores

Agente do Kubernetes

v3.33.2 e posterior

Agente Fluent Bit

2.3.0 e posterior

Coletor OpenTelemetry

opentelemetry-collector-contrib v0.104.0 e posterior

APIs MELT

N / D

As versões listadas são representativas do intervalo disponível para cada idioma. Para obter informações detalhadas sobre a versão, consulte a documentação específica do agente.

Próximo tópico

Copyright © 2026 New Relic Inc.

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