APMインサイトRubyエージェントのインストール

サポートする環境

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

APMインサイトRubyエージェントのインストール手順

• Herokuアプリケーションの場合
• その他のアプリケーションの場合

Herokuアプリケーションの場合

• Applications ManagerでAPMインサイト タブ > ヘルプ カードと移動し、ライセンス キー をコピーします。
• APMインサイトRubyエージェントファイル（apminsight.gem）を、エージェントダウンロードページからダウンロードしてください。
• ファイルをお客さまアプリケーションのホームディレクトリにコピーします。
• 「gemファイル」をテキスト エディターで開き、gem 'apminsight'を追記してください。
• 「bundle install」の実行で依存ファイルをインストールしてください。
• これらの変更をお客さまのプロジェクト リポジトリに送信します（方法はデプロイ手法によります）。
• Heroku > お客さまアプリケーション >設定 > 変数の設定と移動し、次の変数を追加してください。
  • LICENSE_KEY = ライセンス キー
  • APM_APPLICATION_NAME = アプリケーション名
• 最後に、Herokuにアプリケーションをデプロイします。

その他のアプリケーションの場合

• Applications ManagerでAPMインサイト タブ > ヘルプ カードと移動し、ライセンス キーをコピーします。
• Rubyエージェントのインストールは、2とおりの方法で可能です。
  • rubygems.orgから次のコマンドでインストールします。
    

    gem install apminsight

  • APMインサイトRubyエージェントファイル（apminsight.gem）をエージェントダウンロードページからダウンロードしコマンドを実行してください。
    

    gem install {path}/apminsight.gem

• Rails環境の場合
  • gemファイルに次の行を追加します。
    

    gem 'apminsight'

  • こちらを、次のコマンドでお客さまアプリケーションにバンドルします。
    

    bundle install

• Sinatra環境の場合
  • gemファイルに次の行を追加します。
    

    gem 'apminsight'

  • お客さまアプリケーションで、Bunde.requireを利用していない場合は、アプリケーション ファイルに次を追記してください。
    

    require 'apminsight'

• それぞれの環境にgemをインストールしたのち、設定ファイルapminsight.confを<Gem Installed folder>/apminsight/conf/ディレクトリから、アプリケーションのホーム ディレクトリにコピーします。
• apminsight.confをテキスト エディターで開き、application.name、apm.host、apm.port、license.keyの追加など必須項目の編集をおこなってください。Rubyエージェントの設定については、当社設定ガイドページを参照ください。
• 最後にアプリケーションサーバーを再起動します。