本文へスキップ

エージェントのインストール

WhaTapモニタリングサービスを使用するには、会員登録後にプロジェクトを作成し、対象サーバーにエージェントをインストールする必要があります。会員登録に関する詳細については、次の文書を参照してください。

次の動画ガイドを参照してください。

プロジェクト作成​

エージェントをインストールする前にプロジェクトを作成してください。

  1. WhaTapモニタリングサービスに移動し、ログインします。

  2. プロジェクトを作成するには、画面左サイドメニューからプロジェクト全体 > + Projectボタンを選択してください。

  3. 商品選択 画面でプロジェクトにインストールする製品を選択してください。

  4. プロジェクト名、データサーバーリージョン、プロジェクトタイムゾーンなどの項目を設定してください。

  5. すべての設定を完了した後は プロジェクトを作成する ボタンを選択してください。

ノート

  • データサーバーリージョンは、リージョン(クラウドサービスを提供するためにインストールしたデータセンターのグループ)を意味します。特定のリージョンを選択すると、そのリージョンに所属するデータセンターにユーザーのデータが保存されます。

  • プロジェクトタイムゾーンは通知とレポートを生成する基準時間です。

  • 複数のプロジェクトをグループで管理する場合は、プロジェクトグループからグループを選択するか、グループを追加してください。 グループの詳細については、次の文書を参照してください。

  • 組織を選択してプロジェクトを追加する場合は、組織下位のグループを必須に設定する必要があります。

アクセスキーの確認​

アクセスキーは、WhaTapサービスを有効にするための固有IDです。

インストール手順セクションでプロジェクトアクセスキーの発行ボタンをクリックします。 アクセスキーを自動的に発行した後、次のステップを進みます。

ノート

プロジェクトを作成すると、自動的にエージェントインストールページに移動します。 エージェントインストールページが移動しない場合は、画面左側のメニューから管理 > エージェントインストールを選択してください。

エージェントダウンロード​

アクセスキーを発行されたら、使用するオペレーティングシステムを選択してください。次に、エージェントダウンロードセクションでオペレーティング システムのコマンドをコピーしてエージェントをインストールしてください。

PHPエージェントのインストール方法は、Linuxパッケージのインストールです。インストールの手順は次のとおりです。

  1. WhaTap リポジトリを登録します。

  2. whatap-php Linuxパッケージ(yum,apt-get)をインストールしてください。

  3. 設定スクリプトを実行してください。設定スクリプトのトレーサーはPHP拡張モジュールとして登録され、エージェントはwhatap-phpサービスとして実行されます。

    php

  4. ApacheまたはPHP-FPMを再起動してください。

ノート

エージェントファイル構成の詳細については、PHPファイル構成を参照してください。

PHPエージェントファイルの構成

PHPエージェントファイルは、アプリケーションモニタリングに必要な情報を抽出してWhaTap収集サーバーに送信するトレーサー、収集された情報をサーバーに送信するエージェント、トレーサーとエージェントをサーバーに動的に適用するインストールスクリプトファイルで構成されています。

  • whatap_X.Y.Z.so

    トレーサーとして登録されたPHP拡張モジュールとして追加され、情報を収集し、収集された情報をエージェントに送信するライブラリです。拡張モジュールはPHPバージョン(PHP API Version)とZend Thread Safe対応の可否によって判別されます。例は次のとおりです。

    • whatap_zts_20041225.so

      PHP 5.2バージョン、Zend Thread safe enable

    • whatap_20041225.so

      PHP 5.2バージョン、Non Thread Safe

  • whatap-php(whatap_php)

    エージェントは、トレーサーからUDPに送信された情報を収集サーバーに送信するプログラムです。

  • /etc/init.d/whatap-php

    サービススクリプトです。

  • whatap_php

    サービスの実行ファイルです。

  • whatap.ini

    アプリケーションサーバからデータを収集するPHP拡張モジュールの設定情報、収集サーバのアドレスとサーバのプロジェクトアクセスキーが入力されたファイルです。

  • template.ini

    whatap.ini 作成時、コピーして使用するテンプレートファイルです。

  • whatap-install-yyyymmdd.log

    インストールプロセスのログファイルです。基本の保存パスは_/usr/whata/php/logs_です。日付順にファイルが作成されます。基本的に7日間のログが保存されます。

  • whatap-boot-yyyymmdd.log

    エージェントのログファイルです。基本の保存パスは、_/usr/whata/php/logs_です。日付順にファイルが作成されます。基本的に7 日間のログが保存されます。

  • install.sh

    インストールスクリプトです。PHP拡張モジュール(_whatap.so _)をApacheまたはPHP-FPMにインストールし、whatap-phpサービスのインストールを進めます。詳細は次の文書を参照してください。

  • WhaTap.php (sample.php)

    PHPソースコードで使用するAPIリファレンスクラス(/usr/whatap/php/lib/WhaTap.php)およびサンプルソースファイル(sample.php)です。

使用するアプリケーションサーバー環境に応じてインストール方法を次のように提供します。 エージェントをインストールして適用する前に 動作環境を確認してください。