APMインサイトRuby on Railsエージェント

Applications ManagerのRubyエージェントをRailsプラットフォームにデプロイすると、エンド・エンドでWebトランザクションを認識でき、パフォーマンスの問題を手早く切り分け・解決できます。

Rubyアプリケーションのパフォーマンス監視には、エージェント（ruby gem）をアプリケーション サーバーにデプロイする必要があります。最新のRubyエージェントをダウンロードし、アプリケーション サーバーにデプロイしてください。エージェントでアプリケーションのパフォーマンス メトリック収集を行い、Applications Managerの中央サーバーに固定間隔で送信します（例：60秒ごと）。

APMインサイトRuby on Railsエージェントをインストールする

Rubyエージェントのインストール法は2つあります。

• Rubyのインストール先で、次のコマンドを実行してくだい。gem install apminsight

  または、

• apminsight.gemファイルを、当社ページか、RubyGemsサイトからダウンロードし、コマンドgem install apminsight.gemを実行します。

設定

gemインストール後の作業

• それぞれのお客さまアプリケーションで、アプリケーションgemファイルに次を追記してください。gem 'apminsight'

  または、

• それぞれのお客さまアプリケーションで、アプリケーションの初期化ブロックに次を追記してください。require 'apminsight'

設定ファイルapminsight.confのコピーは、<Gem Installed folder>/apminsight/conf/ ディレクトリにあります。クラス名を設定ファイル（include.packages）に記載すると、そのクラスにあるメソッドが組み込まれ、情報がトレース データで報告されるようになります。

apminsight.confファイルをテキスト エディターで開き、次のキーを追加してください。

例：

次の設定オプションは必須項目です。エージェントに指定をお願いします。

• application.name：Applications Managerに表示するアプリケーション名
• license.key：Applications ManagerのAPMインサイト タブに表示されるライセンス キー
• apm.host：Applications Managerが稼働しているホストのURL
• apm.port：Applications ManagerのHTTPSポート
• behind.proxy：エージェント インストール先のプロキシ ネットワーク
• agent.server.port：アプリケーション サーバーのHTTPリスニング ポート

Rubyエージェントのその他の設定オプションは、エージェント設定情報を参照ください。

メモ：エージェントのインストールに成功したかは、gem listコマンドで確認できます。実行すると、マシンにインストール済みのgemがリストアップされます。apminsight gemファイルがあるか、確認ください。

サポートする環境

• Ruby：1.8.7以上
• Rails：3.0以上

トラブルシュート

トラブルシュートのヒントは、サポート ポータルも参照ください。