Gerenciando configuração

Importante

O Agent Control e o New Relic Control agora estão disponíveis para o público geral para Kubernetes! O suporte para hosts Linux e hosts Windows também está no programa de public preview, em conformidade com nossas políticas de pré-lançamento.

O agente Control fornece uma abordagem integrada para configuração independente do ambiente onde está implantado. Dois métodos para gerenciar a configuração do agente estão disponíveis:

Configuração local: um arquivo values.yaml abrangente usado durante a instalação inicial Helm .
Configuração remota: uma configuração centralizada, baseada em YAML, que você cria no New Relic Control e que é implantada remotamente em toda a sua frota.

A configuração remota é o método recomendado para o gerenciamento diário. Ele garante um comportamento consistente do agente em todo o seu ambiente, simplifica o gerenciamento de mudanças e permite que você dimensione sem atualizar manualmente os arquivos YAML locais em cada host.

Dica

O arquivo values-newrelic.yaml , que tradicionalmente definia as configurações do agente New Relic , agora também inclui configuração para controle do agente. O parâmetro que você define neste arquivo determina como o agente de controle e seu agente gerenciado operam. Este arquivo é chamado de configuração local.

Compreendendo as duas camadas de configuração

A configuração do agente Control está estruturada em duas camadas:

Configuração principal do agente Control: Estas são as configurações de nível superior que controlam como o agente Control opera, como sua conexão com o New Relic, sua identidade e detalhes de gerenciamento de frota.
Configuração do agente gerenciado: São os chart_values individuais para cada subagente (por exemplo, agente de infraestrutura, Fluent Bit) que o agente Control implanta e gerencia.

Quando uma configuração local e remota estão presentes, o agente Control aplica a seguinte lógica:

A configuração remota tem precedência. Quaisquer configurações definidas em uma configuração remota do New Relic Control substituirão as configurações correspondentes no arquivo values.yaml local.
Para substituir intencionalmente as configurações remotas pela sua configuração local, você pode implantar uma configuração remota vazia por meio do New Relic Control. Essa alteração será aplicada a todos os clusters da frota selecionada.

Configuração Kubernetes

Estas instruções e exemplos se aplicam ao agente de controle em execução em um cluster do Kubernetes.

Configuração `values.yaml` local para Kubernetes

O arquivo de configuração local do Kubernetes, usado durante a instalação, contém todas as configurações do agente Control e seu agente gerenciado.

Este exemplo mostra as duas camadas de configuração em um único arquivo.

# Layer 1: Agent Control's Core Configuration
global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

# Values related to the Agent Control's Helm chart release.
# `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control-bootstrap/values.yaml`
agentControlDeployment:
  chartValues:
    systemIdentity:
      organizationId: "****"
      parentIdentity:
        clientId: "****"
        clientSecret: "****"
    config:
      fleet_control:
        # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
        fleet_id: "****"

      # Layer 2: Managed Agents' Configurations
      # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
      agents:
        infrastructure:
          agent_type: newrelic/com.newrelic.infrastructure:0.1.0
        logs:
          agent_type: newrelic/io.fluentbit:0.1.0
        agent-operator:
          agent_type: com.newrelic.k8s_agent_operator:0.1.0

    agentsConfig:
      infrastructure:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"
        chart_values:
          newrelic-infrastructure:
          enableProcessMetrics: true
      logs:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"
        chart_values:
          newrelic-logging:
            sendMetrics: true
      agent-operator:
        chart_version: "*"

O exemplo demonstra como configurar o Agent Control junto com dois agentes gerenciados: o agente de infraestrutura Kubernetes e Fluent Bit para encaminhamento de logs. Por exemplo, se você não quiser enviar métricas de saúde para seu coletor de log Fluent Bit , basta definir sendMetrics: false no arquivo YAML antes de executar o comando de instalação.

Configuração remota para Kubernetes

A configuração remota garante um comportamento consistente do agente em todo o seu ambiente, simplifica o gerenciamento de alterações e permite que você dimensione a observabilidade sem gerenciar manualmente os arquivos YAML locais.

Para implantar a configuração centralmente no cluster, defina esse mesmo conteúdo YAML na seção Configurations do Controle de Agentes. Você pode então aplicar a configuração a uma frota inteira de clusters como parte de uma implantação remota. Isso é chamado de arquivo de configuração remota .

Dica

Quando você define uma configuração na interface de controle do New Relic, a estrutura YAML é diferente. Você fornece apenas o YAML que corresponde ao bloco content para um único agente.

