Definições de configuração do agente de infraestrutura

Especifica o chave de licençapara sua conta New Relic. O agente utiliza esta chave para associar a métrica do seu servidor à sua conta New Relic. Essa configuração é criada como parte do processo de instalação padrão.

Exemplo:

license_key: 1234567890abcdefghijklmnopqrstuvwxyz1234

Especifica se o terminal FedRAMP deve ser usado.

Especifica o número de processadores lógicos disponíveis para o agente. Aumentar esse valor ajuda a distribuir a carga entre diferentes núcleos.

Se definido como -1, o agente tentará ler a variável de ambiente GOMAXPROCS. Se esta variável não for definida, o valor padrão será o número total de núcleos disponíveis no host.

Desde a versão 1.0.804 ou superior, os dados enviados do agente são compactados por padrão. Para desativar a compactação de carga útil, defina payload_compression_level como 0.

Número de vezes que o agente tentará novamente a solicitação para verificar a disponibilidade da plataforma da New Relic na inicialização antes de gerar um erro.

Se definido como negative value, o agente continuará verificando a conexão até que seja bem-sucedida.

Após o tempo limite de uma solicitação expirar, o tempo que o agente espera para tentar novamente uma solicitação para verificar a disponibilidade da plataforma da New Relic na inicialização.

Tempo que o agente espera até que uma solicitação para verificar a disponibilidade da plataforma New Relic na inicialização seja considerada expirada.

Possibilita a autoinstrumentação do agente.

Ativa a nova tentativa do agente para transmissão de log por meio do encaminhador de log fluentbit integrado. Os valores inteiros são para o número de novas tentativas pretendidas. Outros valores possíveis incluem False para definir o número de novas tentativas como infinito e no_retries para desativar totalmente a funcionalidade de novas tentativas.

Define o número de vezes que o agente tenta se conectar novamente caso a detecção da nuvem falhe.

Se a detecção da nuvem falhar durante a inicialização do agente, o agente tentará novamente após aguardar CloudRetryBackOffSec segundos.

Define o intervalo de tempo que o agente aguardará até descartar os metadados, em segundos. Após esse período, os metadados expiram e o agente irá buscá-los novamente.

Define o intervalo de tempo que o agente espera entre novas tentativas de detecção de nuvem caso a detecção de nuvem falhe, em segundos.

Se a detecção da nuvem falhar durante a inicialização do agente, ele tentará novamente CloudMaxRetryCount vezes.

Especifica o provedor de nuvem em que o agente está sendo executado. Quando configurado com um valor diferente do padrão, o agente aguardará até adquirir com sucesso os metadados (o ID da instância) do provedor de nuvem antes de enviar quaisquer dados ao backend.

Com o comportamento padrão, o agente também tentará detectar o provedor de nuvem e obter os metadados, mas sem bloquear o agente.

Valores permitidos: "", "aws", "azure", "gcp", "alibaba"

Semelhante a DisableCloudMetadata, mas desativa a coleta de metadados de nuvem apenas para o plug-in de alias de host.

Desativa a coleta de metadados na nuvem.

Tempo, em segundos, antes que os metadados do contêiner em cache expirem e o agente precise buscá-los novamente.

Especifica a versão da API do cliente Docker .

Lista dos tipos de sistemas de arquivos suportados pelo agente. Esse valor precisa ser um subconjunto da lista padrão e os itens que não estiverem na lista padrão serão descartados.

Lista de dispositivos de armazenamento a serem ignorados pelo agente ao coletar dados StorageSample .

Exemplo como um atributo YAML:

file_devices_ignored:
  - sda1
  - sda2

Exemplo como variável de ambiente:

FILE_DEVICES_IGNORED="sda1,sda2"

Substitui o nome do host gerado automaticamente para relatórios. Isso é útil quando você tem vários hosts com o mesmo nome, pois nosso monitoramento de infraestrutura usa o nome do host como identificador exclusivo para cada host. Tenha em mente que este valor também é usado para substituição de endereço de loopback em nomes de entidades.

Para obter mais informações, consulte nossa documentação sobre como funciona a resolução de nomes de entidades.

Exemplo:

display_name: teslaOne

Quando true, o nome do host completo é resolvido executando uma pesquisa reversa do endereço do host. Caso contrário, será recuperado com o comando nome do host no Linux e a partir do parâmetro TCP/IP do registro no Windows.

Quando definido, este é o valor que será reportado para o nome completo do host; caso contrário, o agente executará o comportamento normal de pesquisa.

Exemplo:

my.custom-hostname.co.org

Quando definido, este é o valor que será relatado para o nome do host; caso contrário, o agente executará o comportamento normal de pesquisa.

Exemplo:

my.custom-hostname

Diretório onde o agente armazena arquivos para cache, inventário, integração, etc.

Diretório contendo os arquivos de configuração da integração.

Cada integração tem seu próprio arquivo de configuração, denominado por padrão <integration_name>-config.yml, colocado em um local predefinido a partir do qual o agente é carregado na inicialização.

Especifica um caminho personalizado para instalação de integração, que permite instalá-los fora do agent_dir. Tem prioridade quando o agente busca integração instalada.

Uma lista de variáveis de ambiente que serão passadas para toda integração. Se uma integração já tiver uma opção de configuração com o mesmo nome, a variável de ambiente terá precedência.

A partir do agente de infraestrutura 1.24.1 passthrough_environment oferece suporte a regex para nomes de variáveis.

Exemplo como atributo YAML (dentro do arquivo de configuração do agente, localizado por padrão em /etc/newrelic-infra.yml):

passthrough_environment:
  - HOST
  - PORT
  - NRIA_.*

Exemplo como variável de ambiente:

NRIA_PASSTHROUGH_ENVIRONMENT="HOST,PORT,NRIA_.*"

Para hosts Windows: PATHEXT é uma variável de ambiente do MS Windows. A função é determinar quais extensões de arquivo marcam os arquivos executáveis em cada linha de comando. Isso resolverá quaisquer erros reportando "... não é reconhecido como o nome de um cmdlet, função, arquivo de script..." para integração Flex comum:

passthrough_environment:
  - PATHEXT

O agente permite a substituição do endereço de loopback no nome da entidade (e, portanto, na chave) automaticamente para a versão 3 do protocolo de integração. Se você estiver usando a versão 2 do protocolo e desejar esse comportamento, ative a opção entityname_integrations_v2_update .

Ao definir este parâmetro de configuração como true , o agente abrirá uma porta HTTP (por padrão, 8001) para receber dados do backend New Relic StatsD.

Ao definir esse valor, o agente começará a escutar no HTTPServerPort para receber dados do backend do New Relic StatsD .

Define a porta para o servidor http receber dados do backend New Relic StatsD.

Inicia o processo de exclusão da entidade que não reportou informações neste intervalo.

Unidades de tempo válidas: s (segundos), m (minutos) e h (hora).

Exemplo:

1h

Se você tiver um grande número de processos no host ou um grande volume de dados coletados em sua integração, a fila do agente poderá ultrapassar o limite. Aumente a profundidade da fila para evitar mensagens de erro resultantes de filas cheias.

Define o diretório temporário usado como armazenamento persistente para sincronização do integração SDK.

Se o inventário em cache se tornar mais antigo que esse valor (por exemplo, porque o agente está offline), o agente removerá e recriará automaticamente o armazenamento delta.

Quando definido como verdadeiro, habilita o processamento assíncrono do estoque, permitindo que maiores cargas de estoque sejam processadas.

A lista de caminhos de inventário ignorados pelo agente.

Exemplo como um atributo YAML:

ignored_inventory:
  - files/config/stuff.bar
  - files/config/stuff.foo

Exemplo como variável de ambiente:

NRIA_IGNORED_INVENTORY="files/config/stuff.bar,files/config/stuff.foo"

Local no Linux onde o arquivo pid do processo do agente é criado. Ele é usado na inicialização para garantir que nenhuma outra instância do agente esteja em execução.

Quando verdadeiro, a formulação da memória virtual do host considera SReclaimable como memória disponível; caso contrário SReclaimable será considerado parte da memória usada.

Log é um mapa de valor principal usado para configurar o agente do agente de infraestrutura. Exemplo como um atributo YAML:

log:
  file: '/var/log/newrelic-infra/newrelic-infra.log'
  level: debug
  forward: true
  stdout: false

Exemplo como variável de ambiente:

NRIA_LOG_FILE='/var/log/newrelic-infra/newrelic-infra.log'
NRIA_LOG_LEVEL='smart'
NRIA_LOG_FORWARD='false'
NRIA_LOG_STDOUT='true'

log:
  level: info
  file: /var/log/newrelic-infra/newrelic-infra.log
  rotate:
    max_size_mb: 1000                        # Required
    max_files: 5                             # Optional
    compression_enabled: true                # Optional
    file_pattern: YYYY-MM-DD_hh-mm-ss.log    # Optional

Atributo personalizado são pares de valores principais (semelhantes aos tags de outras ferramentas) utilizados para anotar os dados do agente de infraestrutura. Você pode usar esses metadados para filtrar sua entidade, agrupar seus resultados e anotar seus dados. Por exemplo, você pode indicar o ambiente de uma máquina (preparação ou produção), o serviço que uma máquina hospeda (serviço de login, por exemplo) ou a equipe responsável por essa máquina.

Utilize uma lista de atributos personalizados para anotar os dados desta instância do agente. Separe chaves e valores com dois pontos :, como em KEY: VALUE, e separe cada par de valores principais com uma quebra de linha. As chaves podem ser qualquer YAML válido, exceto barras /. Os valores podem ser qualquer string YAML, incluindo espaços.

Exemplo como um atributo YAML:

custom_attributes:
  environment: production
  service: login service
  team: alpha-team

Exemplo como variável de ambiente:

NRIA_CUSTOM_ATTRIBUTES='{"customAttribute_1":"SOME_ATTRIBUTE","customAttribute_2": "SOME_ATTRIBUTE_2"}'

Exemplo de filtragem de NRQL por atributo personalizado:

FROM SystemSample SELECT * WHERE environment = 'production'

Possibilita o envio de métricas de processo para New Relic.

Por padrão, o agente de infraestrutura não envia dados sobre os processos do sistema operacional. O agente ainda coleta esses dados, a menos que metrics_process_sample_rate esteja definido como -1.

Para reportar dados métricos sobre todos os processos do sistema operacional, defina enable_process_metrics como true. Para desativar, defina como false.

O envio de todos os dados do processo pode aumentar o volume de dados enviados para a New Relic. Para ajustar quais processos você deseja monitor, configure include_matching_metrics.

Por padrão, os processos que usam pouca memória são excluídos da amostragem. Para obter mais informações, consulte desativar-zero-mem-process-filter.

Você pode controlar a quantidade de dados enviados para o New Relic configurando include_matching_metrics, que permite restringir a transmissão de dados métricos com base nos valores de métrica atributo.

Você inclui dados de métrica definindo valores literais ou parciais para qualquer atributo da métrica. Por exemplo, você pode optar por enviar o host.process.cpuPercent de todos os processos cujo process.name corresponde à expressão regular ^java .

Neste exemplo, incluímos métricas de processo usando nomes e arquivos executáveis:

include_matching_metrics:          # You can combine attributes from different metrics
  process.name:
    - regex "^java"                # Include all processes starting with "java"
  process.executable:
    - "/usr/bin/python2"           # Include the Python 2.x executable
    - regex "\\System32\\svchost"  # Include all svchost executables

Se você precisar incluir argumentos de linha de comando em qualquer um dos valores, defina strip_command_line como false (o agente de infraestrutura remove argumentos CLI por padrão para evitar vazamento de segredos).

Para configurar include_matching_metrics como uma variável de ambiente para a integração do Kubernetes, adicione-a no manifesto dentro do objeto env: :

env:
  - name: NRIA_INCLUDE_MATCHING_METRICS
    value: |
      process.name:
        - regex "^java"
      process.executable:
        - "/usr/bin/python2"
        - regex "\\System32\\svchost"

Padrão

É possível usar a configuração de filtros de interface de rede para ocultar interfaces de rede não utilizadas ou desinteressantes do agente de infraestrutura. Isso ajuda a reduzir o uso de recursos, o trabalho e o ruído em seus dados.

A configuração usa um mecanismo simples de correspondência de padrões que pode procurar interfaces que começam com uma sequência específica de letras ou números seguindo qualquer um dos padrões:

• {name}[other characters], onde você especifica o nome usando a opção prefix

• [number]{name}[other characters], onde você especifica o nome usando a opção index-1

  New Relic Infrastructure implementa uma lista padrão selecionada de filtros, disponível para Linux e Windows, que você pode modificar.

  Nome da opção YML	Variável de ambiente	Tipo	Padrão	Versão
  network_interface_filters	não suportado	map[string][]string		1.0.220

  Linux

  Filtros de interface de rede padrão para Linux:

  • Interfaces de rede que começam com dummy, lo, vmnet, sit, tun, tap ou veth

  • Interfaces de rede que contêm tun ou tap

    O exemplo a seguir (adicionado ao seu arquivo de configuração) substitui os filtros padrão. Isso ignorará interfaces de rede que começam com dummy ou lo ou contêm tun precedido por uma sequência de números e seguido por outros caracteres:

    network_interface_filters:
      prefix:
        - dummy
        - lo
      index-1:
        - tun

    Copiar

  Windows

  Filtros de interface de rede padrão para Windows:

  • Interfaces de rede que começam com Loop, isatap ou Local

    O exemplo a seguir (adicionado ao seu arquivo de configuração) substitui os filtros padrão. Isso ignorará as interfaces de rede que começam com Loop:

    network_interface_filters:
      prefix:
        - Loop

    Copiar

