Instalação manual do Tarball do agente de infraestrutura para Linux

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.

Instale o agente

Antes da instalação, verifique a compatibilidade e os requisitos.

Para instalar o agente:

1. 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) e V=1.27.4 pela versão mais recente ou específica.

   bash

   Copiar

   $
   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 pacote tar.gz de assinatura GPG. Você pode conferir o procedimento de assinatura e instruções para verificação no repositório infra-agente no GitHub.

2. Descompacte o arquivo.

3. 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-infra

   Copiar

4. Instale o script de serviço.

5. Opcional: 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.

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.

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.

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.

Para alterar o modo de execução:

1. Edite o script de serviço:

   Systemd

   1. Abra o script de serviço ./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.service.
   2. Procure a linha [Service].
   3. Adicione a linha User=user_name e substitua user_name pelo usuário que você deseja executar o agente (PRIVILEGED ou UNPRIVILEGED).
   4. Salve o arquivo.

   SysV

   1. Abra o script de serviço ./newrelic-infra/etc/init_scripts/sysv/newrelic-infra.
   2. Procure a linha USER=root.
   3. Substitua root pelo usuário que você deseja executar o agente (PRIVILEGED ou UNPRIVILEGED).
   4. Salve o arquivo.

   Subir na vida

   1. Abra o script de serviço ./newrelic-infra/etc/init_scripts/upstart/newrelic-infra.
   2. Procure a linha exec /usr/bin/newrelic-infra.
   3. Substitua-o por exec su -s /bin/sh -c ‘exec “$0” “$@“’ user_name-- /usr/bin/newrelic-infra.
   4. Substitua user_name pelo usuário que você deseja executar o agente (PRIVILEGED ou UNPRIVILEGED).
   5. Salve o arquivo.

2. Se você estiver executando o agente como PRIVILEGED, deverá fornecer a ele dois recursos adicionais do Linux:

   1. Certifique-se de que a biblioteca libcap esteja instalada em seu host. (Você precisa dos comandos setcap e getcap que acompanham ele.)

   2. Extraia o conteúdo do tarball e execute o seguinte comando com permissão de root:

      bash

      Copiar

      $
      setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infra

   3. O 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 campo plugin_dir .
• Passe-o como um argumento de linha de comando usando -plugin_dir ao executar o binário newrelic-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).

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 campo agent_dir .
• Passe-o como um argumento de linha de comando usando -agent_dir ao executar o binário newrelic-infra .

Configurar o arquivo de log

Por padrão o agente armazena o arquivo de log em /var/db/newrelic-infra/newrelic-infra.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 campo log_file .
• Passe-o como um argumento de linha de comando usando -log_file ao executar o binário newrelic-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.