Exemplo de configuração: controle de agente no Kubernetes

Configuração: Controle de agente no Kubernetes Os exemplos a seguir mostram como configurar o Controle de agente para gerenciar diferentes conjuntos de agentes. Essas configurações podem ser utilizadas durante a instalação inicial ou como parte de uma configuração remota no Controle de Agentes.

Para explorar todas as configurações disponíveis, consulte values-newrelic.yaml.

Os exemplos a seguir mostram como configurar o agente Control com um conjunto de subagentes usando o arquivo values.yaml local.

Agente de Controle com New Relic Infrastructure e Fluent Bit

Este exemplo implanta Agent Control com monitoramento de infraestrutura e Fluent Bit para coleta de logs.

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

# See `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control-bootstrap/values.yaml`
agentControlDeployment:
  chartValues:
    systemIdentity:
      organizationId: "****"
      parentIdentity:
        clientId: "****"
        clientSecret: "****"
    config:
      fleet_control:
        # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
        fleet_id: "****"
      agents:
        infrastructure:
          agent_type: newrelic/com.newrelic.infrastructure:0.1.0
        logs:
          agent_type: newrelic/io.fluentbit:0.1.0
        agent-operator:
          agent_type: com.newrelic.k8s_agent_operator:0.1.0
    agentsConfig:
      infrastructure:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"

        #chart_values:
        #  newrelic-infrastructure:
        #    enableProcessMetrics: true
      logs:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"

        #chart_values:
        #  newrelic-logging:
        #    sendMetrics: true
      agent-operator:
        chart_version: "*"

Controle de agente com OpenTelemetry e configurações personalizadas do coletor

com OpenTelemetry e configurações de coletor personalizadas Este exemplo implanta o agente Control com a distribuição New Relic do OpenTelemetry (NRDOT) e desabilita o receptor filelog no gráfico Helm gerenciadonr-k8s-otel-collector .

Importante

Prática recomendada de segurança: não armazene valores confidenciais, como sua chave de licença, diretamente na configuração. Recomendamos usar um segredo do Kubernetes. O agente Control pode então extrair com segurança esses valores do segredo em tempo de execução.

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"
# Values related to the Agent Control's Helm chart release.
# `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control-bootstrap/values.yaml`
agentControlDeployment:
  chartValues:
    systemIdentity:
      organizationId: "****"
      parentIdentity:
        clientId: "****"
        clientSecret: "****"
    config:
      fleet_control:
        # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
        fleet_id: "****"

      # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
      agents:
        nr-otel-collector:
          agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"
    # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
    agentsConfig:
      nr-otel-collector:
        chart_version: "*"
        chart_values:
          nr-k8s-otel-collector: {}
          global: {}

Exemplo de configuração: configuração de agente remoto no Kubernetes

Os exemplos a seguir mostram como configurar agentes individuais remotamente a partir da interface do New Relic Control .

Configuração remota: New Relic Infrastructure

Este exemplo mostra como configurar remotamente o agente da New Relic Infrastructure para Kubernetes usando o Controle de Agentes. Ele permite a coleta de métricas do processo definindo enableProcessMetrics: true.

Configuração remota: Fluent Bit

Este exemplo configurou Fluent Bit remotamente via Controle de Agentes. Ele habilita relatórios métricos de saúde do coletor de logs definindo sendMetrics: true.

Configuração remota: Prometheus

Este exemplo configura o agente Prometheus remotamente usando o Controle de Agentes. Ele permite que low-data mode reduza o volume de telemetria e desabilite a integração padrão.

Configuração remota: OpenTelemetry

Este exemplo configura o coletor New Relic OpenTelemetry e habilita lowDataMode como uma opção válida.

Importante

Crie um segredo do Kubernetes para armazenar com segurança a chave de licença do New Relic e usá-la em chart_values em substituição ao valor licenseKey :

customSecretName: "your-secret-name"
customSecretLicenseKey: "your-secret-key"

Recomendamos utilizar o Controle de Agentes para definir e implantar a configuração OpenTelemetry em suas frotas. Para configurar OpenTelemetry remotamente, crie uma configuração no Controle de Agentes com a estrutura mostrada abaixo. Você pode ajustar valores como lowDataMode ou receivers.filelog.enabled e incluir quaisquer outras configurações relevantes do gráfico Helm com base em suas necessidades.

chart_version: "*"
chart_values:
  nr-k8s-otel-collector:
    lowDataMode: true