O ZeroRSSFilter exclui da amostragem processos que não usam memória. Desative o filtro para que o agente inclua esses processos no ProcessSample.

Para desativar todos os plug-ins, defina esta opção como true.

Período de amostragem para o plug-in CloudSecurityGroups , em segundos. O valor mínimo é 30. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Daemontools , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Dpkg , em segundos. O valor mínimo é 30. Para desativá-lo, defina-o como -1. Se o parâmetro não estiver definido explicitamente no arquivo de configuração, ele poderá ser desativado configurando DisableAllPlugins como true.

Período de amostragem para o plug-in Facter , em segundos. O valor mínimo é 30. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in KernelModules , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in NetworkInterface , em segundos. O valor mínimo é 30. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Rpm , em segundos. O valor mínimo é 30. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in SELinux , em segundos. O valor mínimo é 30. Para desativá-lo, defina-o como -1. Esta opção será ignorada se SelinuxEnableSemodule estiver definido como falso. Para obter mais informações, consulte nosso documento sobre resolução de problemas sobre como desabilitar o módulo SELinux .

Período de amostragem para o plug-in Sshd , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Supervisor , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Sysctl , em segundos. O valor mínimo é 30. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Systemd , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in sysv , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Upstart , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Período de amostragem para o plug-in Users , em segundos. O valor mínimo é 10. Para desativá-lo, defina-o como -1.

Localização do soquete do supervisor .

Define a variável de ambiente HOME para Puppet's Facter. Se não for definido, o padrão é o diretório inicial do usuário atual.

Seu sistema pode ter regras de firewall que exigem que o agente use um proxy para se comunicar com a New Relic. Nesse caso, defina a URL do proxy no formato https://user:password@hostname:port. Pode ser HTTP ou HTTPS.

Exemplo:

https://proxy_user:access_10@proxy_01:1080

Quando definido como true, as variáveis de ambiente HTTPS_PROXY e HTTP_PROXY são ignoradas. Isto é útil quando o agente precisa se conectar diretamente ao coletor métrico e ignorar o proxy do sistema existente.

Se a opção HTTPS_PROXY fizer referência a um proxy com certificados autoassinados, esta opção especificará o caminho para o diretório onde o certificado proxy está disponível. Os certificados no diretório devem terminar com a extensão .pem .

Se a opção HTTPS_PROXY fizer referência a um proxy com certificados autoassinados, esta opção especificará o caminho para o arquivo de certificado.

Se definido como true, quando o proxy estiver configurado para usar uma conexão HTTPS, ele funcionará apenas:

• Se o proxy HTTPS tiver certificados de uma autoridade de certificação válida.

• Se as propriedades de configuração ca_bundle_file ou ca_bundle_dir contiverem os certificados de proxy HTTPS.

  Nome da opção YML	Variável de ambiente	Tipo	Padrão	Versão
  proxy_validate_certificates	NRIA_PROXY_VALIDATE_CERTIFICATES	boleano	false	1.3.0

Envia as seguintes informações de configuração de proxy como inventário:

• HTTPS_PROXY

• HTTP_PROXY

• proxy ca_bundle_dir

• ca_bundle_file

• ignore_system_proxy

• proxy_validate_certificates

  Nome da opção YML	Variável de ambiente	Tipo	Padrão	Versão
  proxy_config_plugin	NRIA_PROXY_CONFIG_PLUGIN	boleano	true	1.3.0

Taxa de amostragem de amostras de rede, em segundos. O valor mínimo é 10. Para desativá-lo, configure-o como -1.

Taxa de amostragem de amostras de processo, em segundos. O valor mínimo é 20. Para desativar totalmente as amostras de processo, configure metrics_process_sample_rate como -1.

Taxa de amostragem de amostras armazenadas, em segundos. O valor mínimo é 5. Para desativá-lo, configure-o como -1.

Taxa de amostragem de amostras do sistema, em segundos. O valor mínimo é 5. Para desativá-lo, configure-o como -1.

