# APM Insight Ruby on Rails Agent

Applications Manager's Ruby agent deployed on a Rails platform gives you end-to-end web-transaction awareness enabling you to isolate performance issues and resolve them quickly.

Applications Manager requires a monitoring agent (Ruby gem) to be deployed in your application server to monitor Ruby application performance. Download the latest Ruby Agent and deploy it in your application server. The agent collects application performance metrics and sends it to the central Applications Manager server at fixed intervals i.e. every 60 seconds.

**Requirements:** **Ruby** - 2.5.0 and above, **Rails** - 5.1.0 and above, **Sinatra** - 1.4.0 and above.

**Frameworks supported:** Rails, Sinatra, Sidekiq, and ActiveRecord.

## Ruby Agent Setup

- [Install Ruby Agent](https://www.manageengine.com/products/applications_manager/help/apm-insight-ruby-agent-install.html)
- [Upgrade Ruby Agent](https://www.manageengine.com/products/applications_manager/help/apm-insight-ruby-agent-upgrade.html)
- [Uninstall Ruby Agent](https://www.manageengine.com/products/applications_manager/help/apm-insight-ruby-agent-uninstall.html)
- [Release Notes](https://www.manageengine.com/products/applications_manager/help/apm-insight-ruby-agent-release-notes.html)

**Note:** Do not install the APM Insight Agent along with other Application Performance Management (APM) tools. The APM Insight Agent installation may fail if there are other APM products installed in the same environment.

## Agent Configurations

- [Ruby Agent Configuration](https://www.manageengine.com/products/applications_manager/help/apm-insight-ruby-agent-configuration.html)
- [Grouping Similar Transactions](https://www.manageengine.com/products/applications_manager/help/apm-insight-ruby-agent-grouping-similar-transactions.html)
- [Custom instrumentation and exception tracking](https://www.manageengine.com/products/applications_manager/help/apm-insight-ruby-agent-custom-instrumentation-and-exception-tracking.html)
- [How to use environment variables in agent configuration](https://pitstop.manageengine.com/portal/en/kb/articles/https-pitstop-manageengine-com-portal-en-kb-articles-possibility-of-providing-environment-variable-in-apminsight-conf-file)

## Troubleshooting

For troubleshooting tips, go to our [Support Portal](https://pitstop.manageengine.com/portal/kb/articles/apm-insight-troubleshooting-tips-ruby-on-rails-agent).