Configurando o Agente Ruby

Para que o Agente Ruby monitore seus aplicativos, especifique o tempo de execução do Ruby. Como resultado, você usa o tempo de execução para reunir dados dos aplicativos Ruby e para configurar o agente.

Antes de Iniciar

Determine o servidor que você usa para iniciar aplicativos Ruby e o diretório bin qualificado para o executável Ruby ou Rake que é usado pelo agente:
  1. Para determinar o servidor de aplicativos que está sendo usado, execute o seguinte comando:
    ps -ef | grep ruby
    Você vê o nome do servidor que é usado para iniciar seu aplicativo. Os possíveis nomes de servidores são listados conforme a seguir:
    • Passageiro
    • Unicorn
    • Puma
    • Magro

    Se a saída de comando não indicar os nomes de servidores que são mostrados na lista anterior, o servidor usado para iniciar o aplicativo pode ser WEBrick.

    Importante: Se você usar vários servidores da web para iniciar seus aplicativos Ruby, deverá criar uma instância de agente para cada servidor da web de aplicativo, por exemplo, uma instância para PUMA e uma para Unicorn.
  2. Para determinar o diretório bin qualificado para o executável Ruby ou Rake usado pelo Agente Ruby, execute o seguinte comando:
    which ruby

Sobre Esta Tarefa

É possível repetir essa tarefa para configurar várias instâncias do agente de acordo com suas necessidades.

Procedimento

  1. Para configurar o agente, execute o comando a seguir:
    install_dir/bin/ruby-agent.sh config instance_name
    em que instance_name é o nome que você deseja dar à instância, e install_dir é o diretório de instalação do Agente Ruby. O diretório de instalação padrão é /opt/ibm/apm/agent.
    Importante: Não especifique um nome de instância longo. O comprimento total do nome do host e do nome da instância do agente não deve exceder 28 caracteres. Se o comprimento exceder o limite, o Nome do sistema gerenciado será truncado, e o código do produto para o Agente Ruby não será exibido corretamente.

    O Nome do sistema gerenciado inclui o nome da instância especificado, por exemplo, instance_name:host_name:pc, em que pc é seu código do produto de dois caracteres para o agente. Por exemplo, se você especificar Ruby2 como o nome da instância, o nome do sistema gerenciado será Ruby2:hostname:KM, em que KM é o código do produto de dois caracteres para o Agente Ruby.

  2. Quando for solicitado a Editar configurações do 'Monitoring Agent for Ruby' , insira 1 para continuar.
  3. Quando for solicitado o Diretório bin completo de Rubies, especifique o diretório binário. Por exemplo, se você usar o Ruby Version Manager (RVM), insira /usr/local/rvm/rubies/ruby-2.0.0-p247/bin.
  4. Quando for solicitado Detectar automaticamente a sinalização de aplicativos Ruby, insira Y para continuar. O agente recebe os dados enviados pelo coletor de dados do agente.
  5. Quando for solicitado o Nome do processo do servidor de aplicativos, pressione Enter para aceitar o padrão de ruby ou especifique o valor para o servidor usado, de acordo com a seguinte lista:
    • Para servidores WEBrick, aceite o padrão ou especifique ruby; se o Ruby on Rails for instalado pelo Ruby Stack, especifique .ruby.bin.
    • Para servidores Passenger, especifique passenger.
    • Para servidores Unicorn, especifique unicorn.
    • Para servidores Puma, especifique puma.
    • Para servidores Thin, se os aplicativos forem iniciados executando o comando thin start, aceite o padrão para usar ruby; se os aplicativos forem iniciados executando o comando thin start -d, especifique thin; se o Ruby on Rails for instalado pelo Ruby Stack e os aplicativos forem iniciados executando o comando thin start, especifique .ruby.bin.
  6. Quando for solicitada a Origem de dados do soquete, pressione Enter para aceitar o padrão de 0 para usar a porta efêmera.
  7. Quando for solicitado a Editar configurações do 'Aplicativo', insira 5 para sair da configuração.
  8. Para iniciar o agente, execute o seguinte comando:
    install_dir/bin/ruby-agent.sh start instance_name

O que Fazer Depois

Instale o coletor de dados para que o Agente Ruby funcione corretamente e para que os dados sejam exibidos na UI do Cloud APM. Para obter instruções, consulte Instalando o coletor de dados