メイン コンテンツにスキップ

イベント ID

概要

各サービスは、そのサービス内で特定のイベントが発生すると、複数のログステートメントを出力します。これらのイベントがログに記録される際には、そのログの理解や追跡に役立つ関連する書き込みデータ量や値が含まれますが、ログステートメントの一部としてイベント ID も含まれます。このイベント ID により、一連のログステートメントを見つけたり、クエリを使用して、サービス内でどのようなイベントが発生したかをより深く理解したりできます。

Elk stack、Splunk、Datadog などのログ集約および監視ツールを使用して、Glasswall Halo のログを収集し、一元化できます。これらのツールは強力な検索機能と可視化機能を提供し、イベント ID、タイムスタンプ、その他の属性に基づいてログをクエリできます。

ログレベル

ログレベルは、ログエントリの重大度または重要度を示します。これにより、ログメッセージの優先順位付けやフィルタリングに役立ちます。ログレベルを効果的に理解して活用する方法は次のとおりです。

ログレベルの階層

ログレベルは通常、各レベルが重大度の増加を示す階層に従います。一般的なログレベルには次のものがあります。

  • Information: アプリケーションの動作に関する一般的な情報を提供します。
  • Warning: 重大ではない可能性のある潜在的な問題や予期しない動作を強調します。
  • Error: 直ちに対応が必要なエラーを示します。
  • Critical: アプリケーションの障害につながる可能性がある、最も深刻な問題のために予約されています。

コンシューマーのアクション

ログデータを利用する際は、ログレベルに基づいて特定のアクションを実行できます。

  • Info: これらのログは、アプリケーションの通常動作を監視するうえで有用です。運用チームは、システムが円滑に稼働していることを確認するためにこれらを使用できます。
  • Warning: 潜在的な問題や異常が示されます。運用チームは、これらに先回りして対処できるようアラートを設定できます。
  • Error: 直ちに注意が必要です。サービスの中断を防ぐため、運用チームは速やかにエラーを調査し、対処する必要があります。
  • Critical: 即時対応を要する重大な問題を示します。運用チームに通知し、インシデント対応プロセスを開始する必要があります。

Glasswall Halo によって出力されるイベントは次のとおりです。

グローバルイベントID

イベントID説明ログレベル
MongoDB-healthcheckfailed100100MongoDB データベースのヘルスチェックが失敗した場合Error
MongoDB-documentsretrieved100101MongoDB データベースへのクエリが正常にドキュメントを返した場合Information
MongoDB-documentinserted100102ドキュメントが MongoDB データベースに正常に挿入されたときInformation
MongoDB-documentsdeleted100103ドキュメントが MongoDB データベースから正常に削除されたときInformation
MongoDB-sumofcalculated100104MongoDB データベースに対して sumof クエリが正常に実行されたときInformation
MongoDB-documentsupdated100105ドキュメントが MongoDB データベースで正常に更新されたときInformation
MongoDB-documentsmatched100106MongoDB データベースに対して exists クエリが正常に実行されたときInformation
CosmosDB-healthcheckfailed100150cosmos データベースのヘルスチェックが失敗したときError
CosmosDB-itemsretrieved100151cosmos データベースへのクエリが正常にアイテムを返したときInformation
CosmosDB-iteminserted100152アイテムが cosmos データベースに正常に挿入されたときInformation
CosmosDB-itemsdeleted100153cosmos database から項目が正常に削除されたときInformation
CosmosDB-sumofcalculated100154cosmos database に対して sumof クエリが正常に実行されたときInformation
CosmosDB-itemsupdated100155cosmos database 内の項目が正常に更新されたときInformation
CosmosDB-itemsmatched100156cosmos database に対して exists クエリが正常に実行されたときInformation

Sync API

イベントID説明ログレベル
Receivedauthresponse5API が Engine service からの応答を受信したときInformation
Suscribedtoqueue6API が応答キューをサブスクライブしたときInformation
Createdqueue7API が正しい応答キューを作成したときInformation
Sentmessage8API が rabbit mq にメッセージを正常に送信したときInformation
Filewritten9API がファイル ストレージへのファイルの書き込みに成功した場合Information
Fileread10API がストレージから再構築されたファイルまたは分析の読み取りに成功した場合Information
Messagepollerstarted11レート制限ポーリングが開始された場合Information
Incorrectresponsemessage12API が Engine サービスから応答を受信したものの、その応答をユーザーに返すのを待機しているタスクが存在しない場合警告
Operationfailed13API 内の操作が失敗した場合警告
Retryingpolicy14定義された retry policy に基づいて操作が再試行される場合警告
Failedrebuildarchiveentry15API がアーカイブ応答のクリーン ファイル セクションの再構築に失敗した場合警告
Failedanalysisarchiveentry16API がアーカイブ応答の分析セクションの再構築に失敗した場合警告
レート制限済み17レート制限の上限に達したため、リクエストが許可されない場合警告
RPC 応答処理エラー18API が Engine からの応答メッセージの処理に失敗した場合Error
トランザクションイベントの送信失敗19API がダッシュボードで使用されるトランザクションイベントの送信に失敗した場合Error
リクエスト失敗20既知の理由により API へのリクエストが失敗した場合Error
不明なリクエスト失敗21不明な理由により API へのリクエストが失敗した場合Error
パイプライン開始22API 内のアクションが開始された場合Information
パイプライン完了23API 内のアクションが完了した場合Information
開始エラー24API の起動に失敗した場合Information
Storagenotfound25API がマウントされたストレージの場所を見つけられない場合Information

Engine

イベントID説明ログレベル
Metricsoutput2Engine service がメトリクスを stdout に記録する場合Information
Subscribedtoqueue3Engine service がリクエストキューを購読した場合Information
Createdqueue4Engine service がリクエストキューとロギングキューを作成した場合Information
Sentmessage5Engine service がレスポンスキューまたはレポートキューにメッセージを送信した場合Information
Completedmessage6Engine service が API からのリクエストメッセージを完了した場合Information
Rejectedmessage7Engine service が API からのリクエストメッセージを拒否する場合Rejectedmessage
Getstream8Engine service がマウントされたディスクに保存されたファイルのストリームを取得する場合Information
Writtenfile9Engine service が再構築されたファイルをマウントされたストレージに書き込んだときInformation
サービス停止中10Engine service の実行が停止したときInformation
シャットダウン中にメッセージを受信11Engine service がシャットダウン処理中にメッセージを受信したときInformation
メッセージを処理中12Engine service がリクエストの処理を開始したときInformation
分析書き込み失敗14Engine service が分析レポートのマウントされたストレージへの書き込みに失敗したとき警告
クリーンファイル書き込み失敗15Engine service がクリーンファイルのマウントされたストレージへの書き込みに失敗したとき警告
Retryingpolicy16Engine service が定義された retry policy に基づいて操作を再試行するとき警告
Engine バージョン取得失敗17Engine service が embedded Engine からバージョンを取得できなかったとき警告
RabbitMQ ヘルスチェック失敗18RabbitMQ のヘルスチェックが失敗したとき警告
エラー処理メッセージ20Engine service がリクエストメッセージの処理に失敗した場合Error
メッセージエラー21Engine service がリクエストキューからのメッセージの処理で問題を起こした場合Error
サービス切断22Engine service が切断された場合重大
Storagenotfound23Engine service がマウントされたストレージを見つけられない場合Information
開始エラー24Engine service の起動に失敗した場合Information
トラッカーアクション完了25Engine service がサービス内のイベントの追跡を完了した場合警告
サービス起動中26Engine service が起動する場合Information
ストレージヘルス障害27ストレージのヘルスチェックに失敗した場合警告
エクスポートファイル書き込み失敗28Engine サービスがエクスポート ファイルをマウントされたストレージに書き込めない場合警告
パスファイルタイプを検出中2001detectfiletypefromfile が呼び出された場合Information
メモリファイルタイプを検出中2002detectfiletypefrommemory が呼び出された場合Information
セッション作成時にライセンスが設定されていません2003有効なライセンスが見つからなかった場合。この場合、CDR は実行されません重大
Engine ライセンス エラー2004有効なライセンスが見つかりましたが、無効であるか期限切れです重大

レポート抽出

イベントID説明ログレベル
メッセージ ブローカーに接続できません1サービスが起動時にメッセージ ブローカーに接続できない場合重大
メッセージ ブローカー キューに接続できません2サービスが起動時にレスポンス キューに接続できない場合重大
予期しないメッセージ ブローカー例外3API が起動時にメッセージ ブローカーまたはキューへの接続で予期しないエラーを起こした場合重大
ストレージヘルス障害4ストレージのヘルスチェックに失敗した場合Error
分析レポートの読み取り5レポート抽出機能がマウントされたドライブから分析レポートを読み取ったときInformation
分析レポートの読み取り失敗6レポート抽出機能がマウントされたドライブから分析レポートを読み取れなかったときError

API アクセス

イベントID説明ログレベル
匿名認証1リクエストが匿名認証によって許可されたときInformation
認証ヘッダー不足2リクエストに必要な認証ヘッダーがないときInformation
有効な組織3正しい認証組織 ID を使用してリクエストが行われたときInformation
無効な認証ヘッダー4無効な認証ヘッダーでリクエストが行われたときInformation
サービスの起動失敗5サービスの起動に失敗したとき重大
アップストリーム応答6アップストリームサービスがレスポンスを返したときInformation
Upstreamrequest7アップストリームサービスへのリクエストが行われたときInformation
Requesterror8リクエストでエラーが発生したときError

ポータルアクセス

イベントID説明ログレベル
アップストリーム応答1アップストリームサービスがレスポンスを返したときInformation
Upstreamrequest2アップストリームサービスへのリクエストが行われたときInformation
開始エラー3サービスの起動に失敗したとき重大
Requesterror4リクエストでエラーが発生したときError

Async API

イベントID説明ログレベル
サービス起動中1API が起動したときInformation
サービス停止中2async API のシャットダウン処理が呼び出されたときInformation
シャットダウン中にメッセージを受信3API がシャットダウン処理中にメッセージを受信したとき警告
メッセージを処理中4API がキューからのメッセージを処理しているときInformation
Handledmessage5API がキューからのメッセージを正常に処理したときInformation
メッセージエラー6API がキューからのメッセージの処理で問題を検出したときError
サービス切断7API がメッセージブローカーから切断されたとき重大
Subscribedtoqueue8API がキューからメッセージを受信するためにサブスクライブしたときInformation
Sentmessage9API が処理のためにメッセージを送信したときInformation
Filewritten10API がファイル ストレージへのファイルの書き込みに成功した場合Information
Fileread11API がストレージから再構築されたファイルまたは分析の読み取りに成功した場合Information
Incorrectstatusstored12保存された項目のステータスが想定されたステータスではない場合警告
Operationfailed13API 内の操作が失敗した場合重大
Retryingpolicy14定義された retry policy に基づいて操作が再試行される場合警告
リクエスト失敗16既知の理由により API へのリクエストが失敗した場合Error
不明なリクエスト失敗17不明な理由により API へのリクエストが失敗した場合Error
パイプライン開始18API 内のアクションが開始された場合Information
パイプライン完了19API 内のアクションが完了した場合Information
開始エラー20API の起動に失敗した場合Information
Storagenotfound21API がマウントされたストレージの場所を見つけられない場合Information
Hashingerror22API がファイルのハッシュを生成できない場合Error
Deletefailed23API がマウントされたストレージの場所からファイルを削除できない場合Error
メッセージ ブローカーに接続できません24API が起動時にメッセージブローカーに接続できない場合重大
メッセージ ブローカー キューに接続できません25API が起動時にレスポンスキューに接続できない場合重大
予期しないメッセージ ブローカー例外26API が起動時にメッセージ ブローカーまたはキューへの接続で予期しないエラーを起こした場合重大
Databasehealthfailure27API のデータベースヘルスチェックがデータベースへの接続に失敗した場合警告
Messagebrokerhealthfailure28API のメッセージブローカーヘルスチェックがメッセージブローカーへの接続に失敗した場合警告
Databasefailure29API が最大再試行回数後もデータベース上の操作を完了できない場合Error
Databaseitemretrieved30API がデータベース内の項目を取得したときInformation
Databaseitemstored31API がデータベースに項目を保存したときInformation
Databaseitemupdated32API がデータベース内の項目を更新したときInformation
Handlesinglefileresponse33API が単一ファイルに関連するレスポンスを受信したとき警告
Handlearchivecontentresponse34API がアーカイブコンテンツ項目に関連するレスポンスを受信したとき警告

