If you prefer to monitor a subset of your Ruby applications,
edit each Ruby application that you want to monitor separately.
Procedure
- 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.
- When prompted to Edit Monitoring Agent for Ruby
settings, enter 1 to continue.
- When prompted for Ruby Runtime Bin Location,
press Enter to continue.
- 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.
- 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.
- When prompted for Socket Data Source, press
Enter to accept the default of 0 to use the ephemeral
port.
- When prompted to Edit 'Ruby_Application' settings,
enter 1 to specify an application.
- When prompted, enter the Ruby application name.
- When prompted, enter the Ruby application home directory,
for example: /root/Ruby/myApp.
- For the last prompt, Advanced (select a section
to override values), you can enter q to
exit.
- 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.