Instalando agentes

É possível instalar qualquer combinação de agentes de monitoramento em um sistema gerenciado. Por exemplo, se você instalar o Agente Ruby para monitorar aplicativos Ruby On Rails, poderá desejar também instalar o Response Time Monitoring Agent, o agente do S.O. Linux, ou ambos os agentes. Com o Agente Response Time Monitoring, é possível reunir mais informações de tempo de resposta para seus aplicativos Ruby. Com o agente do S.O. Linux, é possível monitorar outros aspectos do sistema, tal como o total de CPU, memória e disco.

A oferta determina quais agentes de monitoramento estão disponíveis para instalação. Para obter uma lista dos agentes incluídos em cada oferta, consulte Capacidades.

Para obter uma lista dos agentes que são executados em sistemas Linux, consulte Instalando agentes nos sistemas Linux.

Antes de Iniciar

Faça download dos agentes. Consulte Fazendo download de seus agentes e coletores de dados.

Revise as informações em Requisitos do sistema para ter certeza de que você atendeu os requisitos para os agentes que pretende instalar.

Revise as tarefas de pré-instalação do agente antes de instalar os agentes. Para obter detalhes, consulte Pré-instalação em sistemas Linux.

Nota: O Java™ Runtime é instalado somente quando o agente o requer e nem sempre está disponível. Além disso, o ksh não é mais necessário para instalação do agente, exceto para instalação do Summarization and Pruning Agent, que é instalado durante a instalação do Servidor Cloud APM. O SELinux no modo forçado é suportado.

Sobre Esta Tarefa

É possível instalar agentes de monitoramento como um usuário raiz ou usuário não raiz. Se você não tiver privilégios de administrador e desejar instalar um agente de monitoramento, será possível instalar o agente como um usuário não raiz, consulte Instalando agentes como um usuário não raiz. Além disso, é possível instalar o agente como um usuário não raiz, se você for um administrador do host e não desejar executar o agente de monitoramento como um usuário raiz. O fluxo de instalação é o mesmo que para um usuário raiz.

A coexistência de agente é suportada. É possível instalar agentes do IBM Cloud Application Performance Management no mesmo computador no qual agentes do IBM Tivoli Monitoring estão instalados. Entretanto, os dois tipos de agentes não podem ser instalados no mesmo diretório. Para obter mais informações sobre coexistência de agente, consulte Coexistência do agente Cloud APM e do agente Tivoli Monitoring.

