Configuración del Agente de Ruby

Para que el Agente de Ruby supervise las aplicaciones, especifique el tiempo de ejecución de Ruby. Como resultado, utilizará el tiempo de ejecución para recopilar datos de las aplicaciones Ruby y configurar el agente.

Antes de empezar

Determine el servidor que se utiliza para iniciar aplicaciones Ruby y el directorio bin calificado para el ejecutable de Ruby o Rake utilizado por el agente:
  1. Para determinar el servidor de aplicaciones que está utilizando, ejecute el mandato siguiente:
    ps -ef | grep ruby
    Verá el nombre del servidor utilizado para iniciar la aplicación. Los nombres de servidor posibles se listan del siguiente modo:
    • Passenger
    • Unicorn
    • Puma
    • Thin

    Si la salida del mandato no indica los nombres de servidor que se muestran en la lista anterior, el servidor utilizado para iniciar la aplicación puede ser WEBrick.

    Importante: si utiliza varias servidores web para iniciar las aplicaciones Ruby, debe crear una instancia de agente para cada servidor web de aplicaciones, por ejemplo, una instancia para PUMA y una para Unicorn.
  2. Para determinar el directorio bin calificado para el ejecutable de Ruby o Rake utilizado por el Agente de Ruby, ejecute el mandato siguiente:
    which ruby

Acerca de esta tarea

Puede repetir esta tarea para configurar varias instancias de agente según sus necesidades.

Procedimiento

  1. Para configurar el agente, ejecute el mandato siguiente:
    dir_instalación/bin/ruby-agent.sh config nombre_instancia
    donde nombre_instancia es el nombre que desea dar a la instancia, y dir_instalación es el directorio de instalación del Agente de Ruby. El directorio de instalación predeterminado es /opt/ibm/apm/agent.
    Importante: No especifique un nombre de instancia largo. La longitud total del nombre de host y el nombre de instancia de agente no debe superar los 28 caracteres. Si la longitud supera el límite, el Nombre de sistema gestionado queda truncado y el código de producto del Agente de Ruby no se visualiza correctamente.

    El Nombre de sistema gestionado incluye el nombre de instancia que especifique, por ejemplo, nombre_instancia:nombre_host:pc, donde pc es el código de producto de dos caracteres para el agente. Por ejemplo, si especifica Ruby2 como nombre de instancia, el nombre de sistema gestionado será Ruby2:nombrehost:KM, donde KM es el código de producto de dos caracteres del Agente de Ruby.

  2. Cuando se le solicite Editar valores de 'Monitoring Agent for Ruby', especifique 1 para continuar.
  3. Cuando se le solicite el directorio Bin de Ruby completo, especifique el directorio binario. Por ejemplo, si utiliza Ruby Version Manager (RVM), especifique /usr/local/rvm/rubies/ruby-2.0.0-p247/bin.
  4. Cuando se le solicite Detectar automáticamente indicador de aplicaciones Ruby, especifique Y para continuar. El agente recibe los datos enviados por el recopilador de datos de agentes.
  5. Cuando se le solicite el nombre de proceso de servidor de aplicaciones, pulse Intro para aceptar el valor predeterminado ruby o especifique el valor del servidor que usa conforme a la lista siguiente:
    • Para los servidores WEBrick, acepte el valor predeterminado o especifique ruby; si Rails está instalado por Ruby Stack, especifique .ruby.bin.
    • Para los servidores Passenger, especifique passenger.
    • Para los servidores Unicorn, especifique unicorn.
    • Para los servidores Puma, especifique puma.
    • Para los servidores Thin, si las aplicaciones se han iniciado mediante el mandato thin start, acepte el valor predeterminado para usar ruby; si las aplicaciones se han iniciado mediante el mandato thin start -d, especifique thin; si Rails está instalado por Ruby Stack y las aplicaciones se han iniciado ejecutando el mandato thin start, especifique .ruby.bin.
  6. Cuando se le solicite el origen de datos de socket, pulse Intro para aceptar el valor predeterminado de 0 y utilizar el puerto efímero.
  7. Cuando se le solicite Editar valores de 'Aplicación', especifique 5 para salir.
  8. Para iniciar el agente, ejecute el mandato siguiente:
    dir_instalación/bin/ruby-agent.sh start nombre_instancia

Qué hacer a continuación

Instale el recopilador de datos para que el Agente de Ruby funcione adecuadamente y para que los datos se visualicen en la IU de Cloud APM. Para obtener instrucciones, consulte la sección Instalación del recopilador de datos