Configuring the Ruby data collector for IBM Cloud applications

To collect information about Ruby applications on IBM® Cloud, you must configure the Ruby data collector.

Before you begin

  1. Download the data collector package from IBM Passport Advantage® website. For detailed instructions, see Download instructions.
  2. Configure the data collector package by running the make_configuration_packages.sh and configure_agent_images.sh scripts on the system where the Cloud APM server is installed. For detailed instructions, see Configuring the downloaded images.

Procedure

  1. Extract files from the data collector package. The ruby_datacollector_8.1.4.0.tgz package is included in the extracted directory.
  2. Extract the files in ruby_datacollector_8.1.4.0.tgz by running the following command:
    tar -zxf ruby_datacollector_8.1.4.0.tgz
    You get an ibm_ruby_dc folder.
  3. Copy the entire etc folder in ibm_ruby_dc to the root folder of you Ruby application by running the following command:
    cp –r directory to the etc folder  home directory of your Ruby application

    The following command extract the data collector to the /opt/ibm/ccm/ibm_ruby_dc/etc directory and the home directory of your Ruby application is /root/ruby_app/:

    cp –r /opt/ibm/ccm/ibm_ruby_dc/etc /root/ruby_app/
  4. Add the following section to the Gemfile in the home folder of your Ruby application:
    gem 'logger',  '>= 1.2.8'
    source 'https://maagemserver.ng.bluemix.net/' do
      gem 'ibm_resource_monitor'
      gem 'stacktracer'
    end
  5. Run the bundle lock command to regenerate the Gemfile.lock file.
  6. From the directory that contains the manifest.yml file of your Ruby application, run the following command:
    cf push
    Tip: For a sample manifest.yml file, see Sample manifest.yml file.

Results

The data collector is configured and is connected to the Cloud APM server.

What to do next

You can verify the monitoring data for your IBM Cloud application is displayed in the Cloud APM console. For instructions on how to start the Cloud APM console, see Starting the Cloud APM console. For information about using the Applications editor, see Managing applications.