診断モニター—ArcGIS Pro | ドキュメント

[診断モニター] は、ArcGIS Pro の統合された診断機能です。 ArcGIS Pro の実行中に、[診断モニター] でステータス情報、ログ、およびイベントが表示され、継続的に更新されます。[診断モニター] には、一連のタブとステータスインジケーターが含まれています。現在、[診断モニター] には、[カウンター] タブ、[タスク] タブ、[HTTP] タブ、[ログ] タブ、[診断プロパティ] タブ、および [状態] タブがあります。

[診断モニター] ダイアログボックス上の情報を使用して、非応答状態、リソースの過剰消費、機能障害、パフォーマンスの低下など、アプリケーションのさまざまな問題を診断できます。

診断モニターの概要

注意:

[診断モニター] は、ArcGIS Pro ベースのすべての製品で使用でき、ArcGIS Enterprise 配置用の「ArcGIS Monitor」とは異なる製品です。

診断モニターの開始

[診断モニター] ウィンドウを開くと、診断モードが有効になります。

[診断モニター] ウィンドウは、次の方法で開くことができます。

開いているプロジェクトで、リボン上の [ヘルプ] タブをクリックします。 [パフォーマンス] グループで、[診断モニター] をクリックします。
ArcGIS Pro が開いている状態で、Ctrl + Alt + M キーを押します。プロジェクトを開く必要はありません。
コマンドラインスイッチの ArcGIS Pro を使用して、/enablediagnostics を起動します。

コマンドラインオプションを使用すると、/loglevel=debug パラメーターを指定して、[診断モニター] でデバッグモードを有効にできます。デバッグモードは、[ログ] タブで無効にしない限り、後続の ArcGIS Pro セッションを通じて有効です。

注意:

[診断モニター] をコマンドラインから有効にした場合、ダイアログボックスは、当初、Microsoft Windows のタスクバー上で最小化されています。

[診断モニター] でワークフローのトラブルシューティングを行うには、問題が発生しているエリアで作業する前に、モニターを開きます。 ArcGIS Pro の他のすべてのウィンドウの上に常に表示されるよう [診断モニター] ダイアログボックスを構成するには、ダイアログボックスのキャプションエリアを右クリックして、[常に上部に表示] をクリックします。さまざまなアプリケーション機能を使用しながら、[診断モニター] でアクティビティを厳密に監視したい場合は、これが便利です。

ArcGIS Pro のアーキテクチャの概要

ArcGIS Pro は、64 ビットのマルチスレッドモジュールアプリケーションです。機能的なサブシステムがオンデマンドで読み込まれ、ワーカースレッド内または個別のワーカープロセス内で作業 (バッファーの計算やマップのレンダリングなど) を実行します。ほとんどの場合、作業 (操作) の論理単位は、実行中に 1 つ以上のタスクにまとめられます。タスクは ArcGIS Pro で作業を実行する方法において中心的役割を果たし、[診断モニター] 内で目立つように特徴付けられています。

専用のスレッドは、アプリケーションのユーザーインターフェイスエレメントをレンダリングする役割、およびキーボード入力とマウスクリックの形式でのユーザー入力を処理する役割を担います。いずれかのワーカースレッドで操作が実行されている間、GUI (グラフィカルユーザーインターフェイス) スレッドは、操作の進捗状況と、操作をキャンセルする方法 (該当する場合) に関連するフィードバックを提供します。 [診断モニター] は、GUI とは関係のないスレッドで動作します。このため、GUI スレッドが応答しなくなっても、[診断モニター] ダイアログボックスは応答性を維持できます。

ArcGIS Pro のワーカースレッドは、特定の機能領域専用のファミリーに分割されています。