Configuração de proxy para Kubernetes

O agente Control suporta configuração de proxy para rotear o tráfego através de proxies corporativos. As configurações de proxy podem ser definidas por meio de variáveis de ambiente ou diretamente no arquivo de configuração.

Precedência de proxy

Agent Control usará as configurações de proxy na seguinte ordem de precedência:

proxy Campo de configuração na configuração de Agent Control
HTTP_PROXY variável de ambiente
HTTPS_PROXY variável de ambiente

Configuração de proxy com certificados autoassinados

Para configurações de proxy usando autenticação HTTPS com certificados autoassinados, você precisa fornecer o pacote de certificado da CA e configurar a autenticação de proxy:

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

agentControlDeployment:
  proxy:
    url: https://proxy-service:8080

  # Mount CA certificate bundle to Agent Control
  extraVolumeMounts:
    - mountPath: /etc/ssl/certs/
      name: ca-certs
  extraVolumes:
    - name: ca-certs
      secret:
        secretName: ca-certs

# Configure Flux components to use proxy
agentControlCd:
  flux2:
    sourceController:
      extraEnv:
        # Configure Flux source-controller to proxy all requests
        - name: HTTPS_PROXY
          value: https://proxy-service:8080
        # Except for in-cluster requests
        - name: "NO_PROXY"
          value: ".cluster.local.,.cluster.local,cluster.local,.svc,127.0.0.0/8,10.0.0.0/8"
      volumeMounts:
        # Mount CA certificate bundle to source-controller trust root store. The bundle should contain the
        # proxy CA cert.
        - mountPath: /etc/ssl/certs/
          name: ca-certs
      volumes:
        - name: ca-certs
          secret:
            secretName: ca-certs

Configuração de proxy para agente gerenciado

Cuidado

Configurar um proxy no Agent Control não configura automaticamente as mesmas configurações de proxy para o agente que ele gerencia. Cada agente tem sua própria configuração de proxy, que deve ser definida separadamente, de acordo com o formato de configuração e os requisitos específicos do agente.

Ao usar um proxy, você também deve configurar as definições de proxy para cada agente gerenciado individualmente. Consulte a documentação específica de cada agente para obter opções de configuração de proxy.

Gerenciamento de segredos

O Controle de agente fornece um mecanismo robusto para gerenciar dados confidenciais, como senhas e chaves de API, recuperando-os de provedores de segredos dedicados. Isso garante que informações confidenciais não sejam codificadas diretamente em arquivos de configuração. Atualmente, o sistema suporta os provedores descritos em Provedores de valor.

Configuração de repositório privado

O agente Control suporta a configuração do repositório Helm privado para implantar o próprio agente Control e o agente gerenciado. Isso permite ambientes onde os gráficos do New Relic Helm não são diretamente acessíveis.

Cuidado

Ao usar o repositório privado Helm, os gráficos precisam ser compatíveis e as imagens referenciadas dentro dos gráficos devem ser acessíveis. Caso contrário, o agente não trabalhará como esperado.

1. Habilite repositório privado para agente

Por razões de segurança, somente repositórios explicitamente habilitados são permitidos na configuração remota. Para habilitar repositório específico, atualize a configuração do agente Control da seguinte forma:

# values-newrelic.yaml

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

# ...

agentControlDeployment:
  config:
    allowedChartRepositoryUrl:
      - https://my-private-repository-1
      - https://my-private-repository-2
    # ...

A configuração do repositório permitida pode então ser usada em sua configuração remota dentro do New Relic Control. Exemplo:

chart_version: "1.2.3"
chart_repository:
  url: "https://my-private-repository-1"
  name: "my-chart-name" # Optional: use only if the chart name doesn't match New Relic's chart name

Além disso, você precisa configurar a instalação Helm do agente Control para usar seu repositório privado se o próprio gráfico agent-control-bootstrap estiver em um repositório privado. Isso é separado da configuração do agente gerenciado. Consulte o agent-control-bootstrap Helm chart values.yaml para configurar a seção installationJob da seguinte forma:

chartRepositoryUrl: A URL que contém a localização do seu repositório.
chartName: O nome do gráfico, se estiver usando um nome de gráfico diferente.
repositorySecretReferenceName e repositoryCertificateSecretReferenceName: Os segredos necessários para autenticação no seu repositório. Veja a seção de autenticação abaixo para mais detalhes.

2. Configure autenticação para repositório privado

Você precisa configurar recursos adicionais para habilitar a autenticação para acessar seu repositório privado da seguinte maneira:

Para autenticar usando autenticação básica (nome de usuário e senha), você precisa criar um segredo no namespace do agente Control contendo os valores esperados em data.username e data.password.

Exemplo:

apiVersion: v1
kind: Secret
metadata:
  name: my-secret
stringData:
  username: "myUser"
  password: "myPassword"

Para mais detalhes, consulte a documentação do Flux.

Ao usar a autenticação básica, a configuração remota deve ser definida da seguinte maneira:

chart_repository:
  url: "https://my-private-repository-1"
  secret_reference:
    name: my-secret

Para autenticar usando TLS, você precisa criar um segredo contendo:

tls.crt e tls.key: certificado do cliente e chave privada usados para autenticação do cliente TLS
ca.crt: Certificado CA usado para verificar o servidor (obrigatório se o servidor usar um certificado autoassinado)
O segredo deve ser do tipo Opaque ou kubernetes.io/tls. Espera-se que todos os arquivos no Secret sejam codificados em PEM.
Exemplo:
```
apiVersion: v1
kind: Secret
metadata:
  name: my-secret
  namespace: newrelic-agent-control
type: kubernetes.io/tls # or Opaque
data:
  tls.crt: <BASE64>
  tls.key: <BASE64>
  # NOTE: Can be supplied without the above values
  ca.crt: <BASE64>
```
Para mais detalhes, consulte a documentação do Flux.
Ao usar a autenticação de certificado TLS, a configuração remota deve ser definida da seguinte maneira:
```
chart_repository:
  url: "https://my-private-repository-1"
  certificate_secret_reference:
    name: my-secret
```

Configuração Linux

Estes são os caminhos padrão para configuração do agente Control:

Local arquivo de configuração: /etc/newrelic-agent-control/config.yaml
Remote arquivo de configuração: /var/lib/newrelic-agent-control/config.yaml (se habilitado via Controle de Agentes de implantação)
Definição de serviço: /lib/systemd/system/newrelic-agent-control.service
Arquivo de ambiente de serviço: /etc/newrelic-agent-control/newrelic-agent-control.conf

Por padrão, o agente pode orquestrar o agente de infraestrutura e o coletor OpenTelemetry:

# Configures the integration with Fleet Control
fleet_control:
  # EU region? Use: https://opamp.service.eu.newrelic.com/v1/opamp
  # JP region? Use: https://opamp.service.jp.newrelic.com/v1/opamp
  endpoint: https://opamp.service.newrelic.com/v1/opamp
  headers:
    api-key: YOUR_INGEST_KEY
  auth_config:
    # EU region? Use: https://system-identity-oauth.service.eu.newrelic.com/oauth2/token
    # JP region? Use: https://system-identity-oauth.service.jp.newrelic.com/oauth2/token
    token_url: "https://system-identity-oauth.service.newrelic.com/oauth2/token"
    client_id: "YOUR_CLIENT_ID
    provider: "local"
    private_key_path: "path/to/key"

# Configures the agents to be supervised by Agent Control
agents:
  # Agent name (RFC-1035 valid label)
  nr-infra-agent:
    # The supported agent type and agent type version
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  nr-otel-collector:
    agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

Você pode renomear ou remover qualquer agente com base em seus requisitos de observabilidade. O nome do agente deve ser um nome de rótulo RFC-1035 válido.

Você também pode usar variáveis de ambiente para definir as configurações do agente:

Use o prefixo NR_ (sublinhado único) para destino da configuração de controle do agente principal.
Use __ (sublinhados duplos) para direcionar as configurações disponíveis no agente Control. Isso é necessário para evitar colisões com chaves de configuração que contêm sublinhados.
Variáveis de ambiente só têm precedência sobre o arquivo de configuração local. Se a configuração remota estiver habilitada, as variáveis de ambiente não serão consideradas.
Por exemplo, para definir uma configuração dinâmica para o fleet_control::endpoint, adicione o NR_FLEET_CONTROL__ENDPOINT=https://opamp.service.newrelic.com/v1/opamp no arquivo de definição de serviço.

Configurar o agente

O agente Control pode atualmente gerenciar os seguintes tipos de agentes predefinidos no host:

Agente New Relic Infrastructure: newrelic/com.newrelic.infrastructure. Todos os recursos existentes no agente de infraestrutura são suportados, incluindo orquestração de integração no host e nosso encaminhador de integração de logs baseado em FluentBit.
Distribuição New Relic para OpenTelemetry: newrelic/com.newrelic.opentelemetry.collector

