WSO2 サーバー用 Java エージェント

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

  1. 以下のリンクからエージェントの tar ファイルをダウンロードします。
curl --header "PRIVATE-TOKEN: $TOKEN " --output agent.zip "https://artifacts-observability.sixthsense.rakuten.com/api/v4/projects/4/packages/generic/sixthsense/{{AGENT_VERSION}}/agent.zip"
  1. tar を WSO2_HOME にコピーし、解凍します。

エージェントの設定

  1. AGENT_HOME/plugins/apm-httpasyncclient-4.x-plugin-8.5.0.jar からプラグイン apm-httpasyncclient-4.x-plugin-8.5.0.jar ファイルを削除します。
AGENT_HOME="$WSO2_HOME/agent"
rm -rf $AGENT_HOME/plugins/apm-httpasyncclient-4.x-plugin-8.5.0.jar
  1. エージェントの agent.config ファイルで以下のパラメータを更新します。
agent.service_name= APPLICATION_NAME
agent.force_tls= true
collector.backend_service = URL
agent.authentication = TOKEN_FROM_UI

OneCloud Platform を使用する場合は、以下のコマンドを使用します。

agent.service_name= APPLICATION_NAME
agent.force_tls=${SW_AGENT_FORCE_TLS:false}
# For connectivity to backend using intra public network:
collector.backend_service = 133.237.176.44:80
# For connectivity to backend using onecloud private network:
collector.backend_service = 100.99.116.221:80
agent.authentication = TOKEN_FROM_UI

プロキシを有効にする

note

エージェントはバックエンドアドレスとの通信にインターネットを使用します。 インターネットへの直接アクセスが有効になっていない場合は、SixthSense バックエンドアドレスとの通信にプロキシを使用します。

以下のいずれかの方法でプロキシを有効にします。

  1. システム/コンテナレベルでプロキシを設定します。

例:

a. Windows Server: システムレベルの環境変数に HTTP_PROXY、GRPC_PROXY_EXP を追加します。

b. Linux Server:

~/.bashrc ファイルにプロキシを以下のように追加します。
export HTTP_PROXY= 10.0.0.1:3128 && export GRPC_PROXY_EXP=10.0.0.1:3128
  1. Java オプションにプロキシを追加して、JVM にプロキシを渡します。
JAVA_OPTS= -Dhttp.proxyHost=ip_address -Dhttp.proxyPort=3128 -Dhttps.proxyHost=ip_address -Dhttps.proxyPort=3128

WSO2-EI ESBサーバーの設定

WSO2-EI ESBサーバーのbin/integrator.shファイルに以下のエントリを追加します。

JAVA_OPTS="$JAVA_OPTS -javaagent:$WSO2_HOME/agent/sixthsense-agent.jar"