[フォアグラウンドスレッド] - 現在読み込まれているプロジェクトの構成状態のプライマリリポジトリである CIM (Cartographic Information Model) を管理する 4 つのワーカースレッドのセット。これらのスレッドは、マップレンダリングの高速化にも役立ちます。フォアグラウンドスレッドで操作が実行されている間は、一部の種類のユーザー操作が禁止されます。
[高優先度のバックグラウンドスレッド] および [低優先度のバックグラウンドスレッド] - これらのスレッドは、CIM の状態に依存しない広範囲な操作を実行し、ユーザーが他の操作を実行している間、バックグラウンドで実行できます。高優先度のバックグラウンドスレッドに割り当てられているタスクは、低優先度のバックグラウンドスレッドに割り当てられているタスクよりも高速に実行され、優先度が高くなります。
[その他のスレッド] - バックグラウンドジオプロセシングスレッドは、バックグラウンドジオプロセシング操作の実行に使用されます。多くの場合、このスレッドは内部で他のスレッドと連携して操作を完了します。共有バックグラウンドスレッドは、一連のタスクを長時間にわたって同じ一貫したスレッドで実行する必要がある特別な場合に使用されます。

ステータスエリア

[ステータス] エリアには、[ステータス] インジケーターと [スレッドアクティビティ] インジケーターが含まれています。 [ステータス] インジケーターは、現在のアプリケーションステータスに応じてさまざまな色を表示します。これらのインジケーターは、アプリケーションで発生している問題を絞り込むために役立ちます。 [スレッドアクティビティ] インジケーターは、対応するスレッドのステータスに基づいて色を表示します。

ステータスインジケーター


エレメント	説明
	赤色は、GUI スレッドがメッセージを送信しなくなり、マウスまたはキーボード入力に反応できないことを示します。GUI スレッドが応答していないと、UI グラフィックスが正しくレンダリングされない可能性があります。非応答の発生は、非応答ログに記録されます。
	黄色は、アクティブなタスクに関連付けられたプロセッサーがないため、タスクの実行中に不適切なフィードバックがユーザーに提示されている場合を示します。この状態が検出されると、関連するタスクにもタスクログで黄色のフラグが付けられます。
	黄色は、タスクの発行率が 1 秒あたり 10 を超えていることを示します。
	緑色は、アプリケーションで 1 つ以上の HTTP リクエストが現在アクティブであることを示します。
	緑色は、フォアグラウンドスレッドで現在タスクが実行されていることを示します。フォアグラウンドタスクが実行されている間、さまざまなボタンおよびツールが使用できないことがあります。
	黄色は、ビュー (通常は、マップ、グローブ、シーン、またはレイアウトを含む) が現在ビジー状態であることを示します。ビューがビジー状態である間、さまざまなボタンおよびツールが使用できないことがあります。
	黄色は、ウィンドウが現在ビジー状態であることを示します。ウィンドウがビジー状態である間、さまざまなボタンおよびツールが使用できないことがあります。
	黄色は、いずれかのフォアグラウンドスレッドで描画関連の操作が現在実行されているためにタスクが停止されていることを示します。アプリケーションが待機状態である間、さまざまなボタンおよびツールが使用できないことがあります。
	黄色は、以前に一時停止された描画操作が再開されている間、タスクは停止されていることを示します。アプリケーションが再開している間、さまざまなボタンおよびツールが使用できないことがあります。
	緑色は、ジオプロセシング操作が現在実行されていることを示します。このインジケーターは、そのジオプロセシング操作がバックグラウンドであるかフォアグラウンドであるかに関係なく点灯します。

スレッドアクティビティインジケーター

前述の各スレッドは、[診断モニター] のステータスエリア内に、対応するアクティビティインジケーターを持っています。関連付けられているスレッドが現在実行されている場合、スレッドステータスインジケーターは緑色で、スレッドが非アクティブ (スリープ状態) である場合はグレーです。ホストコンピューターの CPU に、追加のスレッドをサポートするための十分なコアがない場合、スレッドステータスインジケーターはダークグレーで表示されることがあります。

診断モニターのタブ

[診断モニター] は、[カウンター] タブ、[タスク] タブ、[HTTP] タブ、[ログ] タブ、[診断プロパティ] タブ、[状態] タブで構成されています。 [カウンター] タブには、内部カウンターが一覧表示されます。 [タスク] タブには、最近のタスクが表示されます。 [HTTP] タブには、HTTP リクエストと応答のビューアーが表示されます。 [ログ] タブには、イベントログビューアーが表示されます。 [診断プロパティ] タブには、診断情報が表示されます。 [状態] タブでは、有効化されたアプリケーションのすべての状態と、対応する ArcGIS Pro セッションに関連付けられたアクティブビューの状態を表示できます。

カウンタータブ

