サーバー ログの操作

サーバー ログの監視は、エラーを特定し、問題のトラブルシューティングを行って、サイトに関する問題に対処する際に役立ちます。 ポータル ログの表示、検索、構成、削除を行うには、ArcGIS Server Manager を使用します。 ArcGIS Server Manager は、読み取りや操作が可能なテーブルにログ メッセージを集約します。

このヘルプ トピックのセクションでは、サーバー ログについて説明し、問題に対処する際のポータル ログの操作方法を示します。

• イベントのキャプチャー、クエリー検索、表示

• ログについて

• ログ フィルターを使用した検索結果の絞り込み

• サーバー ログのページ移動

• 印刷に適した形式でのログの表示

• ログの削除

イベントのキャプチャー、クエリー検索、表示

サイトでイベントが発生すると、そのイベントがログにキャプチャーされ、記録されます。 イベントに関連するメッセージを表示するには、ログをクエリー検索する必要があります。 サイトで現在のメッセージをクエリー検索して表示するには、次の手順に従います。

1. ArcGIS Server Manager を開き、管理者としてサイン インします。 この手順の詳細については、ArcGIS Server Manager へのログインをご参照ください。

2. ログ > ログの表示 の順にクリックし、現在のログを確認します。 一部のメッセージが、追加情報とともに返されます。

すべてのイベントでは、ログ レベル、イベントの発生時間、イベントをログに記録したソース コンポーネント、イベントが発生したコンピューター、ログ コード、イベントに関連するユーザーなどの情報が記録されます。 これらすべての情報は、ポータルのトラブルシューティングを効果的に行うために役立ちます。 これらの情報の詳細については、「ログについて」をご参照ください。

インストール時およびインストール後のログの動作

ArcGIS Server のインストールまたはアップグレード時、サーバーのログ レベルは 冗長 に設定されます。 これは、インストールまたはアップグレード プロセス中にメッセージが非常に詳細にログに記録されるという意味です。

このプロセス中に障害が発生し、トラブルシューティングのためにログを調べる必要がある場合は、まず、ArcGIS Server Manager にアクセスできるかどうか確認します。 アクセスできる場合は、ログをクエリー検索してメッセージを確認します。 アクセスできない場合は、ハードディスク上のログ メッセージを確認します。 ハードディスク上のログにアクセスするには、ログのディレクトリーを選択し、最新のログ ファイルを開きます (たとえば、<ArcGIS Server installation directory>/arcgisserver/logs/<machine name>/server/server-20150101.095803-8596-0.0.log)。 必要な場合は、この情報を Esri Support と共有できます。

このプロセス中に障害が発生し、トラブルシューティングのためにログを調べる必要がある場合は、まず、ArcGIS Server Manager にアクセスできるかどうか確認します。 アクセスできる場合は、ログをクエリー検索してメッセージを確認します。 アクセスできない場合は、ハードディスク上のログ メッセージを確認します。 ハードディスク上のログにアクセスするには、ログのディレクトリーを選択し、最新のログ ファイルを開きます (たとえば、C:\arcgisserver\logs\<machine name>\server\server-20150101.095803-8596-0.0.log)。 必要な場合は、この情報を Esri Support と共有できます。

インストールまたはアップグレード プロセスの完了後、サーバーのログ レベルはデフォルトで 警告 に設定されます。 これは、重要度が中～大の問題のみがログに記録されるという意味です。 サーバーのユーザーから問題が報告された場合は、その特定の問題についてより詳細なメッセージをキャプチャーするようログ レベルを変更する必要があります。 ログ レベルの変更方法については、ArcGIS Server Manager でのサーバー ログ設定の指定をご参照ください。

問題のトラブルシューティング

サーバーに問題が生じた可能性がある場合や、ユーザーから問題が報告された場合は、イベントを再現し、ログでイベントをキャプチャーし、ログをクエリー検索して、イベントに関する情報を入手する必要があります。 次に、ログの情報を使用して、イベントで発生した問題の解決に役立てます。

