O agente de infraestrutura possui um grande conjunto de definições de configuração para ajustar seu comportamento. Aqui nós:
- Liste todas as opções de configuração (tanto no YAML quanto nos nomes das variáveis de ambiente).
- Explique o que as configurações fazem e quando usá-las.
- Forneça o tipo de variável e o valor padrão (se houver).
- Liste a versão mínima necessária do agente, conforme aplicável.
Importante
Com o gerenciamento de segredos, você pode configurar o agente de integração no host com infraestrutura para usar dados confidenciais (como senhas) sem precisar gravá-los como texto simples no arquivo de configuração da integração. Para obter mais informações, consulte Gerenciamento de segredos.
Ainda sem uma conta New Relic? Cadastre-se gratuitamente, para sempre.
Iniciar
Você poderá configurar nosso agente de infraestrutura para se adequar ao seu ambiente depois de criar uma conta New Relic (é grátis, para sempre) e instalar o agente de infraestrutura.
O license_key
é a única configuração necessária.
Para obter um exemplo de como todas essas variáveis podem ser usadas, consulte nosso modelo de configuração de exemplo no GitHub.
Variáveis ambientais
Muitas das opções de configuração listadas também admitem o uso de variáveis de ambiente para definir valores, que têm precedência sobre a configuração YAML.
Importante
Frequentemente, o agente de infraestrutura é executado como um serviço de sistema no host, gerenciado globalmente (por exemplo, systemd
para Linux, serviços do Windows, launchd
para macOS, etc.). Para aplicar alterações de configuração com variáveis de ambiente nesta configuração, essas variáveis de ambiente precisam ser definidas e tornadas visíveis para o contexto isolado onde o serviço do agente de infraestrutura está sendo executado. A maneira de fazer isso depende da plataforma. Verifique a documentação do gerenciador de serviços da sua plataforma para saber como adicionar variáveis de ambiente aos serviços do sistema.
Variáveis de agente
Especifica o para 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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
Exemplo:
license_key: 1234567890abcdefghijklmnopqrstuvwxyz1234
Especifica se o terminal FedRAMP deve ser usado.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
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.
Importante
Recomendação: Não altere esta configuração.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
| 1.0.936 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
| 1.0.936 - 1.2.30 |
Tempo que o agente espera até que uma solicitação para verificar a disponibilidade da plataforma New Relic na inicialização seja considerada expirada.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
| 1.0.936 |
Possibilita a autoinstrumentação do agente.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
|
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Variáveis de nuvem
Se o agente estiver sendo executado em uma instância de nuvem, o agente tentará detectar o tipo de nuvem e buscar metadados básicos. O métrica também pode ser enriquecido com metadados de nuvem estendidos (incluindo etiqueta de recurso personalizada) ao conectar a conta do provedor de nuvem com a New Relic.
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
| 1.2.6 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
| 1.2.6 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
| 1.2.6 |
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"
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
| 1.40.1 |
Semelhante a DisableCloudMetadata
, mas desativa a coleta de metadados de nuvem apenas para o plug-in de alias de host.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.0.220 |
Desativa a coleta de metadados na nuvem.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Variáveis Docker
Tempo, em segundos, antes que os metadados do contêiner em cache expirem e o agente precise buscá-los novamente.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
| 1.0.801 |
Especifica a versão da API do cliente Docker .
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
|
Variáveis do sistema de arquivos
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| []corda | Linux: Windows: | 1.0.220 |
Lista de dispositivos de armazenamento a serem ignorados pelo agente ao coletar dados StorageSample
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| []corda | 1.0.220 |
Exemplo como um atributo YAML:
file_devices_ignored: - sda1 - sda2
Exemplo como variável de ambiente:
FILE_DEVICES_IGNORED="sda1,sda2"
Nome das variáveis de host
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | vazio | 1.0.266 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | 1.0.1015 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | 1.0.1015 |
Exemplo:
my.custom-hostname
Variáveis de instalação
Diretório onde o agente armazena arquivos para cache, inventário, integração, etc.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | Linux: Windows: | 1.0.2 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | Linux: Windows: | 1.0.2 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | Vazio | 1.0.2 |
Variáveis de integração
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| []corda | Vazio |
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
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.2.15 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Ao definir esse valor, o agente começará a escutar no HTTPServerPort
para receber dados do backend do New Relic StatsD .
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
|
Define a porta para o servidor http receber dados do backend New Relic StatsD.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
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).
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
|
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Define o diretório temporário usado como armazenamento persistente para sincronização do integração SDK.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
|
Use esta configuração se você estiver instrumentando o host de uma fonte diferente do agente de infraestrutura (por exemplo, um coletor OpenTelemetry ou exportador de nós Prometheus) e quiser continuar usando o agente de infraestrutura integrado no host para monitor outros serviços de infraestrutura. Quando habilitado, o agente reporta inventário de host e integração telemétrica (evento métrico e inventário) decorado com metadados de host, mas métricas de host (CPU, memória, disco, rede, processos) ficam desabilitadas.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Variáveis de inventário
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
|
Quando definido como verdadeiro, habilita o processamento assíncrono do estoque, permitindo que maiores cargas de estoque sejam processadas.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| bool |
|
A lista de caminhos de inventário ignorados pelo agente.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| string[] | Lista vazia |
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"
Variáveis Linux
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
| 1.0.2 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Variáveis de registro
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'
Define o caminho do arquivo para o log.
A instalação padrão cria um diretório de log e define esse valor de caminho de arquivo na opção de configuração file
para você. Este diretório de log é diferente para cada sistema operacional, conforme mostrado abaixo.
Altere esta opção de configuração para customizar o caminho do arquivo para o log.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | Veja abaixo* |
Caminhos padrão:
Linux: Se não for definido, registra apenas na saída padrão.
Windows, versão do agente 1.0.944 ou superior:
C:\%ProgramData%\New Relic\newrelic-infra\newrelic-infra.logSe o diretório não puder ser criado:
C:\Program Files\New Relic\newrelic-infra\newrelic-infra.log
Define o nível de log. Valores disponíveis:
info
: Exibe mensagem do log de erro de nível, aviso e informações.smart
: ativa o modo detalhado inteligente. O modo detalhado inteligente registra as últimassmart_level_entry_limit
mensagens de depuração quando um erro é registrado.debug
: Exibe mensagem do log de erro de nível, warning, info e debug.trace
: Todas as mensagens do log serão mostradas.Importante
O registro em nível de trace pode gerar muitos dados muito rapidamente. Execute o agente no modo de trace apenas pelo tempo necessário para reproduzir o problema e, em seguida, defina
level: info
e reinicie o agente para desativar o registro detalhado. Como alternativa, você pode definirlevel
:smart
, que ativará o modo detalhado inteligente.Nome da opção YML
Variável de ambiente
Tipo
Padrão
Versão
level
NRIA_LOG_LEVEL
corda
Não configurado
Define o formato de saída do log. Valores disponíveis:
text
: saída de texto simples, uma linha por entrada de log.json
: saída formatada em JSON, uma linha por entrada de log.Nome da opção YML
Variável de ambiente
Tipo
Padrão
Versão
format
NRIA_LOG_FORMAT
corda
text
Permite encaminhar o log do agente para nossa interface de log. Para desativá-lo, defina esta opção de configuração como false
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Por padrão, todos os logs são exibidos na saída padrão e em um arquivo de log. Para desativar o log na saída padrão, defina esta opção de configuração como false
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
smart_level_entry_limit
refere-se ao número de mensagens de depuração anteriores que serão registradas quando um erro for registrado. Por exemplo, se o limite for definido como 5
, o log de depuração será armazenado em cache na memória até que um erro seja registrado, momento em que as 5 mensagens de depuração anteriores também serão registradas.
Importante
Esta opção de configuração é usada somente quando level
está definido como smart
(Smart Level ativado).
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
A partir da versão v1.28.0 , você pode usar o recurso integrado de rotação de log. Por padrão, a rotação de log está desabilitada. Para ativá-lo, você deve especificar o tamanho máximo do arquivo de log com a opção max_size_mb
. Quando o arquivo de log do agente de infraestrutura atingir esse tamanho, o arquivo de log atual será rotacionado para um novo arquivo.
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
max_size_mb
especifica o tamanho máximo em MegaBytes do arquivo de log do agente de infraestrutura. Quando o arquivo atingir esse tamanho, o log atual será rotacionado para um novo arquivo. Quando max_size_mb
é 0
, a rotação de log integrada é desativada.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
max_files
define quantos arquivos de log arquivados serão mantidos. Quando esse valor for excedido, os arquivos mais antigos serão removidos. Quando max_files
é 0
o limite para o número de arquivos é desativado.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Você pode ativar a compactação do arquivo de log definindo compression_enabled
como true
. Se a compactação estiver ativada, os arquivos girados terão um formato gzip
e usarão menos espaço em disco.
Importante
Durante a rotação do log, se a compactação estiver ativada, o uso da CPU do agente poderá aumentar, especialmente quando o valor max_size_mb
for maior que 1000
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
file_pattern
especifica o formato do nome do arquivo de log arquivado. Por padrão, o novo nome de arquivo usará o seguinte padrão de nome: original-file_YYYY-MM-DD_hh-mm-ss.log
.
Você pode personalizar o padrão de nome de arquivo com os seguintes campos de timestamp :
YYYY
: AnoMM
: MêsDD
: Diahh
: Horamm
: Minutoss
: SegundoO agente substituirá automaticamente esses campos timestamp pela hora da rotação do arquivo. Por exemplo:
log:level: infofile: /var/log/newrelic-infra/newrelic-infra.logrotate:max_size_mb: 1000file_pattern: rotated.YYYY-MM-DD_hh-mm-ss.logNome da opção YML
Variável de ambiente
Tipo
Padrão
Versão
file_pattern
NRIA_LOG_ROTATE_FILE_PATTERN
corda
file_YYYY-MM-DD_hh-mm-ss.file_extension
Dica
O agente de infraestrutura versão 1.28.0 introduziu melhorias de compatibilidade retroativa na configuração de log. Consulte nossa documentação no github para entender as configurações do legado e como mapeá-las para a nova estrutura.
Variáveis métricas
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.
Dica
O agente coleta muitos detalhes sobre seu ambiente como parte de seu atributo padrão, incluindo a tag Amazon Elastic computar Cloud (Amazon EC2).
Nome da opção YML | Variável de ambiente | Tipo |
---|---|---|
|
| map[string]interface{} |
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 valor principal 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. Iniciar a chave com label.
garantirá que ela permaneça como está, mesmo que esse host possa ser executado em diferentes ambientes de nuvem, onde a tag de nuvem ou os rótulos de nuvem podem interagir com ele na decoração combinada da tag. Por outro lado, custom_labels
pode ser prefixado com gcp.
ou azure.
ao ser executado nesses ambientes e ao combinar dados do agente de infraestrutura com o monitoramento de nuvem.
Exemplo como um atributo YAML:
custom_attributes: label.environment: production label.service: login service label.team: alpha-team
Exemplo como variável de ambiente:
NRIA_CUSTOM_ATTRIBUTES='{"label.customAttribute_1":"SOME_ATTRIBUTE","label.customAttribute_2": "SOME_ATTRIBUTE_2"}'
Exemplo de filtragem de NRQL por atributo personalizado:
FROM SystemSample SELECT * WHERE label.environment = 'production'
Importante
Requer o agente de infraestrutura versão 1.12.0 ou superior. Contas criadas antes de 20 de julho de 2020 e/ou agente de infraestrutura instalado usando a nova instalação guiada têm esta variável habilitada por padrão.
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 ao New Relic. Para ajustar quais processos você deseja monitor, configure include_matching_metrics
ou exclude_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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Quando ativado, o agente decora amostras de processo com informações de contêiner se o processo for executado em um contêiner.
Essas informações incluem o ID do contêiner, o nome do contêiner, o ID da imagem, o nome da imagem e os rótulos do contêiner.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.55.0 |
Importante
Atualmente, esta configuração se aplica apenas à métrica de processos de um sistema operacional.
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).
Se include_matching_metrics
e exclude_matching_metrics
estiverem presentes para o mesmo item, a inclusão terá precedência.
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
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| metric.attribute: - regex "padrão" - "corda" - "string com curinga*" |
Importante
Atualmente, esta configuração se aplica apenas à métrica de processos de um sistema operacional.
Você pode controlar a quantidade de dados enviados ao New Relic configurando exclude_matching_metrics
, o que permite restringir a transmissão de dados métricos com base nos valores do atributo métrica.
Você exclui dados métricos definindo valores literais ou parciais para qualquer um dos atributos da métrica. Por exemplo, você pode escolher não enviar o host.process.cpuPercent
de todos os processos cujo process.name
corresponde à expressão regular ^java
.
Neste exemplo, excluímos o processo métrica usando arquivos executáveis e nomes:
exclude_matching_metrics: # You can combine attributes from different metrics process.name: - regex "^java" # Exclude all processes starting with "java" process.executable: - "/usr/bin/python2" # Exclude the Python 2.x executable - regex "\\System32\\svchost" # Exclude all svchost executables
Para configurar exclude_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_EXCLUDE_MATCHING_METRICS value: | process.name: - regex "^java" process.executable: - "/usr/bin/python2" - regex "\\System32\\svchost"
Padrão
1.57.0
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| metric.attribute: - regex "padrão" - "corda" - "string com curinga*" |
É 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.
Importante
Variáveis de ambiente não são suportadas para esta definição de configuração.
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çãoprefix
[number]{name}[other characters]
, onde você especifica o nome usando a opçãoindex-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
Filtros de interface de rede padrão para Linux:
Interfaces de rede que começam com
dummy
,lo
,vmnet
,sit
,tun
,tap
ouveth
Interfaces de rede que contêm
tun
outap
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
oulo
ou contêmtun
precedido por uma sequência de números e seguido por outros caracteres:network_interface_filters:prefix:- dummy- loindex-1:- tun
Filtros de interface de rede padrão para Windows:
Interfaces de rede que começam com
Loop
,isatap
ouLocal
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
O ZeroRSSFilter
exclui da amostragem processos que não usam memória. Desative o filtro para que o agente inclua esses processos no ProcessSample
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.0.832 |
Variáveis de plug-in
Dica
Você pode desativar rapidamente todas as variáveis definindo DisableAllPlugins
como true
e ativar apenas as opções necessárias.
Para desativar todos os plug-ins, defina esta opção como true
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Período de amostragem para o plug-in CloudSecurityGroups
, em segundos. O valor mínimo é 30
. Para desativá-lo, defina-o como -1
.
Importante
Este plug-in será ativado somente se o agente estiver em execução em uma instância AWS.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in Daemontools
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
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
.
Importante
Isso só é ativado nos modos de execuçãoroot
ou privileged
e em distribuições baseadas em Debian.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in Facter
, em segundos. O valor mínimo é 30
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in KernelModules
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Importante
kernel_modules_refresh_sec
só é ativado nos modos de execuçãoroot
ou privileged
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
| 1.0.755 |
Período de amostragem para o plug-in NetworkInterface
, em segundos. O valor mínimo é 30
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
| 1.0.329 |
Período de amostragem para o plug-in Rpm
, em segundos. O valor mínimo é 30
. Para desativá-lo, defina-o como -1
.
Importante
rpm_interval_sec
só é ativado quando o agente é executado nos modos raiz ou privilegiado para distribuições RedHat, RedHat AWS ou SUSE.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
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
.
Importante
SELinux
só é ativado quando o agente é executado em modo root.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in Sshd
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
| 1.0.755 |
Período de amostragem para o plug-in Supervisor
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in Sysctl
, em segundos. O valor mínimo é 30
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in Systemd
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in sysv
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in Upstart
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
Período de amostragem para o plug-in Users
, em segundos. O valor mínimo é 10
. Para desativá-lo, defina-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
| 1.0.755 |
Localização do soquete do supervisor .
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
| 1.0.2 |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
Variáveis proxy
Para o agente de infraestrutura versão 1.3.1 ou superior, a precedência das definições de configuração do proxy é:
NRIA_PROXY
proxy
HTTP_PROXY
HTTPS_PROXY
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda | Vazio |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
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
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| corda |
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
ouca_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
Se você estiver tendo problemas com a configuração do proxy, consulte Resolução de problemas do proxy.
Variáveis de amostras
Taxa de amostragem de amostras de rede, em segundos. O valor mínimo é 10
. Para desativá-lo, configure-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
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
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Taxa de amostragem de amostras armazenadas, em segundos. O valor mínimo é 5
. Para desativá-lo, configure-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Taxa de amostragem de amostras do sistema, em segundos. O valor mínimo é 5
. Para desativá-lo, configure-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Taxa de amostragem de amostras de armazenamento NFS, em segundos. O valor mínimo é 5
. Para desativá-lo, configure-o como -1
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Métrica NFS detalhada. Quando habilitado, o agente fornecerá uma lista completa de métricas NFS.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Variáveis de deslocamento NTP
ntp_metrics
é um mapa de valor principal usado para configurar a métrica de deslocamento de tempo. Quando ativado e uma lista de hosts NTP for fornecida, o agente fornecerá a métrica ntp offset
do host (em segundos). Esse valor é verificado no pool de hosts NTP fornecido a cada interval
minutos (o valor padrão e mínimo é 15 minutos). Entre intervalos, o último deslocamento conhecido é relatado. Se o deslocamento relatado for superior a alguns segundos, poderá causar problemas com a condição do alerta, consulta NRQL e lacunas de dados no painel.
Exemplo como um atributo YAML:
ntp_metrics: enabled: true pool: - time.cloudflare.com - time.google.com interval: 15 timeout: 10
Exemplo como variável de ambiente:
NRIA_NTP_METRICS_POOL='time.cloudflare.com,time.google.com'NRIA_NTP_METRICS_ENABLED='true'NRIA_NTP_METRICS_INTERVAL='15'NRIA_NTP_METRICS_TIMEOUT='10'
Sinalizador para ativar/desativar a métrica NTP Offset.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
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.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| []corda | Vazio. Confira os servidores NTP públicos. |
Define o intervalo em minutos para solicitar o NTP Offset do pool fornecido.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Define o tempo limite em segundos para as solicitações feitas aos hosts NTP.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
|
Variáveis de segurança
Obtenha versões de módulos de política instaladas usando SEModule. Se desabilitado, o plug-in SELinux só recuperará o status usando SEStatus.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.0.864 |
Quando true
, o agente remove os argumentos de comando do atributo commandLine
de ProcessSample
.
Dica
Esta é uma medida de segurança para evitar o vazamento de informações confidenciais.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.0.149 |
Variáveis de endpoint de status
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.
Importante
Essa configuração é habilitada por padrão quando você usa a instalação guiada. Isso ajuda a confirmar se a instalação do agente foi bem-sucedida.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.19.0 |
Define a porta para o endpoint do servidor de status.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| inteiro |
| 1.19.0 |
Variáveis do Windows
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
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
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
.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| int64 |
|
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
Habilita o plug-in de atualizações do Windows, que recupera as listas de hotfixes instalados no host.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
| 1.0.274 |
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).
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
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
Permite que o agente do Windows relate unidades A:
e B:
quando elas são mapeadas como unidades removíveis.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Se você definir como verdadeiro, obterá informações do processo do WMI e ignorará a verificação de acesso à consulta em um ambiente restrito.
Nome da opção YML | Variável de ambiente | Tipo | Padrão | Versão |
---|---|---|---|---|
|
| boleano |
|
Cliente HTTP
Configure o cliente HTTP usado para comunicação backend .
Cabeçalhos HTTP personalizados para incluir em todas as solicitações ao backend do New Relic.
http: headers: "Proxy-Authorization": "myToken"
Nome da opção YML | Variável de ambiente | Tipo | Versão |
---|---|---|---|
|
| mapa de key-value |
Qual é o próximo?
Você também pode:
- Entenda melhor a configuração do agente.
- Crie um arquivo de configuração usando nosso modelo.
- Veja como você pode gerenciar o agente.