[生データ] ページには、アプリケーションによって実際に取り込まれたログが表示されます。このページを使用して、データがレポートされているかどうかの確認、フィールド内容の確認、ログを検索してリクエストを特定することができます。直接書き込みと参照 SessionStore のいずれも、それぞれの [生データ] エントリからクエリするため、別のストレージ宛てに手動で切り替える必要はありません。
前提条件
-
データインジェストが完了しており、宛先データをクエリする権限があること。
-
クエリの時間範囲内にデータが存在すること。
-
フィールドベースの検索または SQL 分析を使用する場合、関連するインデックスが設定され、利用可能であること。参照モードでは、インデックスはソース Logstore で管理されます。
操作手順
-
宛先 SessionStore を開き、[生データ] を選択します。
-
時間範囲を設定します。初回アクセス時のデフォルトの時間範囲は直近 15 分です。過去の問題をトラブルシューティングするには、該当する絶対時間範囲を選択します。
-
検索ボックスにクエリ文を入力し、[Search & Analyze] をクリックします。
-
結果でフィールドとログ内容を確認します。必要に応じて、ヒストグラム、クイック分析、列設定を使用できます。
-
結果が返されない場合は、
*を使用して再試行し、その後フィルター条件を段階的に追加します。
注:生データ、トレース、セッションでは、必ずしも同じフィールド名が使用されるとは限りません。たとえば、一部の OpenTelemetry の生ログではtraceIdが使用されますが、処理済みのトラジェクトリではtrace_idが使用されます。他のページからフィールド名をコピーするのではなく、まず生のレコードを確認してください。
一般的なクエリ例
例の値は参照用です。実際のデータに置き換えてください。
時間範囲内のすべてのログの表示
*
実際の生フィールド名によるトレースのクエリ
次の例は、生ログに traceId が含まれ、インデックスが設定されている場合にのみ適用されます。
traceId:"0123456789abcdef0123456789abcdef"
生ログで trace_id または別の名前が使用されている場合は、実際のフィールド名に置き換えてください。
複数フィールド条件の組み合わせ
次の例では、serviceName と statusCode が検索可能であることが必要です。
serviceName:"demo-toolservice" AND statusCode:"2"
収集方法によって、ステータスコードの定義が異なる場合があります。データ形式を確認する前に、数値 2 を特定の業務ステータスとして解釈しないでください。
現在の範囲内のログ数のカウント
SQL をサポートするクエリモードでは、次のステートメントを使用できます:
* | SELECT count(*) AS log_count
このステートメントは、セッション数、ユニークリクエスト数、またはトラジェクトリ数ではなく、条件に一致する生ログレコード数をカウントします。分析で他のフィールドを使用する場合は、対応する分析インデックスが必要です。具体的なクエリ機能は、現在のリソースおよびサービスのサポート状況によって異なります。
クエリ支援機能の使用
|
機能 |
目的 |
|
ヒストグラム |
時間範囲内のログの分布を表示し、データが存在する期間や、データの異常が集中している期間を特定しやすくします。 |
|
クイック分析 |
利用可能なフィールドの分布を表示し、追加の検索条件を選択するのに役立ちます。 |
|
列の設定 |
ログリストに表示するフィールドを調整し、不要な情報を減らします。 |
|
クエリと分析のプロパティ |
現在のインデックスを表示します。直接書き込みモードの生データのインデックスは、権限に応じて作成または変更できます。参照元のインデックスは読み取り専用です。 |
クエリでエラーが返された場合は、リクエストの失敗と一致するデータがない状況を切り分けてください。存在しないフィールド、サポートされていないインデックス、または権限不足であっても、業務上の動作が発生しなかったことを意味するわけではありません。
制限事項
SessionStore の [生データ] ページでは、標準の Logstore のコンソール機能がすべて利用できるわけではありません。ログのダウンロード、コンテキストクエリ、LiveTail、自動更新、保存済み検索、アラートの作成、一般共有といった項目は利用できません。標準の Logstore のメニューパスに従って、これらの操作を探さないでください。
最新のデータが必要な場合は、クエリを再実行してください。過去の問題を確認する場合は、相対時間では時間の経過に伴い対象範囲が移動してしまい、元のデータを見落とすおそれがあるため、絶対時間範囲を使用することを推奨します。