Procedimento

  1. Abra uma sessão de shell do terminal no sistema Red Hat Enterprise Linux.
  2. Em seu sistema, navegue para o diretório no qual você transferiu por download o arquivo .tar

    Os agentes devem ser instalados no sistema no qual o aplicativo que você deseja monitorar está instalado. Se necessário, transfira o archive de instalação para o sistema a ser monitorado. O archive contém os agentes e o script de instalação.

    Lembre-se: Certifique-se de que o diretório não contenha uma versão mais antiga do archive.
  3. Extraia os arquivos de instalação do usando os comandos a seguir, que dependem de sua oferta:
    tar -xf ./installation files.tar
    em que installation files é o nome do arquivo de instalação para sua oferta.

    O script de instalação é extraído para um diretório nomeado para o archive e a versão. Por exemplo: offering_Agent_Install_8.1.4.0. Os arquivos binários e relacionados à configuração do agente são extraídos em subdiretórios dentro desse diretório.

  4. Execute o script de instalação a partir do diretório nomeado para o archive e a versão:
    ./installAPMAgents.sh

    Para instalar os agentes no modo silencioso, consulte Instalando agentes silenciosamente.

  5. Especifique se deseja instalar agentes individuais, uma combinação dos agentes ou todos os agentes.
  6. Dependendo de se você está instalando ou atualizando os agentes, execute uma das etapas a seguir:
    • Se você estiver instalando os agentes, especifique um diretório inicial de instalação do agente diferente ou use o diretório padrão aplicável:
      • /opt/ibm/apm/agent
    • Se você estiver atualizando os agentes, depois de ser solicitado o diretório inicial de instalação do agente, insira o diretório de instalação da versão anterior dos agentes.
      1. Caso haja uma versão mais antiga dos agentes no diretório /opt/ibm/apm/agent, você deverá especificar um novo diretório de instalação. Na próxima etapa, você será questionado se deseja migrar a configuração do agente a partir do diretório /opt/ibm/apm/agent.
      2. Se você confirmar que deseja migrar a configuração do agente do diretório de instalação antigo (/opt/ibm/ccm/agent) para o novo diretório de instalação, por exemplo, /opt/ibm/apm/agent, será necessário iniciar o agente no novo local de instalação.
        Restrição: A versão mais antiga do agente é interrompida automaticamente no local de instalação antigo, mas ela não é iniciada automaticamente no novo local de instalação.
      3. Após a instalação ser concluída e você verificar se o agente funciona no novo diretório de instalação, deve-se desinstalar a versão mais antiga do agente do diretório /opt/ibm/ccm/agent. Caso deseje remover todos os agentes, execute o comando /opt/ibm/ccm/agent/bin/smai-agent.sh uninstall_all.
  7. Quando questionado se você aceita o contrato de licença, insira 1 para aceitar o contrato e continuar ou insira 2 para recusar.
    Após inserir 1 (aceitar), uma varredura de pré-requisito de seu ambiente é iniciada e demora alguns minutos para ser concluída. Se algum dos requisitos estiver ausente, uma mensagem direcionará você para um arquivo de log com a razão da falha. A ausência de um pré-requisito, como uma biblioteca ausente ou espaço em disco insuficiente, para a instalação. Deve-se abordar a falha e iniciar o script de instalação novamente.
    Nota: Se a instalação sair com a seguinte mensagem, verifique se o serviço do servidor foi iniciado (Iniciar -> Ferramentas Administrativas -> Serviços). Se não, inicie o serviço do Servidor e execute installAPMAgents.bat novamente.
    This script [installAPMAgents.bat] must be run as Administrator.
  8. Caso tenha instalado os agentes usando um ID do usuário não raiz, você deverá atualizar os scripts de inicialização do sistema (consulte Instalando agentes como um usuário não raiz).
  9. Após a instalação ser concluída e a linha de comandos estar disponível, será possível repetir as etapas neste procedimento para instalar mais agentes de monitoramento no sistema gerenciado.

O que Fazer Depois

Configure o agente conforme necessário. Se seu agente de monitoramento requerer configuração conforme descrito em Implementação do agente e do coletor de dados ou se você desejar revisar configurações padrão, consulte Configurando seu Ambiente.
  • Se você estiver usando um proxy de encaminhamento porque seu firewall não permite conexões HTTPS de saída transparentes para hosts externos, deverá editar o arquivo de configuração do ambiente do agente. Para obter instruções, veja Configurando agentes para se comunicar através de um proxy de encaminhamento.
  • Se você fez upgrade de um agente a partir de uma versão anterior, identifique qualquer tarefa de reconfiguração ou migração que você deve concluir antes de efetuar login no Console do Cloud APM. Para obter informações sobre essas tarefas, consulte Fazendo upgrade de agentes. Após um upgrade, é necessário reiniciar qualquer agente que não seja configurado e iniciado automaticamente pelo instalador.
Para iniciar um agente, execute o comando a seguir:
./name-agent.sh start
Para obter informações sobre os comandos do agente de monitoramento, incluindo o nome a ser utilizado, consulte Utilizando comandos do agente. Para obter informações sobre quais os agentes são iniciados automaticamente e manualmente, consulte Implementação do agente e do coletor de dados.

Após um upgrade, é necessário reiniciar qualquer agente que não seja configurado e iniciado automaticamente pelo instalador.

Depois de configurar e iniciar o agente, visualize os dados que o agente está coletando.