IBM Performance Management

Editing each Ruby application to be monitored separately

If you prefer to monitor a subset of your Ruby applications, edit each Ruby application that you want to monitor separately.

Procedure

  1. To configure the agent, enter:
    install_dir/bin/ruby-agent.sh config instance_name
    Where instance_name is the name you want to give to the instance, and install_dir is the installation directory of Ruby agent. The default installation directory is /opt/ibm/apm/agent.
  2. When prompted to Edit Monitoring Agent for Ruby settings, enter 1 to continue.
  3. When prompted for Ruby Runtime Bin Location, press Enter to continue.
  4. When prompted with Allow the Ruby agent to auto-detect all current running Ruby on Rails applications, enter Y or N to continue.
    Note: This function can be enabled on only one agent instance. When you configure other instances, enter N to disable this function and continue.
  5. When prompted for Rails Application Server, press Enter to accept the default of ruby or specify the value for the server that you use according to the following list:
    • For Webrick servers, accept the default or specify ruby; if the Rails is installed by Ruby Stack, specify .ruby.bin.
    • For Passenger servers, specify passenger.
    • For Unicorn servers, specify unicorn.
    • For Puma servers, specify puma.
    • For Thin servers, if the applications are started by running the command thin start, accept the default to use ruby; if the applications are started by running the command thin start -d, specify thin; if the Rails is installed by Ruby Stack and the applications are started by running the command thin start, specify .ruby.bin.
  6. When prompted for Socket Data Source, press Enter to accept the default of 0 to use the ephemeral port.
  7. When prompted to Edit 'Ruby_Application' settings, enter 1 to specify an application.
  8. When prompted, enter the Ruby application name.
  9. When prompted, enter the Ruby application home directory, for example: /root/Ruby/myApp.
  10. For the last prompt, Advanced (select a section to override values), you can enter q to exit.
  11. To start the agent, enter:
    install_dir/bin/ruby-agent.sh start instance_name
    Note: If you have multiple Ruby runtimes installed and you want to monitor specific Ruby applications, you can set a runtime override on the Ruby application or subnode. As an example, assume that you have two runtimes installed and four applications, three of which use one runtime and one of which uses the other runtime. In this case, set the runtime most commonly used at the agent level, and set the runtime override for the application that uses a different runtime.

Results

You created a Ruby agent instance for one or more of your Ruby on Rails applications and started the monitoring agent to begin collecting data samples for resource monitoring.