Skip To Content

GeoAnalytics のヘルス チェック

ヘルス チェック操作により、GeoAnalytics Server 計算プラットフォーム内の計算リソースおよびジョブの状態が表示されます。ヘルス チェック操作は、GeoAnalytics Server が複数の GeoAnalytics Server コアおよびコンピューター全体に解析を分散できるようにする基本フレームワークです。トラブルシューティングおよび監視に使用できるヘルス チェック操作は、サーバーまたはポータルの管理者が使用できます。URL 形式の https://gis_geoanalytics_server.domain.com:6443/arcgis/admin を使用し、ArcGIS Server の Administrator Directory にログインしてアクセスします。ヘルス チェックに移動するには、GeoAnalytics Server サイトから、[System] > [Platform Services] > [Compute Platform] > [Health] をクリックします。

ヘルス チェック操作で、以下を行います。

  • 解析に使用されている GeoAnalytics Server コンピューターを検証および特定します。
  • 割り当てられたメモリとコアが使用されていることを検証します。
  • GeoAnalytics Server コンピューターで使用可能なコアおよびメモリの容量を確認します。これは、GeoAnalytics Server の設定を使用している場合に便利です。

    GeoAnalytics Server の設定の詳細

  • 現在実行中または完了した GeoAnalytics Server ジョブの数を確認します。
  • GeoAnalytics Server ジョブの jobID を検索して REST エンドポイントを表示します。
  • エラー メッセージのトラブルシューティングを行い、問題を解決します。
    注意:

    分散処理プラットフォームを初期化できないという内容のエラーが表示された場合は、ヘルス チェック操作を完了してワーカー ノードを確認します。ノードの状態を確認したら、「GeoAnalytics Server の一般的な問題とその解決方法」に記載された手順を完了します。

注意:

GeoAnalytics Server ヘルス チェックは、10.6.1 の ArcGIS Monitor を経由してアクセスすることもできます。

ArcGIS Monitor の詳細

計算プラットフォームのヘルス チェックは、解析を分散する基本フレームワークの用語を使用します。下表は、このドキュメントで使用する用語および概念についてまとめたものです。

期間説明

ノード

サーバー コンピューター。

ワーカー

計算に使用されるコンピューター。ワーカー コンピューターは、マスター コンピューターから指示を受け取り、それを実行します。マスター コンピューターに対して 1 台以上のワーカー コンピューターを設置できます。

マスター

ワーカー ノードを監視するサーバー。サーバーは、マスター ノードとワーカー ノードの両方の機能を持つことができます。

ジョブ

ジョブは、GeoAnalytics Server ツールの実行を意味します。

ヘルス チェックは、単一の値または配列で表されるキーで構成されます。GeoAnalytics Server ジョブが実行され、完了すると、ヘルス チェックはサイトの各 GeoAnalytics Server コンピューターについて以下のキーを確認します。