問題が生じた可能性がある場合や問題が報告された場合は、次の手順を実行し、ログによってイベントをキャプチャーします。

• 問題を再現してみます。

  • 問題を再現できる場合は、ログをクエリー検索してメッセージを確認し、問題に関する情報を取得します。

    • 情報が存在しない場合は、ログ レベルを上げます。 問題をもう一度再現し、ログをクエリー検索してメッセージを確認します。

    • ログ メッセージ内に情報が存在する場合は、その情報を調べて問題の解決に役立てます。

  • 問題を再現できない場合は、問題が再び起こった場合に備えて、その問題を引き起こした状況を記録しておきます。

ヒント:

ホスト サービスの公開に関連する問題の場合は、さらに Portal for ArcGIS のログを調べることをおすすめします。 このポータル ログには、公開に関する問題のトラブルシューティングに役立つ追加情報が示されていることがあります。

ログについて

すべてのイベントでは、ログ レベル、イベントの発生時間、イベントが発生したコンピューターなどの具体的情報が記録されます。 これらすべての情報は、サーバーのトラブルシューティングを効果的に行うために役立ちます。

デフォルトでは、レベル、時刻、メッセージ、ソース プロパティのみがログ メッセージ ウィンドウに表示されます。 表示にプロパティを追加、または表示からプロパティを削除する場合は、列 を選択します。

ヒント:

イベント ログ表示で列ヘッダーをドラッグ アンド ドロップして、列の順序を変更できます。 各列ヘッダーをクリックすると、昇順または降順で並べ替えられます。

レベル

ログに記録されるイベントは、迅速な対処を必要とする問題を示す 重大 から、サーバーの通常の使用を通じて生成される詳細な情報メッセージである 冗長 まで、その詳細のレベルが異なります。

注意:

ArcGIS Server で一度に保持できるログは 1,000 個までです。 ログの保持期間で選択した他の設定とは関係なく、最新の 1,000 個のログのみが保持されます。

ログ メッセージの頻度は、詳細レベルを上げるにつれて増加します。たとえば、SEVERE レベルに比べて FINE レベルでは、より多くのメッセージがログに記録されます。

トラブルシューティングの目的でログ レベルを上げる必要がある場合を除き、ログ レベルを SEVERE、WARNING、または INFO に維持することをおすすめします。

ログ レベルには次のタイプがあります。

ログ レベル	説明	メッセージの例
Severe	迅速な対処を必要とする重大な問題。 このレベルには、重大メッセージのみが含まれます。	リクエストを処理できません。 サービス Planning/counties/FeatureServer が見つかりません。
警告	対処を必要とするがそれほど深刻ではない問題。 このレベルには重大メッセージも含まれます。	ログインに失敗しました。 無効なユーザー名またはパスワードが指定されています。
情報	サービスの作成および開始に関するメッセージなど、サーバーの一般的な管理メッセージ。 このレベルには重大メッセージと警告メッセージも含まれます。	フォルダー Planning が正常に作成されました。
詳細	受信した操作リクエストの名前など、サーバーの使用による一般的なメッセージ。 このレベルには重大メッセージ、警告メッセージ、情報メッセージが含まれます。	/admin/arcgisserver/directories/arcgisjobs 内の有効期限切れのアイテムを確認しています。 C:\arcgisserver\directories\arcgisjobs 内の有効期限切れのアイテムを確認しています。
冗長	マップ サービス内の各レイヤーが正常に描画されたこと、レイヤーの描画速度、サーバーがレイヤーのソース データにアクセスするためにかかった時間など、サーバーが操作をどのように実行しているかを詳細に示すメッセージ。 このレベルには重大メッセージ、警告メッセージ、情報メッセージ、詳細メッセージが含まれます。	レイヤー描画の開始: 郡。
デバッグ	トラブルシューティング時にサーバーの状態を適切に確認したい開発者やサポート技術者向けに設計された、非常に詳細なメッセージ。 運用環境ではこのレベルを使用しないことをおすすめします。パフォーマンスの低下を招くおそれがあります。 問題のトラブルシューティングを行うのでなければ、代わりに 警告 レベルを使用してください。	サーバー ディレクトリーをクリーンアップしています。
オフ	ログをオフにします。 イベントはサーバーでログに記録されません。	N/A