集計アキュムレータ

イベントID説明ログレベル
メッセージ ブローカーに接続できません1API が起動時にメッセージブローカーに接続できない場合重大
メッセージ ブローカー キューに接続できません2API が起動時にレスポンスキューに接続できない場合重大
予期しないメッセージ ブローカー例外3API が起動時にメッセージ ブローカーまたはキューへの接続で予期しないエラーを起こした場合重大
開始エラー4API の起動に失敗した場合重大
Processtransactioneventstart5サポートされているトランザクションを受信し、処理が開始されたときInformation
Processtransactioneventend6サポートされているトランザクションを受信し、処理が正常に完了したときInformation
Licensetransactionstoreupsertstart7ライセンス トランザクション ストアに対して upsert が実行されようとしているときInformation
Licensetransactionstoreupsertsuccess8ライセンストランザクションストアに対するupsertが正常に完了したときInformation
Tallystoreupsertstart9tallyストアに対するupsertが実行される直前Information
Tallystoreupsertcomplete10tallyストアに対するupsertが成功したときInformation
Tallystoregetusagestart11tallyストアからライセンス使用状況を取得しようとしているときInformation
Tallystoregetusagesuccess12tallyストアからライセンス使用状況が正常に取得されたときInformation
Unexpectednegativefilesize13ファイルのライセンス取引イベントでファイルサイズが負の値になっているとき警告
Unexpectedrequestexception14特定のAPIリクエストに対して500ステータスコードの原因となる、予期しない例外がサービスによって発生したときError
Unsupportedentitlementlimitname15usage endpoint に指定されたフィルターが有効な entitlement limit ではないとき警告
Databasehealthfailure16サービスのヘルスチェックがデータベースインスタンスへの接続に失敗した場合警告
Erroredfilereceived17上流でエラーが発生した場合。これにより集計値は増加しません警告

メトリクス照合(非推奨)

Halo バージョン 2.6.2 以降では、メトリクス照合サービスは不要になりました。

イベントID説明ログレベル
メッセージ ブローカーに接続できません1サービスが起動時にメッセージ ブローカーに接続できない場合重大
メッセージ ブローカー キューに接続できません2サービスが起動時にレスポンス キューに接続できない場合重大
予期しないメッセージ ブローカー例外3サービスの起動時に、メッセージブローカーまたはキューへの接続で予期しないエラーが発生した場合重大
ストレージヘルス障害4ストレージのヘルスチェックが失敗した場合。通常はデータベース接続の問題ですError
Writingeventtomongostorage5受信イベントがデータベースに永続化されようとしている場合Information
Mongowriteerror7受信イベントをデータベースに永続化できなかった場合Error
Jsonexceptionerror8メッセージリスナーがイベントのデシリアライズに失敗した場合Error
Unknownfailedtoprocess10受信イベントの処理中に未処理の例外が発生した場合重大
Failedtoimporttracedata11トレースプロバイダーが受信イベントヘッダーからトレースデータをインポートできない場合警告
Storagehealthcheckstartup12サービスが起動時にストレージのヘルスチェックを実行する場合Information

メトリクス投影

イベントID説明ログレベル
開始エラー1サービスの起動に失敗した場合重大
ストレージヘルス障害2ストレージのヘルスチェックが失敗した場合。通常はデータベース接続の問題です警告
Changeprocessorstart5変更プロセッサーがデータベース変更を監視するウォッチャーを設定しようとしている場合Information
Changeprocessorstarted6変更プロセッサーがデータベース変更を監視するウォッチャーの設定に成功した場合Information
Changeprocessorstopping7変更プロセッサーがデータベース変更の監視を停止しようとしている場合Information
Changeprocessorstopped8変更プロセッサーがデータベース変更の監視停止に成功した場合Information
Changeprocessorstopfailure9変更プロセッサーがデータベース変更の監視停止に失敗した場合、つまり変更を監視していなかった場合警告
Changeprocessorbatchstart10変更プロセッサがデータベース変更のバッチを受信し、それらの処理を開始しようとしているときInformation
Changeprocessorbatchend11変更プロセッサが現在のデータベース変更バッチの処理を完了したときInformation
Changeprocessorunhandledexception13変更プロセッサが変更の処理中に問題に遭遇したとき。これによりデータの不整合が発生する可能性がありますError
Transactioneventprojected14イベント(変更)がprojectionに正常にマッピングされたときデバッグ
Changehandlerstarted15変更ハンドラーが、変更プロセッサによって呼び出された後に変更の処理を開始しようとしているときInformation
Changehandlerfinished16変更ハンドラーが変更の処理を完了したときInformation
Changehandlerfailure17変更ハンドラーが変更の処理に失敗したとき重大
Changeprocessorstartfailure19変更プロセッサがデータベース変更の監視の開始に失敗したときError
Changeprocessorwatchstart20変更プロセッサーが、データベースの変更をアクティブに監視し始めたとき(ウォッチャーの設定後)Information
Daywisesummaryincremented21完了したファイルに基づいて日次サマリーが正常に増分更新されたときInformation
Daywisesummarynotincremented22(通常は未完了の)ファイルに基づいて日次サマリーが増分更新されないときデバッグ
Retryingpolicy23定義された retry policy に基づいて操作が再試行される場合警告
Materializedviewpersisted24マテリアライズドビュー(プロジェクション)が投影後にデータベースへ永続化されたときInformation

ライセンス管理

イベントID説明ログレベル
開始エラー1サービスの起動に失敗した場合重大
Licenseprocessingerror2予期しない理由でリクエストが失敗したときError
Deletelicensestart3サービスが現在アクティブなライセンスの削除を開始したときInformation
Deletelicenseend4サービスが現在アクティブなライセンスの削除を完了したときInformation
Updatelicensestart5サービスが現在のアクティブなライセンスの更新を開始したときInformation
Updatelicenseend6サービスが現在のアクティブなライセンスの更新を完了したときInformation
Getlicensestart7サービスが現在のアクティブなライセンスの取得を開始したときInformation
Getlicenseend8サービスが現在のアクティブなライセンスの取得を完了したときInformation
Licensenotfound9更新または取得中に現在のアクティブなライセンスが見つからないときError
Licenseexpired10アップロードされたライセンスの有効期限が切れており、更新が失敗したときError
Fetchinglicenseusagestart11サービスが現在のアクティブなライセンスと使用状況データの取得を開始したときInformation
Fetchinglicenseusageend12サービスが現在のアクティブなライセンスと使用状況データの取得を完了したときInformation

ICAP サーバー

イベントID説明ログレベル
Backgroundservicestarting1ICAP リスナーが起動中のときInformation
Backgroundservicestarted2ICAP リスナーが起動したときInformation
Backgroundservicestopping3サービスがシャットダウンし、ICAP リスナーが停止中のときInformation
Backgroundservicestopped4サービスがシャットダウンし、ICAP リスナーの停止が完了したときInformation
開始エラー5サービスの起動に失敗したとき重大
Halocallfailure8Halo API 経由でファイルを構築できないとき警告
Profilestoremaintainerstarting9バックグラウンド スレッドが、ローカルに永続化するための ICAP profile の変更の監視を開始するときInformation
Profilestoremaintainerstarted10ICAP profile の変更を監視するバックグラウンド スレッドが正常に開始したときInformation
Profilestoremaintainerstopping11サービスがシャットダウンし、profile バックグラウンド スレッドが profile 更新の監視を停止するときInformation
Profilestoremaintainerstopped12サービスがシャットダウンし、profile バックグラウンドスレッドがシャットダウン処理を完了したときInformation
Profilestoremaintainerheartbeaterror13profiles が照会された際に、エラーのため永続化できないときError
Profilestoremaintainerheartbeatsuccess14profiles が正常に照会されたときInformation
Profileusagefailure15ICAP リクエストで指定された profile が見つからないとき警告
Errorhandled17ICAP サーバーが、ICAP クライアントにエラーレスポンスを送信することで予期しない例外の処理を完了したときError
Unlicensedrequest18ライセンスのない ICAP サーバーに対する ICAP リクエストを受信したとき重大
Retryingpolicy19アクションが再試行されているとき。たとえば、Halo API への呼び出しが失敗した場合など警告
Fileblocked20ブロックされたファイルを含む ICAP リクエストが処理されるときInformation
Fileprocessingstarted21ICAP リクエスト内のファイルの処理を開始するときInformation
Profilefailedtofetch22policy API から profile を取得できないときError
Rebuiltfileexceedscachesize23ICAP リクエストに、キャッシュに保存するには大きすぎるファイルが含まれているとき警告
Fileretrievedfromcache24ICAP リクエストが処理され、関連する再構築済みファイルがキャッシュ内で見つかったときInformation
Fileprocessingfinished25ICAP リクエスト内のファイルの処理が完了したときInformation
Clearingcache26キャッシュのクリーンアップの実行が開始されるときInformation
Cachecleared27キャッシュのクリーンアップの実行が完了するときInformation
Errorclearingcache28キャッシュのクリーンアップの実行中にエラーが発生したときError
Filebypassed29使用中のICAP policyによる変更中にファイルがバイパスされた場合Information
Fileprocessed30使用中のICAP policyによる変更中にファイルが処理された場合Information
Fileerrored31変更中のファイル処理を試行している際にエラーが発生した場合Information
Tlsdisabled32有効な証明書がICAPサーバーに提供されていない場合、サーバーはセキュアポート11344での待ち受けを停止し、tlsが無効になります。警告
Tlsenabled33ICAPサーバーが有効なtls証明書を検出し、セキュアポート11344で待ち受けています。Information
Serverstarting1000ICAPサーバーの起動時Information
Serverstarted1001ICAPサーバーが起動した場合Information
Clientsocketerror1002ICAPクライアントの待ち受け中に予期しない例外が発生した場合Error
Unsupportedicaprequest1003ICAP server がサポートされていないリクエストを受信した場合。たとえば、メソッドが reqmod、options、または respmod ではない場合警告
Clientconnectionhandleerror1004server に送信されたデータの処理中にエラーが発生した場合Error
Sendfailure1005ICAP client へのレスポンス送信の試行に失敗した場合警告
Serverlistenercancelled1006ICAP listener thread がキャンセルされた場合。たとえば、シャットダウン時警告
Errorduringsocketclose1007接続を閉じる際にエラーが発生した場合。たとえば、client がすでに切断されている場合Information
Clientreceiveerror1008ICAP client から socket に送信されたデータを待機中にエラーが発生した場合警告
Requestprocesserror1009ICAP リクエストの処理中に未処理の例外が発生した場合Error