Nosso processo personalizado de instalação do Linux para monitoramento de infraestrutura permite personalizar todos os aspectos do processo de instalação e colocar arquivos e pastas em seu sistema de arquivos. Você tem controle total da instalação.
Cuidado
O processo de instalação manual não é supervisionado. Se optar pela instalação manual, você será responsável por colocar os diferentes arquivos nas pastas corretas, fornecer os valores de configuração parametrizados corretos e garantir que o agente tenha todas as permissões de execução.
Instale o agente
Antes da instalação, verifique a compatibilidade e os requisitos.
Opções adicionais de pacote de agente | Comentários |
---|---|
Resolução de problemas | O pacote do agente de infraestrutura inclui o binário |
Processo daemon | A partir da versão 1.5.59, o pacote do agente de infraestrutura inclui o binário |
Para instalar o agente:
Baixe o arquivo empacotado do agente ou use o comando a seguir que busca automaticamente uma versão específica do agente, sua soma de verificação e a verifica após o download. Substitua
ARCH=amd64
pela arquitetura desejada (amd64, 386, arm64, arm) eV=1.27.4
pela versão mais recente ou específica.bash$V=1.27.4 ARCH=amd64; echo "https://download.newrelic.com/infrastructure_agent/binaries/linux/${ARCH}/newrelic-infra_linux_${V}_${ARCH}.tar.gz" | { read url; wget "${url}"{,.sum}; shasum -a 256 --check ${url##*/}.sum; }A partir da versão
1.27.4
, disponibilizamos o pacotetar.gz
de assinatura GPG. Você pode conferir o procedimento de assinatura e instruções para verificação no repositório infra-agente no GitHub.Descompacte o arquivo.
Certifique-se de que o arquivo seja descompactado com a seguinte estrutura:
newrelic-infra|-- config_defaults.sh|-- etc| |-- init_scripts| | |-- systemd| | | `-- newrelic-infra.service| | |-- sysv| | | `-- newrelic-infra| | `-- upstart| | `-- newrelic-infra| `-- newrelic-infra| `-- integrations.d|-- installer.sh|-- usr| `-- bin| |-- newrelic-infra| |-- newrelic-infra-ctl| `-- newrelic-infra-service`-- var|-- db| `-- newrelic-infra| |-- custom-integrations| |-- integrations.d| |-- LICENSE.txt| `-- newrelic-integrations|-- log| `-- newrelic-infra`-- run`-- newrelic-infraOpcional: etapas adicionais de instalação.
Instalar: etapas opcionais
Você também pode realizar estas etapas adicionais:
- Altere o local do arquivo de configuração.
- Altere a localização do arquivo PID.
- Altere o modo de usuário e de tempo de execução.
- Configure o diretório do plug-in.
- Configure o diretório do agente.
- Configure o arquivo de log.
- Altere o local do binário do agente.
Este documento ajudou você na instalação?
Instale o script de serviço
Antes de prosseguir com a instalação do script de serviço, você precisa determinar qual gerenciador de serviços seu sistema está usando:
- Se você usar um dos gerenciadores de serviços suportados (SystemD, SysV e Upstart), use o script de serviço fornecido no tarball.
- Se você usar um gerenciador de serviços que não oferecemos suporte, você deverá escrever seu próprio script de serviço.
Importante
Em caso de dúvida, consulte a documentação oficial da sua distribuição Linux.
Importante
Antes de copiar o script do gerenciador de serviços, verifique se é necessário alterar o usuário, o caminho do binário do agente ou a localização do arquivo pid. Todas essas mudanças precisam ser refletidas no script do serviço.
Se você usar um dos gerenciadores de serviços suportados, instale o script de serviço para seu host:
Seu script de serviço está configurado. Configure o restante das opções e inicie o serviço manualmente.
Alterar a localização do arquivo de configuração
O agente de infraestrutura inclui um arquivo de configuração, geralmente denominado newrelic-infra.yml
, para ajustar o comportamento do agente. Para obter mais informações, consulte um modelo de arquivo de configuração e como configurar o agente.
Por padrão, o agente procura o arquivo de configuração em um destes locais:
newrelic-infra.yml
(pasta raiz do diretório de trabalho)/etc/newrelic-infra.yml
/etc/newrelic-infra/newrelic-infra.yml
Para especificar um local diferente, use a linha de comando do sinalizador -config
. Por exemplo:
$usr/bin/newrelic-infra -config /whatever/path/custom_config_name.yml
Para tornar essa alteração permanente, edite o script de serviço:
Alterar a localização do arquivo pid
O agente de infraestrutura usa um pid-file
para manter o número de identificação do processo (pid), que é usado para identificar uma instância em execução do agente. Como alterar o local do pid-file
depende de como o agente está configurado.
Importante
Por padrão, recomendamos que o agente crie o pid-file
. Você pode editar o local, se necessário.
Para alterar a localização do pid-file
:
Alterar o usuário e o modo de tempo de execução
O agente Linux é executado como root
por padrão, mas também suporta execução com usuários com menos privilégios: PRIVILEGED
e UNPRIVILEGED
. Para obter mais informações, consulte nossa documentação sobre modos de execução do agente.
Importante
Para executar o agente como um usuário não root (PRIVILEGED
ou UNPRIVILEGED
), certifique-se de conceder acesso de leitura/gravação às pastas e arquivos fornecidos no tarball.
Para alterar o modo de execução:
Edite o script de serviço:
Se você estiver executando o agente como
PRIVILEGED
, deverá fornecer a ele dois recursos adicionais do Linux:Certifique-se de que a biblioteca
libcap
esteja instalada em seu host. (Você precisa dos comandossetcap
egetcap
que acompanham ele.)Extraia o conteúdo do tarball e execute o seguinte comando com permissão de root:
bash$setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infraO modo de execução será selecionado com base no usuário atual e nos recursos do kernel atribuídos a ele.
Configurar o diretório do plug-in
O agente de infraestrutura permite instalar integrações que monitor e reportam dados de serviços populares como Kubernetes, AWS, MySQL, Redis, Kafka, etc. Cada integração possui seu próprio arquivo de configuração, denominado por padrão integration-name-config.yml
, colocado no local predefinido /etc/newrelic-infra/integrations.d/
. Na inicialização, o agente carrega o arquivo de configuração.
Para substituir o local predefinido do arquivo de configuração de integração, use um dos seguintes métodos:
- Defina o local na variável de ambiente
NRIA_PLUGIN_DIR
. - Defina o caminho personalizado no arquivo de configuração
newrelic-infra.yml
usando o campoplugin_dir
. - Passe-o como um argumento de linha de comando usando
-plugin_dir
ao executar o binárionewrelic-infra
.
Configurar o diretório do agente
O agente requer um diretório próprio definido para executar a integração instalada, armazenar dados em cache (inventário), etc. O local padrão é /var/db/newrelic-infra/
.
O diretório do agente possui a seguinte estrutura e conteúdo:
LICENSE
: arquivo de texto contendo a licença do agente New Relic Infrastructure .custom-integrations
: Diretório que armazena a integração personalizada instalada.newrelic-integrations
: Diretório que armazena a integração oficial da New Relic .data
: Diretório onde o agente armazena dados de cache (inventário).
Importante
O usuário que executa o agente deve ter permissões de leitura/gravação no diretório do agente.
Para substituir o local predefinido do diretório do agente, use um dos seguintes métodos:
- Defina o local na variável de ambiente
NRIA_AGENT_DIR
. - Defina o caminho personalizado no arquivo de configuração
newrelic-infra.yml
usando o campoagent_dir
. - Passe-o como um argumento de linha de comando usando
-agent_dir
ao executar o binárionewrelic-infra
.
Configurar o arquivo de log
Por padrão o agente armazena o arquivo de log em /var/db/newrelic-infra/newrelic-infra.log
.
Importante
O usuário que executa o agente deve ter permissões de gravação no arquivo de log.
Para substituir o local predefinido do arquivo de log, use um dos seguintes métodos:
- Defina o local na variável de ambiente
NRIA_LOG_FILE
. - Defina o caminho personalizado no arquivo de configuração
newrelic-infra.yml
usando o campolog_file
. - Passe-o como um argumento de linha de comando usando
-log_file
ao executar o binárionewrelic-infra
.
Alterar a localização do binário do agente
Para alterar a localização do executável, edite o script de serviço:
Qual é o próximo?
Você também pode querer:
- Adicione um atributo personalizado para anotar seus dados de infraestrutura.
- Conecte sua conta AWS se seus servidores estiverem hospedados no Amazon EC2.
- Habilite o encaminhamento de logs.
- Habilite nossa integração Flex adicionando manualmente o executável Flex.
- Adicione outra integração de infraestrutura para coletar dados de serviços externos.
- Inicie, pare, reinicie ou verifique manualmente o status do agente.