時刻

ログに記録されたイベントが発生した時刻です。 イベントは時系列で整理され、一番最近のイベントが最初に表示されます。 時刻 列ヘッダーをクリックすると、メッセージが昇順または降順で並べ替えられます。

ログのクエリー検索時に表示する目的の時間間隔を指定できます。

ソース

ログに記録されるイベントのソースは、サービスまたはサーバーです。 サービスに関連付けられているイベントの場合は、名前とサービスの種類がソース プロパティとして表示されます。 サーバーに関連付けられているイベントの場合は、メッセージをログに記録したフレームワーク コンポーネントの名前がソース プロパティとして表示されます。

以下に例を示します。

• SampleWorldCities マップ サービスに関係のあるイベントは、SampleWorldCities.MapServer と表示されます。

• サイトでサーバー クラスターが正常に作成された後、メッセージをログに記録したコンポーネントとして Admin が表示されます。

必要に応じて、ログのクエリー検索時に表示する目的のソースを指定できます。

コンピューター

サイトに参加している各サーバー コンピューターは、そのコンピューターに固有のログ セットを維持しています。 また、ArcGIS Data Store をサイトに登録した場合、各 ArcGIS Data Store コンピューターは、そのコンピューターに固有のメッセージをログに記録します。

たとえば、サーバーは構成ストアの場所の更新に失敗したというエラーをログに記録することがあります。 特定のコンピューターに対して記録された統計に適用されるメッセージにのみ、コンピューター プロパティが含まれます。

ログのクエリー検索時に表示する目的のコンピューターを指定できます。

コード

メッセージに関連するログ コードです。 コードは、ログ コードの概要で説明されているように、いくつかの範囲に分かれています。

経過時間

ログに記録されたイベントが完了するまでにかかった時間 (ミリ秒) です。 たとえば、Web マップ画像のエクスポート イベントには、Web マップ画像のエクスポートにかかった時間を示す経過時間が含まれます。

ユーザー名

ログ メッセージを生じたリクエストを出したユーザーの名前です。 このプロパティは、セキュリティーが有効になっている場合に個々のユーザーの行動を追跡するときに役立ちます。

プロセス

イベントをログに記録したコンピューターのプロセス ID です。

スレッド

メッセージを生成したサーバー プロセス スレッドです。

リクエスト ID

ArcGIS Server に送信された各リクエストに付属している一意の ID 文字列です。この ID は、システムで該当するリクエストのライフサイクル全体を通して使用されます。

メソッド名

ログ メッセージを生成したサービスで呼び出されたメソッドです。

ログ フィルターを使用した検索結果の絞り込み

イベントを絞り込んで関連するメッセージを表示するには、ログ レベル、ログの保存期間 (時刻)、ソース コンポーネント、コンピューターに基づいてクエリー検索します。 これらのフィルターを任意の数だけ組み合わせてクエリーの一部にすることができます。 これらのフィルターには、ArcGIS Server Manager の ログの表示 ページでアクセスできます。

ログ フィルター

イベントは、迅速な対処を必要とする問題を示す 重大 から、サーバーの通常の使用を通じて生成される詳細な情報メッセージである 冗長 まで、その詳細のレベルが異なります。 ログ フィルター ドロップダウン リストから目的のレベルを選択します。 各レベルのサマリー詳細については、上記のレベル セクションをご参照ください。

保存期間

サーバーでログが記録されたイベントは時系列で整理され、最新のイベントが最初に表示されます。 特定の時間範囲までイベントをフィルターするには、保存期間 ドロップダウン リストから目的の増分値を指定します:

時間の増分値	説明
過去 15 分	過去 15 分以内に記録されたイベントを表示します
過去 1 時間	過去 1 時間以内に記録されたイベントを表示します
過去 6 時間	過去 6 時間以内に記録されたイベントを表示します
過去 24 時間	過去 1 日以内に記録されたイベントを表示します
過去 1 週間	過去 1 週間以内にログに記録されたイベント、またはサイトでディスク上にログを残すように指定した時間範囲内に記録されたイベントを表示します
起動以降	サーバーが最後に再起動してから記録されたイベント、またはサイトでディスク上にログを残すように指定した時間範囲内に記録されたイベントを表示します
すべて	ArcGIS Server をインストールしてから記録されたすべてのイベント、またはサイトでディスク上にログを残すように指定した時間範囲内に記録されたすべてのイベントを表示します。

時刻 列ヘッダーをクリックすると、メッセージが昇順または降順で並べ替えられます。

検索では、ArcGIS Server サイトでディスク上にログを残すように指定した時間範囲内に記録されたログだけが返されることに注意してください。 デフォルトは 90 日です。 たとえば、サイトをログを 5 日間保持するように構成した場合、保存期間 フィルターから 過去 1 週間 を選択しても、過去 5 日間のログのみが返されます。

ヒント:

サーバーがディスク上にログを保持する期間を指定するには、設定 をクリックします。 詳細については、サーバー ログ設定の指定をご参照ください。

ソース

ログに記録されるイベントのソースは、サービスまたはサーバーです。 サービスに関連付けられているイベントの場合は、名前とサービスの種類がソース プロパティとして表示されます。 サーバーに関連付けられているイベントの場合は、メッセージをログに記録したフレームワーク コンポーネントの名前がソース プロパティとして表示されます。

デフォルトでは、すべてのソースがクエリー検索の対象になります (ドロップダウン リストの すべて オプション)。 特定のサービスまたはサーバー フレームワーク コンポーネントをクエリー検索するには、ソース フィルターからサービスまたはコンポーネントの名前を選択します。 ログに記録されたイベントに表示されるソースの説明については、以下の表をご参照ください。

注意:

以下で説明している Admin、Server、Rest、Soap ソースは、ソース フィルターの サーバー フレームワーク レベルの下に表示されます。 これらのソースをクエリー検索するには、ソース ドロップダウン フィルターから サーバー フレームワーク を選択します。

ソース	説明
Admin	メッセージのログが管理 API によって記録されたことを示します。 管理 API とは、サーバーの管理を可能にするサーバー層です。サイトの作成、コンピューターとサービスの追加、クラスターの構成などが可能です。
Server	メッセージのログが、サービスのインスタンスを作成するサーバー フレームワークの部分によって記録されたことを示します。
Rest	メッセージのログが、サーバーの REST ハンドラーによって記録されたことを示します。 REST コンポーネントは、すべてのレベルでメッセージのログを記録します。
Soap	メッセージのログが、サーバーの SOAP ハンドラーによって記録されたことを示します。 SOAP コンポーネントは、すべてのレベルでメッセージのログを記録します。
ArcGIS Data Store	メッセージのログが ArcGIS Data Store によって記録されたことを示します。 メッセージは、ArcGIS Data Store を ArcGIS Server に登録した場合にのみ表示されます。
.FeatureServer	ソースはフィーチャ サービスです。
.GeocodeServer	ソースはジオコード サービスです。
.GeoDataServer	ソースはジオデータ サービスです。
.GeometryServer	ソースはジオメトリー サービスです。
Geometry.GeometryServer	ソースは ArcGIS Server でインストールされた事前設定済みのジオメトリー サービスです。
.GPServer	ソースはジオプロセシング サービスです。
CachingTools.GPServer	ソースは、ArcGIS Server でインストールされた事前設定済みのキャッシュ ツールで構成されています。
PrintingTools.GPServer	ソースは ArcGIS Server でインストールされた事前設定済みの PrintingTools サービスです。
PublishingTools.GPServer	ソースは、ArcGIS Server でインストールされた事前設定済みの公開ツールで構成されています。
.ImageServer	ソースはイメージ サービスです。
.KmlServer	ソースは KML サービスです。
.MapServer	ソースはマップ サービスです。
.NAServer	ソースはネットワーク解析サービスです。
.WCSServer	ソースは Web カバレッジ サービスです。
.WFSServer	ソースは Web フィーチャ サービスです。
.WMServer	ソースは Workflow Manager サービスです。
.WMSServer	ソースは Web マップ サービスです。
.WMTSServer	ソースは Web マップ タイル サービスです。
.WPSServer	ソースは Web Processing Service です。
.SceneServer	ソースはシーン サービスです。
.SchematicsServer	ソースはスケマティック サービスです。
.SearchServer	ソースはサーチ サービスです。
SampleWorldCities.MapServer	ソースは、ArcGIS Server でインストールされた事前設定済みの SampleWorldCities マップ サービスです。
Search.SearchServer	ソースは ArcGIS Server でインストールされた事前設定済みのサーチ サービスです。
Search_indexer.GPServer	ソースは、事前構成済みのサーチ サービスに付随する _indexer ジオプロセシング サービスです。
_indexer.GPServer	ソースは、サーチ サービスに付随する _indexer ジオプロセシング サービスです。

コンピューター

サイトに参加している各サーバー コンピューターは、そのコンピューターに固有のログ セットを維持しています。 また、ArcGIS Data Store をサイトに登録した場合、各 ArcGIS Data Store コンピューターは、そのコンピューターに固有のメッセージをログに記録します。

デフォルトでは、すべてのコンピューターがクエリー検索の対象になります (ドロップダウン リストの すべて オプション)。 特定のコンピューターのログに記録されたイベントをクエリー検索するには、コンピューター フィルターから目的のコンピューターを選択します。

サーバー ログのページ移動

ログの表示モジュールでクエリーを実行すると、ログ メッセージ ウィンドウに、クエリーに一致する最新のメッセージが 1,000 件表示されます。 これらのメッセージの時間範囲は、ログ メッセージ ウィンドウの下部に表示されます。

クエリーが 1,000 件を超えるメッセージを返した場合は、ログ メッセージ ウィンドウの下部にある 古い ボタンをクリックして、次のレコード セットにページ移動します。 同様に、新しい ボタンをクリックすると、時間が新しい方にページ移動します。

レコードをページ移動する際、ログ メッセージ ウィンドウは、クエリー実行後にログに新しく記録された可能性のある新しいメッセージを考慮して自動的には更新されません。 クエリーの最新の結果を取得するには、ログの表示 モジュールの クエリー をクリックします。

印刷に適した形式でのログの表示

クエリーを実行した後、印刷用の表示 リンクをクリックすると、印刷に適した形式でログを表示できます。 これにより、新しいブラウザー ウィンドウ (またはタブ) が開き、HTML でログが表示されます。 このビューを使用して、ログの印刷、HTML のディスクへの保存、またはドキュメントやスプレッドシートへのログのコピーおよび貼り付けを行うことができます。 この方法で、自分のログ メッセージを組織内の他のユーザーや、必要に応じて Esri Support と共有できます。

印刷用の表示には、最後に実行されたクエリー、ログ メッセージ ウィンドウの現在のビュー、指定したログ プロパティのみが表示されます。 ただし、イベント ログ表示で列を並べ替えていた場合、HTML ビューでは、クエリーが最初に実行されたときの元の状態に列が戻ります。 ログをスプレッドシートにコピーおよび貼り付けし、アプリケーション内のツールを使用して列を並べ替えることができます。

ログの削除

ログの削除 をクリックすると、サイトに参加している各サーバーからすべてのログ メッセージが削除されます。 ログの削除 をクリックすると、すべてのログを削除する決定を確認するよう求められます。

サーバーの問題の原因となっている特定のシナリオのデバッグを実行しているときは、ログを削除することで問題が明確になることがあります。 たとえば、マップ サービス内の特定のレイヤーの描画パフォーマンスを特定しようとしている場合、ログを削除し、マップに要求を送信してから、ログ メッセージ ウィンドウを更新して要求イベントを表示すると役立つ場合があります。 この方法により、その他のイベントのログがすべてクリアされ、そのマップ サービスのデバッグに集中できます。