Cada tipo de agente oferece um conjunto de variáveis opcionais que podem ser personalizadas para adaptar seu comportamento. Para personalizar a configuração local do agente:

Crie um arquivo values.yml : Este arquivo conterá os valores de configuração desejados.
Coloque o arquivo values.yml no diretório /etc/newrelic-agent-control/fleet/agents.d/YOUR-AGENT-NAME/values/. Aqui, YOUR-AGENT-NAME é o nome real do seu agente (por exemplo, nr-infra-agent).

Aqui está uma lista de variáveis disponíveis para as versões mais recentes do tipo de agente:

Agente New Relic Infrastructure: 0.1.0
Distribuição New Relic para OpenTelemetry: 0.1.0

Tipo de agente	Variável	Tipo	Padrão
`com.newrelic.infrastructure`	`config_agent`	Um YAML contendo agente de configuração de infraestrutura	(vazio)
`com.newrelic.infrastructure`	`config_integrations`	Um mapa YAML (chaves são nomes de arquivos) contendo integração no host configuração	(vazio)
`com.newrelic.infrastructure`	`config_logging`	Um mapa YAML (chaves são nomes de arquivos) contendo encaminhamento de configuração de logs	(vazio)
`com.newrelic.infrastructure`	`health_port`	Porta para o servidor de status local do agente de infraestrutura	`/health/status`
`com.newrelic.opentelemetry.collector`	`config`	Configuração do coletor OpenTelemetry (em formato YAML)	(vazio)
`com.newrelic.opentelemetry.collector`	`health_check.path` `health_check.port`	Caminho e porta para o endpointhttp local da extensão de verificação de integridade do coletor OTel	`localhost:13133/health/status`
Todos os agentes gerenciados	`backoff_delay`	Tempo até a próxima tentativa caso o coletor não inicie (em segundos).	`20s`

Dica

Você pode definir as configurações do agente de infraestrutura e do coletorOpenTelemetry conforme necessário seguindo a configuração suportada.

Configuração de amostra

Configuração Remota com Controle de Agentes

Os exemplos a seguir contêm casos de uso comuns que estão prontos para copiar e colar como configuração válida para o agente de controle e o agente gerenciado.

configurações de agente de infraestrutura, configurações de integração Redis e configurações de encaminhamento de logs para nossa integração FluentBit. O config_agent com um license_key válido é sempre obrigatório. Outras seções são opcionais (remova ou atualize conforme necessário):

config_agent:
  license_key: YOUR_LICENSE_KEY
  custom_attributes:
    env: demo
config_integrations:
  nri-redis-example.yml:
    integrations:
      - name: nri-redis
        env:
          hostname: localhost
          port: 6380
          keys: '{"0":["<KEY_1>"],"1":["<KEY_2>"]}'
          remote_monitoring: true
config_logging:
  fluentbit-example.yml:
    logs:
      - name: syslog
        file: /var/log/syslog
        attributes:
          logtype: linux_syslog

Monitoramento básico de host utilizando o coletor OTel (monitoramento de processos desabilitado) e receptor OTLP habilitado para receber trace, métrica e logs dos serviços APM :

