システムログの操作

ArcGIS Enterprise on Kubernetes は、組織内で発生するイベントと、それらのイベントに関連するエラーをログに記録します。ログは ArcGIS Enterprise Manager から照会することも、サードパーティー製オブザーバービリティーソリューションを使用して取得することもできます。

ログを使用して、組織の問題を監視し、トラブルシューティングできます。ログの情報は、エラーを特定し、問題の対処方法を理解するのに役立ちます。また、ログは時間の経過に伴うイベントとパターンをまとめます。

Enterprise Manager の使用

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

ArcGIS Enterprise Manager に管理者としてサインインします。
サイドバーのログボタンをクリックして、現在のログを確認します。

一部のメッセージが、追加情報とともに返されます。

すべてのログは、イベントに関するいくつかの情報を記録します。以下を表示する列の表示および切り替えを行うことができます。

ログイベントの時刻と日付
イベントのログレベル
ログメッセージ
ログイベントのソース
ログイベントのリクエスト ID
イベントに関連付けられたユーザー名
イベントが発生したサービスタイプ
ログイベントが発生したノード
イベントに関連するログコード
イベントのスタックトレース

時間、ログレベル、ソース、リクエスト ID、ユーザー名、サービスタイプ、ログコードに基づいてログをフィルターすることもできます。

注意:

組織がログの取得に失敗した場合は、システムストレージの正常性状態を確認してください。時空間ストアおよびインデックスストアが異常な場合、組織はログにアクセスできなくなります。 Lens または別の Kubernetes IDE を使用して Kubernetes イベントを表示し、管理ポッドのログを確認し、必要に応じてポッドを再起動します。

ログ保持期間の更新

システムログのログ保持ポリシーを設定できます。デフォルトでは、システムログは 60 日間保持された後で削除されます。

保持期間の長さを更新するには、以下を実行します。

ログページで設定をクリックします。
ログ設定 ページで、ログ保持期間を更新します。
保存をクリックします。

ログメッセージの削除

ログメッセージを削除するには、以下を実行します。

ログページで、削除ボタンをクリックします。
ログメッセージの削除 ページで、次のオプションを使用できます。
- ログレベルを選択 - 削除する 1 つまたは複数のログレベルを選択します。
- 期間を選択 - ログメッセージを削除する期間を選択します。
- カスタム期間を選択 - オンの場合、ログメッセージを削除するカスタム期間を選択します。
削除をクリックします。

サードパーティーツールの使用

ArcGIS Enterprise によって保存されることに加え、システムログは stdout (標準出力) にもストリーミングされます。これにより、Datadog や Splunk といったサードパーティーのオブザーバービリティーソリューションを使用してログを扱うことが可能になります。各 stdout ログエントリーは、Newline-Delimited JSON を使用して、独立した構造化 JSON オブジェクトとして各行に出力されます。

以下のログエントリーの例は、"eventType":"arcgis-logs" があるアプリケーションログで使用されるスキーマを示しています。セキュリティー関連イベントの監査ログは、異なるスキーマを使用して、個別に stdout へストリーミングされます。

{"date":1777073486.102182,"msgTimestamp":"2026-04-24T23:31:25,968","logLevel":"DEBUG","source":"Workflow Manager","logCode":"46300","processID":"1","threadID":"1","className":"WorkflowManager","msg":"Creating ArcGIS Client request for https://arcgis-rest-portal-api.arcgis.svc.cluster.local:8443/arcgis/sharing/rest/generateToken ","stackTraces":"\n","input":{"type":"log"},"log":{"file":{"path":"/arcgisusr/logs/arcgis_logfile.log"}},"fields":{"serviceTypes":"","deploymentID":""},"pod":"arcgis-workflow-manager-gkruq-6cff58b755-pnpq9","eventType":"arcgis-logs"}

注意:

date フィールドではイベントが stdout に出力された時点のタイムスタンプを記録し、msgTimestamp フィールドでは元のログイベントの時刻を記録します。

ターゲットポッド内の fluent-bit コンテナーからログを取得する kubectl logs コマンドを使用することで、stdout ログにアクセスできます。詳細は、kubectl ログに関する Kubernetes のドキュメントをご参照ください。

ログを使用したトラブルシューティング

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

問題が生じた可能性がある場合や問題が報告された場合は、問題を再現してみてください。問題を再現できる場合は、関連するログをクエリー検索してメッセージを確認し、役立つ可能性がある情報を取得します。たとえば、ユーザーが Web サービスのパフォーマンス上の問題を報告した場合、その動作を再現しログを監視して、何が起きているのかを確認します。原因を示すエラーメッセージが見つかることがあります。

情報が存在しない場合は、ログレベルを上げます。これにより、取得されるログの範囲が広がり、有益な情報が得られる場合があります。

ログレベル

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

ログレベルを次の表に示します。


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

ログレベルの更新

ArcGIS Enterprise Manager でシステムログを操作するとき、イベントをキャプチャーして確認するためにログレベルを上げる必要がある場合があります。

記録されるログの範囲を拡張できます。サービスの作成および開始に関連するログを調べる場合に、ログレベルをデフォルトの警告から情報に変更できます。

ArcGIS Enterprise Manager でログレベルを更新するには、以下を実行します。

ログページで設定をクリックします。
ログ設定 ページで、必要なデフォルトのログレベルを設定します。
保存をクリックします。

ログインデックスの更新

新しいログが生成されない場合や既存のログが利用できなくなった場合など、ログへのアクセスに関連する問題をトラブルシューティングするには、ログインデックスを更新します。

ArcGIS Enterprise Manager でログインデックスを更新するには、以下を実行します。

ログページで設定をクリックします。
ログ設定 ページで ログインデックスを更新 をクリックします。

システム ログの操作

Enterprise Manager の使用

注意:

ログ保持期間の更新

ログ メッセージの削除

サードパーティー ツールの使用

注意: