Oracle Cloud Infrastructureドキュメント

ログ処理パイプラインのトラブルシューティング

ログ・データがログ・アナリティクスに収集された後、データ処理が非同期に開始されます。データ処理中に、ログ・データの解析または解釈に関するエラーが発生した場合は、ログ・エクスプローラにログ・データとともにエラー・メッセージが表示されます。

エラーを検出し、エラーのタイプを識別してログ処理パイプラインのトラブルシューティングを行うには、「処理エラー」メトリックを使用します。「処理エラー」メトリックにアクセスするステップは、サービス・メトリックを使用したログ・アナリティクスのモニターを参照してください。

エラーが検出されると、「処理エラー」メトリックに、テナンシまたはコンパートメントで有効になっている収集タイプごとに1行が表示されます。チャートのデータ・ポイントの上にカーソルを置くと、エラーの詳細が表示されます。エラー・タイプ別にメトリックを表示するには、次のステップに従います。

  1. 「処理エラー」メトリックの右上隅にある「オプション」メニューをクリックし、「メトリック・エクスプローラで表示」を選択します。

    これで、メトリックがメトリック・エクスプローラに表示されます。ここで、チャートをより詳細に表示できます。

  2. 「問合せの編集」をクリックし、errorTypeとして「ディメンション名」を選択し、ログ・エクスプローラで確認したエラー・タイプ(LogParserMismatchなど)として「ディメンション値」を選択します。

    「チャートの更新」をクリックして、クラスタ・ビジュアライゼーションをリフレッシュします。これで、チャートにerrorTypeのメトリックが表示されます。

    収集されたエラー・データ・ポイントが表形式で表示される「データ表」ビューに切り替えることができます。

次に、このメトリックを介してレポートされる様々なタイプのエラーを示します:

エラー・タイプ 説明 推奨される修正

LogParserMismatch

ソースに定義されているパーサーがログ・レコードと一致しません。たとえば、

  • 正規表現がログ・データと一致しません。
  • XPath式がログ・レコードjsonまたはXMLに存在しません。

データを解析するために、一致するパーサーが少なくとも1つ存在することを確認します。

LogFieldParserMismatch

ソースに定義されているパーサーがログ・レコードのフィールドと一致しません。たとえば、正規表現がログ・データのフィールドと一致しないか、ログ・レコードjsonまたはXMLのフィールドにXPath式が存在しません。

  • 正規表現がログ・データのフィールドと一致しません。
  • XPath式がログ・レコードjsonまたはXMLのフィールドに存在しません。

フィールド内のデータを解析するために、一致するフィールド・パーサーが少なくとも1つ存在することを確認します。

LogParsingTookTooLong

正規表現の実行に3秒以上かかったため、ソースで定義されたパーサーの1つがタイムアウトしました。正規表現が複雑であるか、正規表現に対してログ・レコードが長すぎます。

データ・バンドルに対して3回(バンドルは一部のログ・レコードのzipファイル)発生した場合、バンドル内の残りのログ・レコードは解析されず、exceeded max base parser regex timeout: 3というメッセージとともに、この解析エラー・タイプでフラグが付けられます。

解析がタイムアウトしないように、ソースのパーサーでより高速な正規表現を使用します。パフォーマンスに優れた正規表現の記述を参照してください。

LogFieldParsingTookTooLong

正規表現の実行に3秒以上かかったため、フィールドに定義されたパーサーがタイムアウトしました。正規表現が複雑であるか、正規表現に対してログ・レコードが長すぎます。

データ・バンドルに対して3回(バンドルは一部のログ・レコードのzipファイル)発生した場合、バンドルの残りのログ・レコードは解析されず、「解析エラー: 最大フィールド・パーサー正規表現タイムアウトを超えました: 3、パーサー: ベースパーサー、level1fieldparser、level2fieldparser」というメッセージとともに、この解析エラー・タイプでフラグが付けられます。

解析がタイムアウトしないように、ソースのフィールド・パーサーでより高速な正規表現を使用します。パフォーマンスに優れた正規表現の記述を参照してください。

LogParsingInvalidStructure

収集に対して識別されたデータとパーサー定義が一致していません。

たとえば、

  • エントリ開始式で、指定されたJSONまたはXMLファイルに一致がないため、ログ・エントリが収集されません
  • ソースに正規表現パーサー・タイプが含まれるが、JSONファイルを収集に使用可能な場合

データ・バンドルでこれが発生した場合、バンドル内の残りのログ・レコードは解析されず、解析失敗: ベース・パーサーの無効な構造化エントリの最大数を超えました: 3というメッセージとともに、この解析エラー・タイプでフラグが付けられます。

パーサー定義を検証し、受信データが指定された定義に準拠していることを確認します。パーサーの作成

LogFieldParsingInvalidStructure

収集に対して識別されたデータとフィールド・パーサー定義が一致していません。

たとえば、

  • エントリ開始式で、指定されたJSONまたはXMLファイルに一致がないため、ログ・エントリが収集されません
  • ソースに正規表現パーサー・タイプが含まれるが、JSONファイルを収集に使用可能な場合

データ・バンドルに対して3回発生した場合、バンドルの残りのログ・レコードは解析されず、次の解析エラー・タイプでフラグが設定されます: 解析失敗: フィールド・パーサーの無効な構造化エントリの最大数を超えました: 3、パーサー: baseparser、fieldparser。

フィールド・パーサー定義を検証し、受信データが指定された定義に準拠していることを確認します。パーサーの作成