config:
  receivers:
    otlp:
      protocols:
        grpc:
        http:

    hostmetrics:
      collection_interval: 20s
      scrapers:
        cpu:
          metrics:
            system.cpu.time:
              enabled: false
            system.cpu.utilization:
              enabled: true
        load:
        memory:
          metrics:
            system.memory.utilization:
              enabled: true
        paging:
          metrics:
            system.paging.utilization:
              enabled: false
            system.paging.faults:
              enabled: false
        filesystem:
          metrics:
            system.filesystem.utilization:
              enabled: true
        disk:
          metrics:
            system.disk.merged:
              enabled: false
            system.disk.pending_operations:
              enabled: false
            system.disk.weighted_io_time:
              enabled: false
        network:
          metrics:
            system.network.connections:
              enabled: false

    filelog:
      include:
        - /var/log/syslog

  processors:
    # group system.cpu metrics by cpu
    metricstransform:
      transforms:
        - include: system.cpu.utilization
          action: update
          operations:
            - action: aggregate_labels
              label_set: [ state ]
              aggregation_type: mean
        - include: system.paging.operations
          action: update
          operations:
            - action: aggregate_labels
              label_set: [ direction ]
              aggregation_type: sum
    # remove system.cpu metrics for states
    filter/exclude_cpu_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
    filter/exclude_memory_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
    filter/exclude_memory_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
    filter/exclude_filesystem_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
    filter/exclude_filesystem_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
    filter/exclude_filesystem_inodes_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
    filter/exclude_system_disk:
      metrics:
        datapoint:
          - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
    filter/exclude_system_paging:
      metrics:
        datapoint:
          - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
          - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
    filter/exclude_network:
      metrics:
        datapoint:
          - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'

    attributes/exclude_system_paging:
      include:
        match_type: strict
        metric_names:
          - system.paging.operations
      actions:
        - key: type
          action: delete

    transform:
      trace_statements:
        - context: span
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
      log_statements:
        - context: log
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)

    # used to prevent out of memory situations on the collector
    memory_limiter:
      check_interval: 1s
      limit_mib: 100

    batch:

    resourcedetection:
      detectors: ["env", "system"]
      system:
        hostname_sources: ["os"]
        resource_attributes:
          host.id:
            enabled: true

    resourcedetection/cloud:
      detectors: ["gcp", "ec2", "azure"]
      timeout: 2s
      ec2:
        resource_attributes:
          host.name:
            enabled: false

  exporters:
    otlp:
      endpoint: otlp.nr-data.net:4317
      headers:
        api-key: ${NEW_RELIC_LICENSE_KEY}

  service:
    pipelines:
      metrics:
        receivers: [otlp, hostmetrics]
        processors:
          - memory_limiter
          - metricstransform
          - filter/exclude_cpu_utilization
          - filter/exclude_memory_utilization
          - filter/exclude_memory_usage
          - filter/exclude_filesystem_utilization
          - filter/exclude_filesystem_usage
          - filter/exclude_filesystem_inodes_usage
          - filter/exclude_system_disk
          - filter/exclude_network
          - attributes/exclude_system_paging
          - batch
          - resourcedetection
          - resourcedetection/cloud
        exporters: [otlp]
      traces:
        receivers: [otlp]
        processors: [transform, resourcedetection, resourcedetection/cloud, batch]
        exporters: [otlp]
      logs:
        receivers: [otlp, filelog]
        processors: [transform, resourcedetection, resourcedetection/cloud, batch]
        exporters: [otlp]

Uma configuração válida para o próprio agente Control mostrando como desabilitar o agente, por exemplo, o coletor OTel:

agents:
  nr-infra-agent:
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  #nr-otel-collector:
  #  agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

Configuração do Windows

Estes são os caminhos padrão para a configuração do Agent Control no Windows:

Local arquivo de configuração: C:\Program Files\New Relic\newrelic-agent-control\local-data\agent-control\local_config.yaml
Remote arquivo de configuração: C:\ProgramData\New Relic\newrelic-agent-control\fleet-data\agent-control\remote_config.yaml (sincronizado do Fleet Control)
Executável do serviço: C:\Program Files\New Relic\newrelic-agent-control\newrelic-agent-control.exe
Diretório de logs: C:\ProgramData\New Relic\newrelic-agent-control\logs\

Por padrão, o Agent Control no Windows pode orquestrar o agente de infraestrutura e o coletor do OpenTelemetry:

# Configures the integration with Fleet Control
fleet_control:
  endpoint: https://opamp.service.newrelic.com/v1/opamp
  headers:
    api-key: YOUR_INGEST_KEY
  auth_config:
    token_url: "https://system-identity-oauth.service.newrelic.com/oauth2/token"
    client_id: "YOUR_CLIENT_ID"
    provider: "local"
    private_key_path: "path\\to\\key"

# Configures the agents to be supervised by Agent Control
agents:
  # Agent name (RFC-1035 valid label)
  nr-infra-agent:
    # The supported agent type and agent type version
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  nr-otel-collector:
    agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

Dica

Para contas regionais, use o endpoint apropriado e token_url:

Região da UE: https://opamp.service.eu.newrelic.com/v1/opamp e https://system-identity-oauth.service.eu.newrelic.com/oauth2/token
Região do JP: https://opamp.service.jp.newrelic.com/v1/opamp e https://system-identity-oauth.service.jp.newrelic.com/oauth2/token

Você pode renomear ou remover qualquer agente com base em seus requisitos de observabilidade. O nome do agente deve ser um nome de rótulo RFC-1035 válido.

Notas de configuração específicas para Windows

