Oracle Cloud Infrastructureドキュメント

Oracle E-Business SuiteでのAPM Javaエージェントのプロビジョニングとデプロイ

APMモニタリングでは、APM Javaエージェントをデプロイして、WebLogicサーバーで何が起きるかを取得する必要があります。この場合、これは oacoreおよび oafm WebLogicクラスタで実行する必要があります。

APM Javaエージェントのダウンロード

  1. Oracle Cloud Infrastructureコンソールにサインインします。
  2. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「Application Performance Monitoring」で、「管理」をクリックします。
  3. 「管理」ページで、左側のメニューから「APMエージェントのダウンロード」をクリックして、「APMエージェントのダウンロード」ページを開きます。
  4. 「APMエージェントのダウンロード」ページで、「Javaエージェント」を選択して、APM Javaエージェントをダウンロードします。

    APM Javaエージェント・ソフトウェア・ファイルがダウンロードされ、apm-java-agent-installer-<version>.jarファイルが含まれています。

APM Javaエージェントのプロビジョニング

  1. アプリケーション・サーバーがインストールされているホストに接続し、アプリケーション・サーバーをインストールしたユーザーと同じユーザーとしてログインし、アプリケーション・サーバー・ユーザーがAPM Javaエージェント・ファイルがダウンロードされるディレクトリに対する読取りおよび書込み権限を持っていることを確認します。ダウンロードしたAPM Javaエージェント・ソフトウェア・ファイルを任意のディレクトリにコピーします。
  2. アプリケーション・サーバーをインストールしたユーザーとしてログインしていることを確認し、APM Javaエージェント・ソフトウェアをコピーしたディレクトリに移動します。APM Javaエージェントをホストするディレクトリに対する読取りおよび書込み権限が必要です。
  3. APM Javaエージェントをプロビジョニングするために指定する必要がある次の必須の引数を確認します。
    • -service-name: モニターされているサービスの名前。この引数を使用すると、トレース・エクスプローラ・ユーザー・インタフェースで、サービスでフィルタしてトレースを表示できます。EBS環境の場合は、一時値としてEBS_WLSを使用します。後で、モニター対象の各WLSクラスタの特定の値で構成をオーバーライドします。
    • -destination: APM Javaエージェントがプロビジョニングされる宛先ディレクトリ。この場合、EBS宛先ディレクトリ<PATH_TO_fs_ne> (非エディション・ディレクトリのEBSフルパス)を指します。例: /u01/ebs122/fs_ne/ディレクトリ。
    • -private-data-key: APMドメインの作成時に生成されるAPM Javaエージェント(プライベート・データ・キー)によって使用されるエージェント・インストール・キー。
    • -data-upload-endpoint: APMドメインの作成時に生成されるdataUploadEndpoint URL。

      プライベート・データキーおよびdataUploadEndpointの詳細は、データ・アップロード・エンドポイントおよびデータ・キーの取得を参照してください。

    オプション:

    • APM Javaエージェントをプロビジョニングするときに、追加の引数を指定できます。詳細は、プロキシ引数の指定を参照してください。

    • 次のコマンドを実行して、provision-agent引数のヘルプを表示できます。
      java -jar ./apm-java-agent-installer-<version>.jar provision-agent -help
  4. 前のステップで説明した必須の引数を指定し、次のjavaコマンドを実行することにより、エージェントをプロビジョニングします:
    java -jar ./apm-java-agent-installer-<version>.jar provision-agent -service-name=EBS_WLS -destination=/u01/ebs122/fs_ne/ -private-data-key=<Agent installation key generated during APM domain creation> -data-upload-endpoint=<dataUploadEndpoint URL generated during APM domain creation>

    次に例を示します:

    java -jar ./apm-java-agent-installer-1.1.jar provision-agent -service-name=apm_service -destination=$DOMAIN_HOME -private-data-key=IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD -data-upload-endpoint=https://dataUploadEndpoint.com
    javaコマンドの実行時に、APM Javaエージェントが正常にプロビジョニングされた場合:
    • Action [provision-agent] completed successfullyというメッセージが表示されます。
    • oracle-apm-agentディレクトリが宛先ディレクトリ内に作成されます。たとえば、/u01/ebs122/fs_ne/oracle-apm-agentです。

      oracle-apm-agentディレクトリには次のものが含まれます:

      • bin: アグリゲータのスタータが含まれます。
      • bootstrap: APM Javaエージェントをデプロイするために-javaagentコマンドで使用されるエージェント起動.jarファイルが含まれます。
      • config: 編集可能なグローバル構成ファイルが含まれます。このディレクトリには次のものが含まれます:
        • APM Javaエージェント構成引数が含まれるAgentConfig.propertiesファイル。
        • プローブに関連する構成情報が含まれるProbeConfig.acmlファイル。
      • install: <release-version>/configディレクトリが含まれます。これには、APM Javaエージェント・バイナリ・ファイルとデフォルト構成ファイルがあります。このディレクトリ内のファイルは変更しないでください。
      • version: APM Javaエージェントのリリース・バージョンおよびアクティブ化の日付に関する情報を含むバージョン・ファイル。

    javaコマンドが終了したが、APM Javaエージェントが正常にプロビジョニングされていない場合は、ApmAgentInstall.logファイルおよびアプリケーション・サーバーの出力ログでエラーの詳細を確認して、問題を修正できます。