Taxa de amostragem de amostras de armazenamento NFS, em segundos. O valor mínimo é 5. Para desativá-lo, configure-o como -1.

Métrica NFS detalhada. Quando habilitado, o agente fornecerá uma lista completa de métricas NFS.

Sinalizador para ativar/desativar a métrica NTP Offset.

Define lista de Hosts NTP a serem consultados. Quando forem definidos vários hosts, todos serão consultados e a métrica reportada será o valor médio entre eles.

Define o intervalo em minutos para solicitar o NTP Offset do pool fornecido.

Define o tempo limite em segundos para as solicitações feitas aos hosts NTP.

Obtenha versões de módulos de política instaladas usando SEModule. Se desabilitado, o plug-in SELinux só recuperará o status usando SEStatus.

Quando true, o agente remove os argumentos de comando do atributo commandLine de ProcessSample.

Ativa o servidor de status no agente que fornece informações de integridade local. Os endpoints disponíveis são:

Exemplo de endpoint de status principal (sem erros):

$
curl http://localhost:8003/v1/status
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://infrastructure-command-api.newrelic.com/agent_commands/v1/commands",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://identity-api.newrelic.com/identity/v1",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/inventory",
$
        "reachable": true
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

Endpoint de status principal (com erros):

$
curl http://localhost:8003/v1/status
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": false,
$
        "error": "endpoint check timeout exceeded"
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://identity-api.newrelic.com/identity/v1",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/inventory",
$
        "reachable": true
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

Exemplo de endpoint de erros:

$
curl http://localhost:18003/v1/status/errors
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": false,
$
        "error": "endpoint check timeout exceeded"
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

Isso é semelhante ao endpoint de status principal, mas filtra apenas aqueles com erros.

Exemplo de endpoint de entidade:

$
curl http://localhost:8003/v1/status/entity
$
{
$
  "guid":"MMMMNjI0NjR8SU5GUkF8TkF8ODIwMDg3MDc0ODE0MTUwNTMy",
$
  "key":"your-host-name"
$
}

Retorna informações sobre a entidade agente/host. Um código de status de resposta 204 ("Sem Conteúdo") será retornado quando o agente ainda não tiver informações sobre a entidade agente/host. Portanto, podem ser necessárias várias solicitações até que o agente forneça os dados da entidade.

Define a porta para o endpoint do servidor de status.

Período de amostragem para o plug-in de serviços do Windows, em segundos. O valor mínimo é 10. Para desativá-lo, configure-o como -1.

Período de amostragem para o plug-in de atualizações do Windows, em segundos. O valor mínimo é 10. Para desativá-lo, configure-o como -1.

Define o caminho para armazenar dados em um caminho diferente do diretório de arquivos de programa:

• %AppDir%/data: Usado para armazenar os dados delta

• %AppDir%/user_data: diretório externo para arquivos JSON gerados pelo usuário

• %AppDir%/newrelic-infra.log: Se a opção de configuração do arquivo de log não estiver definida, usaremos este caminho de diretório como padrão.

  Nome da opção YML	Variável de ambiente	Tipo	Padrão	Versão
  app_data_dir	NRIA_APP_DATA_DIR	corda	Windows: env(ProgramData)\New Relic\newrelic-infra Linux: Não aplicável	1.0.755

Habilita o plug-in de atualizações do Windows, que recupera as listas de hotfixes instalados no host.

Se true, o agente será forçado a usar WMI do Windows (o método legado do agente para obter métricas para Windows; por exemplo, StorageSampler) e desabilitará o novo método (que usa a biblioteca PDH).

Esta opção de configuração permite aumentar a prioridade do processo newrelic-infra.exe para qualquer um dos seguintes valores:

• Normal

• Idle

• High

• RealTime

• BelowNormal

• AboveNormal

  Nome da opção YML	Variável de ambiente	Tipo	Padrão	Versão
  win_process_priority_class	NRIA_WIN_PROCESS_PRIORITY_CLASS	corda		1.0.989

  Exemplo:

  Normal

  Copiar

Permite que o agente do Windows relate unidades A: e B: quando elas são mapeadas como unidades removíveis.

Se você definir como verdadeiro, obterá informações do processo do WMI e ignorará a verificação de acesso à consulta em um ambiente restrito.

Cabeçalhos HTTP personalizados para incluir em todas as solicitações ao backend do New Relic.

http:
  headers:
    "Proxy-Authorization": "myToken"