Caminhos de arquivo usam barras invertidas (\\) e caminhos no estilo Windows (por exemplo, C:\\ProgramData\\...)
Binários do agente usam extensões .exe
O serviço é executado como LocalSystem — certifique-se de que os arquivos de configuração tenham permissões de gravação restritas
Templates e configurações de ambientes Linux podem exigir ajustes de caminho para compatibilidade com o Windows

Configurar agentes

O Agent Control no Windows pode atualmente gerenciar os seguintes tipos de agente:

Agente de infraestrutura do New Relic: newrelic/com.newrelic.infrastructure. Suporta integrações no host e encaminhamento de logs via Fluent Bit integrado.
Distribuição New Relic para OpenTelemetry: newrelic/com.newrelic.opentelemetry.collector

Para personalizar a configuração local do agente, coloque um arquivo values.yml no diretório de valores do agente. As variáveis disponíveis são as mesmas que para hosts Linux.

Configuração de amostra

Configuração remota com Fleet Control

Configurações do agente de infraestrutura com encaminhamento de logs do Windows. O config_agent com um license_key válido é sempre obrigatório:

config_agent:
  license_key: YOUR_LICENSE_KEY
  custom_attributes:
    env: production
config_logging:
  windows-event-log.yml:
    logs:
      - name: windows-security
        winlog:
          channel: Security
          collect-eventids:
            - 4624
            - 4625
        attributes:
          logtype: windows_security

Uma configuração válida para o próprio Agent Control no Windows, mostrando como gerenciar agentes:

agents:
  nr-infra-agent:
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  #nr-otel-collector:
  #  agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

Provedores de valor

Os provedores de valor permitem que o Controle do agente resolva valores de fontes externas quando uma configuração é renderizada, para que dados sensíveis, como chaves de licença, tokens ou senhas, não precisem ser codificados diretamente em seus arquivos de configuração.

Os valores são referenciados com a sintaxe de espaço reservado ${NAMESPACE:NAME} dentro das configurações do agente. O Agent Control os resolve toda vez que uma configuração é aplicada, incluindo atualizações de configuração remota, para que os valores rotacionados sejam obtidos sem reiniciar o Agent Control.

Importante

Se o Agent Control falhar ao resolver um valor, a renderização da configuração falha e o agente não é iniciado. Isso evita que os agentes sejam executados com configurações incompletas ou incorretas.

Após uma resolução bem-sucedida, o Agent Control armazena o resultado renderizado em um secret do Kubernetes ou em um arquivo de configuração privado para uso pelo agente correspondente.

Provedores de valores suportados

Fornecedor	Namespace de espaço reservado	Requer configuração
Variáveis ambientais	`nr-env`	Não
HashiCorp Vault	`nr-vault`	Sim
Arquivos locais	`nr-file`	Não
Segredos do Kubernetes	`nr-kubesec`	Não
ConfigMaps do Kubernetes	`nr-kubecm`	Não

Configurando provedores de valor

Apenas o HashiCorp Vault requer configuração explícita. Defina-o sob a chave value_providers da configuração de Agent Control. A chave legada secrets_providers ainda é aceita como um alias.

value_providers:
  vault:
    sources:
      local-instance:
        url: http://localhost:8200/v1/
        token: root
        engine: kv2
      remote:
        url: http://my-remote-server:8200/v1/
        token: root
        engine: kv1
    client_timeout: 10s

fleet_control:
  ...

agents:
  ...

Cada entrada em sources define uma fonte do Vault nomeada com as seguintes configurações:

Chave YAML	Obrigatório	Descrição
`url`	Sim	URL completa do Vault, incluindo o caminho `/v1`.
`token`	Sim	Token usado para autenticar no endpoint.
`engine`	Sim	Versão do secrets engine: `kv1` ou `kv2`.
`client_timeout`	Não	Tempo limite HTTP para requests do Vault. O padrão é `30s`. Definido no nível `vault`, não por origem.

Variáveis ambientais: `nr-env`

Lê um valor do ambiente do host (disponível para o processo do Agent Control).

config_agent:
  license_key: "${nr-env:NEW_RELIC_LICENSE_KEY}"

HashiCorp Vault: `nr-vault`

Lê uma chave de um segredo KV do Vault. Requer a configuração value_providers.vault descrita acima.

O espaço reservado usa este formato:

"${nr-vault:SOURCE_NAME:MOUNT:PATH:KEY}"

SOURCE_NAME: nome da fonte do Vault definida em value_providers.
MOUNT: nome da montagem do mecanismo secreto.
PATH: caminho para o segredo.
KEY: chave dentro do segredo a ser recuperada.