ノート

APM Javaエージェントのダウンロードおよびプロビジョニングの詳細は、アプリケーション・サーバーでのAPM Javaエージェントのプロビジョニングおよびデプロイを参照してください。

WebLogic管理対象サーバーでのAPM Javaエージェントの有効化

Oracle Application Performance MonitoringからOracle E-Business Suiteへのアクセスを有効にするには、JVM構成をWebLogic管理対象サーバーに変更する必要があります。

oacoreおよび oafmサービスの各管理対象サーバーで、次の手順を実行します。

  1. 管理セキュリティ・ロールを持つユーザーとして、WebLogic Server管理コンソールにログインします。デフォルトでは、ユーザーweblogicです。
  2. 「サーバー」をクリックします。WebLogic管理サーバーおよび管理対象サーバーのサマリー・ページが表示されます。
  3. WebLogic管理対象サーバーを選択して、APM Javaエージェントをoacoreおよびoafmにデプロイします。
  4. 管理対象サーバーの設定用の様々なタブを含むページが表示されます。

    「サーバーの起動」タブをクリックします。

  5. 「チェンジ・センター」で、「ロックして編集」をクリックします。「引数」フィールドを、Oracle Application Performance Monitoringに必要なパラメータで更新します。既存の引数が変更されていないことを確認します。

    oacoreサービスの場合は、次を追加します。 

    -javaagent:<PATH_TO_fs_ne>/oracle-apm-agent/bootstrap/ApmAgent.jar -Dcom.oracle.apm.agent.service.name=oacore

    oafmサービスの場合は、次を追加します。 

    -javaagent:<PATH_TO_fs_ne>/oracle-apm-agent/bootstrap/ApmAgent.jar -Dcom.oracle.apm.agent.service.name=oafm
  6. 「保存」をクリックします。
  7. 「チェンジ・センター」で、「変更のアクティブ化」をクリックして変更をアクティブ化します。
  8. 各管理対象サーバーでJVM引数が更新されるまで、oacoreおよびoafmサービスの各管理対象サーバーに対して前述のステップをすべて繰り返します。
  9. 管理対象サーバーを停止および起動するには、Oracle E-Business Suite環境の$ADMIN_SCRIPTS_HOMEにあるスクリプトを使用して管理対象サーバーを再起動します。

APMエージェントが正常にインストールされたら、「参照」注入タイプのブラウザ・エージェントを「oacore」管理対象サーバーに関連するAPMエージェントで構成することで、Oracle E-Business Suite環境でエンド・ユーザー監視を有効にできます。