[カウンター] タブは、名前付きの内部カウンターのリストで構成されています。各カウンターは、リストの上にあるグラフにリンクされています。リスト内のカウンターが選択されると、グラフが更新され、直近 20 秒間のそのカウンターの履歴値が表示されます。

カウンターリストの中には、メモリ消費量、スレッド数、HTTP リクエスト数、読み込まれた DLL 数など、役に立つメトリクスがあります。いくつかのカウンターについて、さらに説明する必要があります。

現在のタスクレート - タスクがフォアグラウンドスレッドのキューに配置されている現在のレート。数値が高い場合は、操作を実行するために必要以上に多数のタスクが発行されている可能性があります。多数のタスクでの操作は、効率が低くなる可能性があります。
CIM カウンター - これらのカウンターは、CIM 上の読み取り/書き込み操作の総数の記録に使用されます。描画関連の読み取り/書き込みは、個別にカウントされます。各操作には関連するオーバーヘッドがあるため、時間内で大きな移動よりも小さな移動のほうが望ましくなります。
HTTP リクエストのタイムアウト総数のカウンター - これらのカウンターは、タイムアウトした HTTP リクエストの総数と比率を記録するために使用されます。これらのカウンターをインクリメントするリクエストは、HTTP 応答コード 408 と 504 に最もよく関連付けられます。
IRequest カウンター - これらのカウンターは、内部使用に向けて予約されています。

タスクタブ

[タスク] タブには、ユーザー操作から最近発行されたタスクのログと、GUI スレッドで発生した非応答状態のもう 1 つのログが含まれます。

最近の UI タスクログ

最近の UI タスクログは、ユーザーの操作に応じて発行された最新のタスクのレコードを提供します。タスク機能の識別に関連するオーバーヘッドのため、このログは、[診断モニター] ダイアログボックスが閉じているときには使用できません。デフォルトでは、最後に実行されたタスクがリストの一番上になるようにタスクが時系列で並べ替えられています。内部タスク (実行されている外部タスク内からキューに配置される) は、このリストには表示されません。キューに配置されている、または現在実行されているタスクは、緑色で表示されます。各タスクには、一連のプロパティが関連付けられています。

[タスク #] - タスクの順序における位置を示す数値。たとえば、タスク # 42 は、実行中のプロセス内の 42 番目の実行タスクを示します。
[キューに配置された時間] - タスクが最初にキューに入れられたときの実測時間。別のタスクがまだ実行中であるときに起動されたタスクは、キューに配置され、現在のタスクが完了するまで実行が開始されません。フォアグラウンドタスクが実行されている間は、通常、ボタンとコントロールが無効になっています。これにより、アプリケーションの状態が遷移している間に、追加のタスクがキューに配置されないようになります。
[タスク時間] - タスクの実行に関連付けられている時間 (ミリ秒単位)。
[再開時間] - 描画の再開が完了するまでの待機に費やされた時間 (ミリ秒単位)。
[待ち時間] - 描画関連の操作が完了するまでの待機に費やされた時間 (ミリ秒単位)。
[合計時間] - タスクがキューに配置された時点から、タスクが完了する時点まで、タスクの実行に必要となった合計時間 (ミリ秒単位) (描画の再開に関連する時間を含む)。
[関数] - タスクに最適に関連付けられている最も外側の関数の名前。

キューに配置されている、またはまだ実行中のタスクでは、その時間値に -1 が表示されます。タスクが完了するか、キャンセルされると、実際の時間がミリ秒単位で表示されます。

ヒューリスティックを使用して、キューに配置されているタスクに最も関連する関数が表示されます。ヒューリスティックは、コールスタックを調べて、非 OS 関数を含むフレームを探します。

最近の UI タスクログは、任意の列によって昇順または降順で並べ替えできます。この機能は、たとえば、実行時間が最も長いタスクを識別するために使用できます。ログの内容は、リスト上の任意の場所を右クリックして [コピー] または [消去] をそれぞれクリックすることで、クリップボードにコピーまたは消去できます。

非応答ログ

GUI スレッドが応答しなくなると必ず、開始時間と合計期間を含む非応答状況イベントがログに記録されます。このログの内容は、リスト上の任意の場所を右クリックして [コピー] をクリックすることで、クリップボードにコピーできます。

HTTP タブ

[HTTP] タブには、HTTP リクエストと応答のログが含まれ、並べ替え機能が提供されます。 [診断モニター] を開くと、ArcGIS Pro から送信された HTTP リクエストがこのビューアーに記録されます。

記録された HTTP リクエストは、最新のリクエストから古いリクエストの順でビューアーに追加されます。

[URL] 列には、リクエストの送信先の URL が含まれます。応答待ちのリクエストは、最初の列に下矢印が表示されるので識別できます。完了すると、サーバーから受信した応答が、その行の [ステータス] 列に追加されます。

ログタブ

[ログ] タブには、イベントログビューアーが含まれ、ソート機能とフィルター機能提供されます。 ArcGIS Pro の多くのサブシステムは、診断モードで実行すると、イベントログに診断情報をアプリケーションイベントとして書き込みます。イベントロギングは、[診断モニター] を開くと開始され、ArcGIS Pro を閉じるまで有効です。

4 つのイベントタイプがあります。

エラー - 操作中の重大な障害を示すために使用されます。
警告 - 重大性が低く、場合によっては無視できます。
情報 - 操作に関する追加のコンテキスト情報を提供するために発行されます。
デバッグ - 主に Esri のスタッフに向けた、詳細な実装情報。

イベントタイプは、リストの上部にある対応するチェックボックスを使用して、リスト内でフィルター処理できます。エラーイベントは、その重要性から常にリストに含まれており、除外できません。フィルターエントリは、より選択的に使用できます。ここにテキストが入力されると、少なくとも 1 つの列にそのテキスト (大文字と小文字が区別されない) が含まれるイベントだけが表示されます。

一致するイベントの総数が、[ログ] タブの右上に表示されます。イベントロギングはライブプロセスとして開始されます。新しいイベントが記録されると、それらはすぐに [ログ] タブに挿入されます。ログ内のイベント総数が 100,000 以上に達すると、残りのセッションではライブロギングが無効になります。新しいイベントは記録されますが、[ログ] タブにすぐには表示されません。イベント総数の左側に [更新] ボタンが表示されます。 [更新] ボタンをクリックすると、[ログ] タブのコンテンツが更新されます。バックグラウンドで記録されたイベントは、タブが更新されると追加されます。

ログファイル

ログファイルは、デフォルトでは、ArcGIS\Diagnostics サブフォルダー内のユーザーの Documents フォルダーの下に保存されます。 ArcGIS Pro の場合、ログファイルは ArcGISProLog-16360~89343E4F-74E8-4F26-A705-B805E8C92BB0 のように表示され、次のプロパティがあります。

ArcGISProLog は、ホスト実行可能ファイルの名前です。
16360 は、プロセス ID です。
89343E4F-74E8-4F26-A705-B805E8C92BB0 は、そのインスタンスに作成された一意の ID です。

Documents フォルダー以外のディレクトリにログファイルを保存したい場合は、別の出力ディレクトリを指定できます。 Windows レジストリを使用して、Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ESRI\ArcGISPro\Settings\ または Computer\HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Settings\ のいずれかに EventLogLocation という名前の REG_SZ キーを作成します。このキーの値を、ログファイルの保存先となる代替ディレクトリに設定します。次回 ArcGIS Pro を診断モードで実行すると、ログファイルは <EventLogLocation>\ArcGIS\Diagnostics に保存されます。

注意:

Windows のユーザープロファイルには、EventLogLocation 値として指定されたディレクトリへの読み取り権限と書き込み権限が必要です。

EventLogLocation 値として指定されたディレクトリに ArcGIS Pro がログファイルを保存できない状況の対策として、フォールバック (予備) メカニズムが用意されています。 ArcGIS Pro は、HKEY_LOCAL_MACHINE で設定された EventLogLocation ディレクトリに書き込みできない場合は、代わりに HKEY_CURRENT_USER で設定された EventLogLocation 値にログファイルを書き込もうとします。どちらのディレクトリも指定されていないか、書き込みできない場合、ログファイルはデフォルトの Documents\ArcGIS\Diagnostics フォルダーに保存されます。

注意:

有効な EventLogLocation レジストリキーが HKEY_LOCAL_MACHINE と HKEY_CURRENT_USER の両方に存在している場合、HKEY_LOCAL_MACHINE にある値が優先されます。

診断プロパティタブ

[診断プロパティ] タブには、エラーレポートに挿入される診断情報が含まれます。このエラーレポートは Esri スタッフによって確認されます。

[名前] 値の意味は次のとおりです。

per_user_install - [診断モニター] が実行されている ArcGIS Pro のインストールが、ユーザー単位のインストールであるか、コンピューター単位のインストールであるかを示すパラメーター。


値	定義
no	ArcGIS Pro のインストールは、コンピューター上のすべてのユーザーに対して実行されています。
yes	ArcGIS Pro のインストールは、サインイン済みのユーザーに対してのみ実行されています。

cmd_line - Windows が開いたときに、コマンドライン引数の後に ArcGIS Pro が続きます。

client_proto - 現在、ArcGIS Pro が使用されているコンピューターのタイプを示します。値は次のとおりです。


値	定義
0	ArcGIS Pro はコンピューター上でネイティブに実行されています。
1	ArcGIS Pro は仮想コンピューター (VM) 上で実行されています。
2	ArcGIS Pro は Windows リモートデスクトッププロトコル (RDP) によってアクセスされているコンピューター上で実行されています。

secondary-instance - ArcGIS Pro アプリケーションが、現在実行中のアプリケーションの唯一のインスタンスであるかどうかを示すパラメーター。
値定義
no
現在実行中の ArcGIS Pro のインスタンスは 1 つしかありません。
yes
現在、ArcGIS Pro の複数のインスタンスが実行されています。
Last active view - [診断モニター] でこのタブを確認する直前にアクティブであったアプリケーションの最後のビュー。値には、マップビュー、レイアウトビューなどの有効なビューのみ含まれます。上記の例では、esri_mapping_mapPane はマップビューを指します。
Last command - ユーザーが最後にクリックしたユーザーインターフェイスのボタン。上記の例では、esri_mapping_colorVisionSimulatorButton とは [色覚特性シミュレーター] ボタンを指します。
Last active dockpane - [診断モニター] でこのタブを確認する直前にアクティブであったアプリケーションの最後のウィンドウ。値には、[コンテンツ] ウィンドウや [カタログ] ウィンドウなどの有効なウィンドウが含まれます。上記の例では、esri_core_contentsDockPane は [コンテンツ] ウィンドウを指します。

値	定義
no	現在実行中の ArcGIS Pro のインスタンスは 1 つしかありません。
yes	現在、ArcGIS Pro の複数のインスタンスが実行されています。

状態タブ

[状態] タブでは、有効化されたアプリケーションのすべての状態と、対応する ArcGIS Pro セッションに関連付けられたアクティブビューの状態を任意の時点で表示でき、新しく追加された情報は、該当する列に太字のエントリとして挿入されます。

アプリケーションの状態とアクティブビューの状態はどちらも、ArcGIS Pro フレームワークで、実行されているタスクのために整理されたわかりやすいユーザーインターフェイスを提示するために、各種のユーザーインターフェイスエレメント (タブ、ボタン、ツールなど) を ArcGIS Pro で表示または有効化すべき場合とすべきでない場合を表すために使用されるメカニズムに属しています。

[診断モニター] の機能は、特に ArcGIS Pro アドインの開発者が、自分で定義した状態を有効化すべき場合とすべきでない場合にそれらの状態が有効化されているか確認するために役立ちます。

状況と状態の詳細をご確認ください。

描画パフォーマンスのオーバーレイ

[キーボードショートカット] ダイアログボックスの [グローバル] > [描画パフォーマンスのオーバーレイ] でオーバーレイのトラブルシューティングを有効化して、描画の統計情報を表示できます。指定されたショートカットキーを押して、オーバーレイのオン/オフを切り替えます。

パフォーマンス問題に対するトラブルシューティング

ArcGIS Pro を構成してパフォーマンスを向上させるヒントについては、Esri Community の「ArcGIS Pro でのパフォーマンス問題に対するトラブルシューティング」をご参照ください。

このトピックへのフィードバック

注意:

診断モニターの開始

注意:

ArcGIS Pro のアーキテクチャの概要

ステータス エリア

ステータス インジケーター

スレッド アクティビティ インジケーター

診断モニターのタブ

カウンター タブ

タスク タブ

最近の UI タスク ログ