Por exemplo:

config_agent:
  enable_process_metrics: true
  custom_attributes:
    username: "${nr-vault:local-instance:secret:my_secret:username}"
    organization: "${nr-vault:remote:my_mount:my_path:organization}"

Aqui, ${nr-vault:local-instance:secret:my_secret:username} recupera o valor da chave username do secret em secret/my_secret usando a fonte local-instance, e ${nr-vault:remote:my_mount:my_path:organization} recupera a chave organization da fonte remote.

Arquivos locais: `nr-file`

Lê o conteúdo de um arquivo local, removendo os espaços em branco iniciais e finais.

O espaço reservado recebe o caminho absoluto para o arquivo:

config_agent:
  license_key: "${nr-file:/etc/newrelic/license.key}"

Segredos do Kubernetes: `nr-kubesec`

Lê uma chave de um segredo do Kubernetes. Disponível apenas no Kubernetes e não requer configuração adicional, desde que o pod de Controle do Agente tenha permissões, por meio de uma conta de serviço e RBAC, para acessar os segredos e namespaces necessários.

O espaço reservado usa este formato:

"${nr-kubesec:NAMESPACE:SECRET_NAME:KEY}"

NAMESPACE: o namespace onde o segredo está localizado.
SECRET_NAME: nome do objeto secreto do Kubernetes.
KEY: chave dentro do segredo a ser recuperada.

Kubernetes ConfigMaps: `nr-kubecm`

Lê uma chave de um ConfigMap do Kubernetes. Disponível apenas no Kubernetes e não requer configuração adicional, desde que o pod do Agent Control tenha permissões para acessar os ConfigMaps e namespaces necessários.

O espaço reservado usa este formato:

"${nr-kubecm:NAMESPACE:CONFIGMAP_NAME:KEY}"

NAMESPACE: namespace onde o ConfigMap está localizado.
CONFIGMAP_NAME: nome do objeto ConfigMap do Kubernetes.
KEY: chave dentro do ConfigMap a ser recuperada.

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

Importante

Dica

Compreendendo as duas camadas de configuração.css-21sua1{background:none;border:none;width:0;padding:0;}

Configuração Kubernetes

Configuração values.yaml local para Kubernetes

Configuração remota para Kubernetes

Dica

Exemplo de configuração: controle de agente no Kubernetes

Agente de Controle com New Relic Infrastructure e Fluent Bit

Configuração local para infraestrutura e Fluent Bit

Controle de agente com OpenTelemetry e configurações personalizadas do coletor

Importante

Configuração OpenTelemetry

Exemplo de configuração: configuração de agente remoto no Kubernetes

Configuração remota: New Relic Infrastructure

configuração remota de infraestrutura

Configuração remota: Fluent Bit

Configuração Fluent Bit

Configuração remota: Prometheus

Configuração do Prometheus

Configuração remota: OpenTelemetry

Importante

Configuração remota OpenTelemetry

Configuração de proxy para Kubernetes

Precedência de proxy

Configuração de proxy com certificados autoassinados

Exemplo de configuração de proxy do Kubernetes

Configuração de proxy para agente gerenciado

Cuidado

Gerenciamento de segredos

Configuração de repositório privado

Cuidado

1. Habilite repositório privado para agente

Habilitar repositório privado

2. Configure autenticação para repositório privado

Autenticação básica

Autenticação de certificado TLS

Configuração Linux

Configurar o agente

Dica

Configuração de amostra

Configuração Remota com Controle de Agentes

Agente de infraestrutura, integração no host e direcionador de logs (FluentBit integrado)

New Relic OTel

Agente de Controle New Relic

Configuração do Windows

Dica

Notas de configuração específicas para Windows

Configurar agentes

Configuração de amostra

Configuração remota com Fleet Control

Agente de infraestrutura com encaminhamento de logs

Configuração de Agent Control

Provedores de valor

Importante

Provedores de valores suportados

Configurando provedores de valor

Variáveis ambientais: nr-env

HashiCorp Vault: nr-vault

Arquivos locais: nr-file

Segredos do Kubernetes: nr-kubesec

Kubernetes ConfigMaps: nr-kubecm

Compreendendo as duas camadas de configuração

Configuração `values.yaml` local para Kubernetes

Variáveis ambientais: `nr-env`

HashiCorp Vault: `nr-vault`

Arquivos locais: `nr-file`

Segredos do Kubernetes: `nr-kubesec`

Kubernetes ConfigMaps: `nr-kubecm`