• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

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.

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 newrelic-infra-ctl adicional, que é usado para ajudar a solucionar problemas de um agente em execução. Embora esse binário não seja necessário para executar o agente, recomendamos que você o adicione ao seu caminho.

Processo daemon

A partir da versão 1.5.59, o pacote do agente de infraestrutura inclui o binário newrelic-infra-service adicional, que é usado para gerenciar com segurança o processo usual do daemon do agente newrelic-infra.

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
    $
    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
  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:

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:

bash
$
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:

  1. Edite o script de serviço:

  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
      $
      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).

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

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 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:

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.