{
  "<geoanalytics server machine name>":{
  {.. url ..},
  {.. workers ..},
  {.. cores ..},
  {.. coresused ..},
  {.. memory ..},
  {.. memoryused ..},
  {.. activeapps ..},
  {.. completedapps ..},
  {.. activedrivers ..},
  {.. status ..}
}

サイトに複数のコンピューターがある場合は、複数の geoanalytics service machine name keys があります。マスター ノードのコンピューターにのみ、リソースおよびジョブの情報が格納されます。ワーカー ノードには null および 0 の値のみが格納されます。最上位レベルのサーバー オブジェクト内では、次のキーには値の配列が格納されます: workersactiveappscompletedapps、および activedrivers。最上位レベルのキーの urlcorescoresusedmemorymemoryused、および status キーには単一の値が格納されます。

各キーについて、次の例を用いて説明します。

  • 例 1: 3 台のコンピューターがある GeoAnalytics Server サイトで、単一のジョブが実行されています。
    • 各コンピューターには 16 GB の RAM と 4 つの CPU コアが搭載されています。
    • システム プロパティは、使用可能な RAM の最大 80% をデフォルト値として使用します。
    • GeoAnalytics Server は、コンピューターごとに 12 GB の RAM を使用するよう設定されています。
    • GeoAnalytics Server は、すべてのコンピューターを通じて 9 つのコアを使用するよう設定されています。
  • 例 2: 3 台のコンピューターがある GeoAnalytics Server サイトで、同時に 2 つのジョブが実行されています。
    • 各コンピューターには 16 GB の RAM と 4 つの CPU コアが搭載されています。
    • システム プロパティは、使用可能な RAM の最大 80% をデフォルト値として使用します。
    • GeoAnalytics Server は、コンピューターごとに 6 GB の RAM を使用するよう設定されています。
    • GeoAnalytics Server は、すべてのコンピューターを通じて 4 つのコアを使用するよう設定されています。

サイトの情報とリソース

urlcorescoresusedmemorymemoryused、および status の各キーについてはこのセクションで説明します。GeoAnalytics Server サイトに複数のコンピューターが配置されている場合、url キーは複数あります。url キーのいずれか 1 つに、以下の例のような値が格納されます。残りのすべての url キーには値 0 が格納され、ワーカーはリストされません。値が格納された URL はマスター ノードです。その他の URL は、ワーカーとして表されたコンピューターです。activedrivers キーは常に空の配列です。

例 1例 2
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [
           {
               ...worker1...
           },
           {
               ...worker2...
           },
           {
               ...worker3...
           }
       ],
       "cores": 9,
       "coresused": 9,
       "memory": 36864,
       "memoryused": 36864,
       "activeapps": [ ... ],
       "completedapps": [ ... ],
       "activedrivers": [],
       "status": "ALIVE"
   },
   "machine2.example-esri.com": {
       "url": "spark://machine2.example-esri.com:7077",
       "workers": [],
       "cores": 0,
       "coresused": 0,
       "memory": 0,
       "memoryused": 0,
       "activeapps": [],
       "completedapps": [],
       "activedrivers": [],
       "status": "STANDBY"
   },
   "machine3.example-esri.com": {
       "url": "spark://machine3.example-esri.com:7077",
       "workers": [],
       "cores": 0,
       "coresused": 0,
       "memory": 0,
       "memoryused": 0,
       "activeapps": [],
       "completedapps": [],
       "activedrivers": [],
       "status": "STANDBY"
   }
}
{
 "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",       "workers": [           {
               ...worker1...           },           {
               ...worker2...           },           {
               ...worker3...           }
       ],       "cores": 9,       "coresused": 8,       "memory": 36864,       "memoryused": 36864,       "activeapps": [ ... ],       "completedapps": [ ... ],       "activedrivers": [],       "status": "ALIVE"
   },   "machine2.example-esri.com": {
       "url": "spark://machine2.example-esri.com:7077",       "workers": [],       "cores": 0,       "coresused": 0,       "memory": 0,       "memoryused": 0,       "activeapps": [],       "completedapps": [],       "activedrivers": [],       "status": "STANDBY"
   },   "machine3.example-esri.com": {
       "url": "spark://machine3.example-esri.com:7077",       "workers": [],       "cores": 0,       "coresused": 0,       "memory": 0,       "memoryused": 0,       "activeapps": [],       "completedapps": [],       "activedrivers": [],       "status": "STANDBY"
   }
}

説明

  • url - 接頭辞 Spark と Spark のポートを含む、GeoAnalytics Server コンピューターのURL。URL は、コンピューターごとに 1 つのみリストできます。
  • cores - サイトのすべての GeoAnalytics Server コンピューターで GeoAnalytics Server が使用できるコアの合計数。使用可能なコアの合計数に percentageMaxAllowedComputeCores の設定 (デフォルトは 80%) を乗じた値です。たとえば、16 コアを搭載した単一コンピューターがあり、percentageMaxAllowedComputeCores が 80% 、使用するコアの数が 2 に設定されている場合、値は floor(16 * .8) = 12.8 になります。
  • coresused - GeoAnalytics Server サイトのすべてのコンピューターで、GeoAnalytics Server 解析で現在使用されているコアの合計数。
  • memory - サイトのすべての GeoAnalytics Server コンピューターで GeoAnalytics Server が使用できる合計メモリ容量 (MB)。各コンピューターのメモリ容量に percentageMaxAllowedComputeMemory とコンピューター数を乗じた値です。たとえば、32 GB の RAM を搭載したコンピューターで、percentageMaxAllowedComputeCores が 50% に設定され、使用される RAM が 12 GB に設定されている場合、値は floor(32 * .5) = 16 になります。
  • memoryused - GeoAnalytics Server サイトのすべてのコンピューターで、GeoAnalytics Server 解析で現在使用されているメモリの合計容量。
  • activedrivers - 常に空の配列です。

ワーカー

workers キーは、GeoAnalytics Server サイトの一部としてコンピューターおよび情報を識別します。

