ArcGIS Notebook Server は、サイト内で発生するイベントと、それらのイベントに関連するエラーをログに記録します。これらのログは、サイト管理者によって使用されます。
ログは、ArcGIS Notebook Server サイトの問題を監視してトラブルシューティングするための重要なツールです。ログが提供する情報は、エラーを特定し、問題の対処方法とエラーの解決方法を理解するのに役立ちます。ログは、サイト内で発生するイベントの記録システムとしての役割も果たします。
たとえば、次のタイプのイベントがログに記録されます。
- ソフトウェア認証やサイト作成などの、インストールおよびアップグレード イベント
- ArcGIS Notebook の開始と終了
- サイトによって実行されたクリーンアップ タスク
- ノートブック ランタイムの追加や削除、サーバー ディレクトリの作成、セキュリティ設定の構成など、管理者が実施するサイト管理イベント
- サイトにログインするユーザー、SSL 証明書のインポートとエクスポートなどのセキュリティ イベント
一部のイベントは、ArcGIS Notebook Server ログに記録されません。これには、ポータルへのサイトのフェデレーションとフェデレーション解除も含まれます。ArcGIS Notebook 内で行われるイベント (コンテンツの追加、セルの実行など) は記録されません。また、コンピューターの Docker コンテナー内で行われるイベントも記録されません。コンテナー固有のログを表示するには、以下の「Docker コンテナー ログの表示」をご参照ください。
使用可能なログ レベル
各ログの詳細は、その度合いが低い方から高い方に、次のレベルに分かれています。
- [重大]: 迅速な対処を必要とする重大な問題。
- [警告]: 対処を必要とするが、それほど深刻ではない問題。
- [情報]: サービスの作成および開始に関するメッセージなど、Notebook Server サイトの一般的な管理メッセージ。
- [詳細]: 受信した操作リクエストの名前など、サーバーの使用による一般的なメッセージ。
- [冗長]: サーバーで操作がどのように実行されるかについての詳細を提供するメッセージ。
- [デバッグ]: トラブルシューティング時にサーバーの状態を適切に確認したい開発者やサポート技術者向けに設計された、非常に詳細なメッセージ。膨大な量のログが作成されるため、本番システムでの使用は推奨されていません。
ArcGIS Notebook Server Administrator Directory では、作成される最も詳細なログ レベルを指定することができます。たとえば、レベルを [詳細] に設定した場合、サーバー サイトでは [重大]、[警告]、[情報]、[詳細] レベルのメッセージを記録します。
サーバー ログへのアクセスとクエリ
サーバー ログをクエリ、表示、構成、削除するには、ArcGIS Notebook Server Administrator Directory を使用します。
ログにアクセスするには、以下の手順に従います。
- Administrator Directory にログインします。URL の形式は、https://notebookserver.domain.com:11443/arcgis/admin または https://notebookserver.domain.com/<webadaptorname>/admin です。
- [Logs] > [Query] の順にクリックし、現在のログをクエリし、確認します。ページのフィルター コントロールを使用すると、期間やログ レベルなどのカテゴリ別にイベントを絞り込むことができます。
- [Logs] > [Settings] をクリックすると、デフォルトのロギング レベル (前述)、ディスク上にログが保持される期間、ログが書き込まれる場所など、ログの設定を管理できます。
- [Clean Logs] をクリックすると、ArcGIS Notebook Server サイトからすべてのログ ファイルが削除されます。
Docker コンテナー ログの表示
Docker コマンド ライン インターフェイスを次のように使用すると、サイトの Docker コンテナーに固有のログを表示することができます。
- Administrator Directory にログインします。URL の形式は、https://notebookserver.domain.com:11443/arcgis/admin または https://notebookserver.domain.com/<webadaptorname>/admin です。
- [System] > [Containers] の順に移動します。ログを表示するコンテナーを探し、その ID をクリックします。
- コンテナーの URL に ?f=pjson を追加して URL の形式を https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson に変更し、コンテナーの情報ページの JSON ビューを開きます。
- コンテナーの containerId を探し、値を記録します。
- Docker 権限を持つユーザーとしてターミナルを開きます。
- 記録した値を使用し、docker logs <containerId> コマンドを実行します。これにより、そのコンテナーに固有の Docker ログが返されます。