O agente de infraestrutura pode ser configurado de diversas maneiras. O método padrão é editar as variáveis de configuração no arquivo newrelic-infra.yml .
Sempre reinicie o agente após alterar as configurações. As atualizações de configuração de integração não exigem reinicialização do agente (há suporte para recarga a quente).
Métodos de configuração e precedência
O método padrão para configurar o agente de infraestrutura é o arquivo de configuração newrelic-infra.yml . Você pode substituir o arquivo de configuração definindo variáveis de ambiente, o que é ideal para ambientes em contêineres.
Variáveis de ambiente substituem o arquivo de configuração. O arquivo de configuração substitui os padrões do agente.
Aqui estão descrições detalhadas de cada método de configuração:
Para configurar o agente de infraestrutura, use o arquivo newrelic-infra.yml . Seu local padrão é:
Para definir uma variável de ambiente, use o nome da variável do arquivo de configuração em letras maiúsculas e prefixe com NRIA_; por exemplo, NRIA_LICENSE_KEY. Em ambientes conteinerizados, preencha as propriedades de configuração, como chave de licença e tag, por meio de variáveis de ambiente.
Você também pode definir variáveis de ambiente no arquivo de configuração com chaves duplas {{MY_ENV_VAR}}. Por exemplo:
license_key:{{MY_LICENSE_KEY}}
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.
Você pode usar variáveis de ambiente para controlar as configurações de integração no host, que podem então ser passadas para o agente de infraestrutura. As variáveis que podem ser usadas com cada integração no host estão listadas na documentação de cada integração e podem ser definidas por meio de um dos métodos a seguir.
A opção passthrough_environment oferece suporte a regex para nomes de variáveis.
De dentro do arquivo de configuração: adicione uma entrada ao arquivo de configuração da infraestrutura para permitir que o agente obtenha as variáveis de ambiente que você definiu.
passthrough_environment:
- HTTPS_PROXY
- HTTP_PROXY
- HTTP.*
- .*
Na linha de comando: Use outra variável de ambiente para passar por essas configurações.
Cada integração possui um conjunto de variáveis que podem ser substituídas definindo e transmitindo uma variável de ambiente com exatamente o mesmo nome do argumento (por exemplo, uma variável de ambiente PORT para substituir o argumento de porta redis ).
Você também pode definir variáveis de ambiente no arquivo de configuração de integração com a notação {{}} . Por exemplo:
integration_name: com.newrelic.redis
instances:
-name: redis-metrics
command: metrics
arguments:
hostname: localhost
port:6379
password:{{MY_REDIS_PASSWORD}}
Dica
Certifique-se de que o serviço newrelic-infra tenha visibilidade para qualquer variável de ambiente personalizada definida no host. Gerenciadores de serviços como o systemd não definirão todas as variáveis de ambiente por padrão e podem precisar de etapas adicionais.
Explorar opções de configuração
Para obter uma lista de todas as configurações que você pode definir, incluindo definições, padrões e variáveis de ambiente relacionadas, consulte Definições de configuração de infraestrutura.
Estrutura do arquivo de configuração
Ao editar arquivos de configuração YAML de agente ou integração:
Não modifique as maiúsculas e minúsculas das opções de configuração: as chaves YAML diferenciam maiúsculas de minúsculas.
Respeite os níveis de recuo. Todos os recuos estão em incrementos semelhantes, normalmente de dois caracteres de espaço. Os dados na mesma seção do arquivo devem usar o mesmo nível de recuo. Recue quaisquer subseções com dois espaços (ver exemplos em atributo personalizado e Filtros de interface de rede).
O formato YAML distingue entre números e strings. Use aspas para analisar valores de configuração como string.
Um modelo de newrelic-infra.yml está disponível no repositório do agente de infraestrutura. Use um validador para garantir que a sintaxe esteja precisa antes de usar o arquivo com o agente de infraestrutura.
Ferramentas de gerenciamento de configuração
Para instalar e gerenciar o agente de infraestrutura com ferramentas de gerenciamento de configuração, consulte a documentação para:
