コマンドラインを使用して、サービスの開始と停止など、合成サーバーのプラットフォーム管理タスクを実行できます。このページでは、使用可能なコマンド、ログファイル、および合成サーバーの到達可能性と健全性をテストするためのエンドポイントについて説明します。合成サーバーのホームの root ディレクトリからコマンドを実行します。

合成サーバーの開始と停止

以下のように、合成サーバーのホームの root ディレクトリから合成サーバーを開始します。

unix/deploy.sh start
BASH

合成サーバーサービスが実行中でアクセス可能であるかどうかを確認するには、次のコマンドを実行して、出力があることを確認します。

netstat -lan | grep "1[0,2,6]10[1,2]"
BASH

合成サーバーを停止するには、以下を行います。

unix/deploy.sh stop
BASH

合成エージェントサポートの強化

デフォルトで、合成サーバーをホストするマシンは、100 台の並行合成エージェントをサポートできる必要があります。100 台を超える並行合成エージェントをサポートするには、合成シェパードおよび合成スケジューラに設定するスロットルを変更します。デフォルトの 1 秒あたりの要求の最大数は 60 です。1 秒あたりの要求の最大数を増やすことで、合成サーバーはより多くの合成エージェントをサポートできます。

合成サーバーが受信可能な 1 秒あたりの最大要求数を増やすには、以下を行います。

  1. 合成サーバーをホストするマシンにログオンします。
  2. 合成サーバーホームの root ディレクトリに変更します。
  3. ファイル synthetic-processor/conf/synthetic-shepherd.yml を編集し、プロパティ maxRequestsPerSecondOverall の値を増加します。この構成例では、値は80になっています。

    throttleConfiguration:
        maxRequestsPerSecondOverall: 80
    TEXT
  4. ファイル synthetic-processor/conf/synthetic-scheduler.yml を編集し、プロパティ maxRequestsPerSecondOverall の値を増加します。この構成例では、値は 80 になっています。

    throttleConfiguration:
        maxRequestsPerSecondOverall: 80
    TEXT
  5. 合成サーバーを再起動します。

    unix/deploy.sh stop
    unix/deploy.sh start
    TEXT
  6. 変更した合成サーバーのログを確認することで、設定が更新されていることを確認できます。

    cat logs/scheduler/synthetic-scheduler.log | grep -oP -- "maxRequestsPerSecondOverall=\d+"
    cat logs/shepherd/synthetic-shepherd.log | grep -oP -- "maxRequestsPerSecondOverall=\d+"
    BASH
  7. また、合成サーバーの正常性を確認する必要もあります。

事前設定の正常性ルールとダッシュボードの作成

合成サーバーの監視が完了したら、以下のコマンドを実行して事前設定の正常性ルールとダッシュボードを作成します。

unix/post_deploy.sh
BASH

事前設定の正常性ルールとダッシュボードの詳細については、「事前設定のダッシュボードと正常性ルールの作成」を参照してください。

合成サーバーのアップグレード

update コマンドを使用して、合成サーバーをアンインストールまたは再インストールせずに、合成サーバーとデータベーススキーマを更新できます。手順については、合成サーバーのアップグレードを参照してください。

合成サーバーの正常性の確認

合成サーバーが実行されているかどうかを確認するには、以下を実行します。ユーザーは応答 pong を受信します。

curl <on-prem-synthetic_server_url>:10102/ping
curl <on-prem-synthetic_server_url>:12102/ping
curl <on-prem-synthetic_server_url>:16102/ping
BASH

合成サーバーの正常性を確認するには、以下を行います。

curl <on-prem-synthetic_server_url>:10102/healthcheck?pretty=true
curl <on-prem-synthetic_server_url>:12102/healthcheck?pretty=true
curl <on-prem-synthetic_server_url>:16102/healthcheck?pretty=true
BASH

合成サーバーが正常な場合、応答は以下のようになります。

curl <on-prem-synthetic_server_url>:10102/healthcheck?pretty=true

{
  "authentication" : {
    "healthy" : true
  },
  "deadlocks" : {
    "healthy" : true
  },
  "httpClient" : {
    "healthy" : true
  },
  "quartzScheduler" : {
    "healthy" : true
  }
BASH

curl <on-prem-synthetic_server_url>:16102/healthcheck?pretty=true

{
  "deadlocks" : {
    "healthy" : true
  }
BASH

curl <on-prem-synthetic_server_url>:12102/healthcheck?pretty=true

{
  "authentication" : {
    "healthy" : true
  },
  "cluster" : {
    "healthy" : true
  },
  "deadlocks" : {
    "healthy" : true
  },
  "linter" : {
    "healthy" : true
  },
  "quartzSynthBackgroundScheduler" : {
    "healthy" : true
  },
  "quartzSynthJobScheduler" : {
    "healthy" : true
  }
CODE

合成サーバーのログファイル

合成サーバーはサービスごとに以下のエラーログファイルを作成します。

  • <installDir>/logs/synthetic-scheduler.err
  • <installDir>/logs/synthetic-shepherd.err
  • <installDir>/logs/synthetic-feeder-client.err

一般の(エラー以外の)ログファイルは、以下のディレクトリを参照してください。

  • <installDir>/logs/scheduler
  • <installDir>/logs/shepherd
  • <installDir>/logs/feeder-client

一般的なログファイルの命名規則は <log>-YYYY-MM-DD.log です。ディスク容量不足とならないように、一般ログファイルのアーカイブまたは削除ポリシーを設定する必要があります。