例 1例 2
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [
           {
               "id": "worker-20180302114515-10.33.9.162-56544",
               "host": "10.33.9.162",
               "port": 56544,
               "cores": 3,
               "coresused": 3,
               "coresfree": 0,
               "memory": 12288,
               "memoryused": 12288,
               "memoryfree": 0,
               "state": "ALIVE",
               "lastheartbeat": 1520469707880
           },
           {
               "id": "worker-20180302114111-10.33.10.149-56543",
               "host": "10.33.10.149",
               "port": 56543,
               "cores": 3,
               "coresused": 3,
               "coresfree": 0,
               "memory": 12288,
               "memoryused": 12288,
               "memoryfree": 0,
               "state": "ALIVE",
               "lastheartbeat": 1520469712961
           },
           {
               "id": "worker-20180302113155-10.33.9.165-56540",
               "host": "10.33.9.165",
               "port": 56540,
               "cores": 3,
               "coresused": 3,
               "coresfree": 0,
               "memory": 12288,
               "memoryused": 12288,
               "memoryfree": 0,
               "state": "ALIVE",
               "lastheartbeat": 1520469712874
           }
       ],
    ...
    },    
   "machine2.example-esri.com": {...},
   "machine3.example-esri.com": {...}
   }
}
{
   "machine1.example-esri.com": {
       "url": "machine1.example-esri.com:7077",       "workers": [           {
               "id": "worker-20180302114515-10.33.9.162-56544",               "host": "10.33.9.162",               "port": 56544,               "cores": 3,               "coresused": 2,               "coresfree": 1,               "memory": 12288,               "memoryused": 12288,               "memoryfree": 0,               "state": "ALIVE",               "lastheartbeat": 1520469707880           },           {
               "id": "worker-20180302114111-10.33.10.149-56543",               "host": "10.33.10.149",               "port": 56543,               "cores": 3,               "coresused": 3,               "coresfree": 0,               "memory": 12288,               "memoryused": 12288,               "memoryfree": 0,               "state": "ALIVE",               "lastheartbeat": 1520469712961           },           {
               "id": "worker-20180302113155-10.33.9.165-56540",               "host": "10.33.9.165",               "port": 56540,               "cores": 3,               "coresused": 3,               "coresfree": 0,               "memory": 12288,               "memoryused": 12288,               "memoryfree": 0,               "state": "ALIVE",               "lastheartbeat": 1520469712874           }
       ],    ...    },       "machine2.example-esri.com": {...},
   "machine3.example-esri.com": {...}
   }
}

説明

  • id - ワーカーの一意な ID。
  • host - コンピューターのホスト アドレス。
  • port - GeoAnalytics Server 解析で使用されるコンピューターのポート。各ワーカーは、専用ポートを割り当てられています。これらのポートは、通信できるよう開いている必要があります。
  • cores - そのコンピューターでの GeoAnalytics Server 解析に割り当てられたコアの数。これは GeoAnalytics Server の設定を使用して設定され、percentageMaxAllowedComputeCores の設定を表します。
  • coresused - GeoAnalytics Server 解析で現在使用されているコアの数。GeoAnalytics ツール が実行されている場合、これは 0 より大きい値になるはずです。
  • coresfree - このコンピューターの GeoAnalytics Server 解析で、現在未使用でただちに使用できるコアの数。すべてのコンピューターでこの値が cores に等しい場合、GeoAnalytics ツール は現在実行されていません。
  • memory - コンピューターの GeoAnalytics Server 解析に割り当てられたメモリ容量 (MB)。これは GeoAnalytics Server の設定を使用して設定され、percentageMaxAllowedComputeMemory の設定を表します。
  • memoryused - 特定コンピューターによって GeoAnalytics Server 解析で現在使用されているメモリ容量 (MB)。
  • memoryfree - このコンピューターの GeoAnalytics Server 解析で、現在未使用でたただちに使用できるメモリ容量 (MB)。memoryfree の容量は、GeoAnalytics ツール が実行される各コンピューターのサーバー設定 (各コンピューターの各ジョブに割り当て可能な最大容量 (GB)) で指定された容量と同じかそれより大きい必要があります。
  • state - 現在のコンピューターの状態。ALIVE がオンの場合、ジョブを実行できる状態か、ジョブが 1 つ実行中です。STANDBY は、ジョブが開始されると ALIVE に切り替わります。DEAD は、エラーの可能性を示しています。GeoAnalytics Server を再起動する必要があります。UNKNOWN は、エラーの可能性を示しています。GeoAnalytics Server を再起動する必要があります。コンピューターの状態が DEAD または UNKNOWN から ALIVE または STANDBY に切り替わらない場合は、Esri Support にお問い合わせください。
  • lastheartbeat - 現在のコンピューターがマスター ノードと通信した最終時間 (エポックからのミリ秒)。

完了したアプリ

completedapps キーにより、完了した GeoAnalytics Server ツールおよび情報を確認します。このキーには、正常に完了したツールおよびエラーが発生したツールが格納されます。完了したアプリの情報は、GeoAnalytics Server の再起動時に消去されます。

例 1例 2
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [...],
       ...,
       "activeapps": [...],
       "completedapps": [
           {
               "starttime": 1520469691617,
               "id": "app-20180307164131-0008",
               "name": "ArcGIS GeoAnalytics (jcb8bda25a3f14dc7835dca0b3267b42c)",
               "cores": 9,
               "user": "agstest",
               "memoryperslave": 12288,
               "submitdate": "Wed Mar 07 16:41:31 PST 2018",
               "state": "FINISHED",
               "duration": 21947
           }
       ],
       "activedrivers": [],
       "status": "ALIVE"
   },
   "machine2.example-esri.com": {...},
   "machine3.example-esri.com": {...}
}
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",       "workers": [...],       ...,       "activeapps": [...],       "completedapps": [           {
               "starttime": 1520469691617,               "id": "app-20180307164131-0008",               "name": "ArcGIS GeoAnalytics (jcb8bda25a3f14dc7835dca0b3267b42c)",               "cores": 4,               "user": "agstest",               "memoryperslave": 6144,               "submitdate": "Wed Mar 07 16:41:31 PST 2018",               "state": "FINISHED",               "duration": 21947           }
       ],       "activedrivers": [],       "status": "ALIVE"
   },   "machine2.example-esri.com": {...},   "machine3.example-esri.com": {...}
}

説明

  • starttime - GeoAnalytics ツール のジョブの実行開始時間 (エポックからのミリ秒)。
  • id - ジョブの一意な ID。
  • name - ジョブの名前。これは常に ArcGIS GeoAnalytics (<jobID>) の形式になります。 jobID は、ジョブの実行時の REST エンドポイントで使用される jobID と同じです。
  • cores - すべてのコンピューターの解析で使用されるコアの合計数。
  • user - ジョブを実行したユーザー。これは、ArcGIS Server を設定したユーザーで、サイト上のユーザーと必ず同じです。ジョブを実行したポータル メンバーではありません。
  • memoryslavepernode - 各コンピューターで使用されるメモリ容量。
  • submitdate - GeoAnalytics ツール のジョブが開始された時間 (判読可能なテキスト形式)。
  • state - 現在のジョブの状態。FINISHED は、ジョブが完了していることを示します。ジョブは、正常終了または異常終了している可能性があります。
  • duration - ジョブの合計実行時間 (ミリ秒)。

アクティブなアプリ

activeapps キーにより、現在実行中の GeoAnalytics ツール とその情報を確認します。ジョブが完了すると、情報は completedapps オブジェクトに移動します。

例 1
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [...],
       ...,
       "activeapps": [
           {
               "starttime": 1520464610794,
               "id": "app-20180307151650-0007",
               "name": "ArcGIS GeoAnalytics (j4b986eb5c603426fae7abe8e9d5d7afa)",
               "cores": 9,
               "user": "agstest",
               "memoryperslave": 12288,
               "submitdate": "Wed Mar 07 15:16:50 PST 2018",
               "state": "RUNNING",
               "duration": 5105025
           }
       ],
       "completedapps": [...]
   },
   "machine2.example-esri.com": {...},
   "machine3.example-esri.com": {...}
}
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",       "workers": [...],       ...,       "activeapps": [           {
               "starttime": 1520464610794,               "id": "app-20180307151650-0007",               "name": "ArcGIS GeoAnalytics (j4b986eb5c603426fae7abe8e9d5d7afa)",               "cores": 4,               "user": "agstest",               "memoryperslave": 6144,               "submitdate": "Wed Mar 07 15:16:50 PST 2018",               "state": "RUNNING",               "duration": 5105025           },           {
               "starttime": 1520469713951,               "id": "app-20180307164153-0009",               "name": "ArcGIS GeoAnalytics (j739627e916b34533be918fe98b0fcb90)",               "cores": 4,               "user": "agstest",               "memoryperslave": 6144,               "submitdate": "Wed Mar 07 16:41:53 PST 2018",               "state": "RUNNING",               "duration": 1868           }
       ],       "completedapps": [...]   },   "machine2.example-esri.com": {...},   "machine3.example-esri.com": {...}
}

説明

  • starttime - GeoAnalytics ツール の実行開始時間 (エポックからのミリ秒)。
  • id - ジョブの一意な ID。
  • name - ジョブの名前。これは常に ArcGIS GeoAnalytics (<jobID>) の形式になります。jobID は、ジョブの実行時の REST エンドポイントで使用されるジョブ ID と同じです。
  • cores - すべてのコンピューターの解析で使用されるコアの合計数。
  • user - ジョブを実行したユーザー。これは、ArcGIS Server を設定したユーザーで、サイト上のユーザーと必ず同じです。ジョブを実行したポータル メンバーではありません。
  • memoryslavepernode - 各コンピューターで使用されるメモリ容量。
  • submitdate - GeoAnalytics ツール が開始された時間 (判読可能なテキスト形式)。
  • state - 現在のジョブの状態。RUNNING はジョブが開始された時間を示します。WAITING は、リソースが十分かどうかを判別するため、ジョブが 1 分間待機することを示します。1 分以内に十分なリソースが準備できなかった場合、そのジョブはキャンセルされます。リソースがある場合は、RUNNING になります。
  • duration - ジョブの現在までの実行時間 (ミリ秒)。