SessionStore を作成した後、選択した形式のデータが収集パイプラインに入ることを確認する必要があります。このトピックでは、直接書き込みモードと参照モードでの操作場所、Logtail の構成方法、およびデータインジェストの検証方法について説明します。
適切な書き込み先の選択
|
SessionStore のタイプ |
アプリケーションデータの書き込み先 |
収集の管理場所 |
|
直接書き込み |
作成した SessionStore |
SessionStore の [概要] ページ、[データインジェスト] ページ、または Logtail 構成の管理ページ。 |
|
参照 |
作成時に関連付けたソース Logstore |
ソース Logstore の収集管理ページ。 |
直接書き込みによるデータインジェストで宛先名を指定する必要がある場合は、現在の SessionStore の名前と、それが所属するプロジェクトの名前を使用します。サフィックスを付けたり、別の Logstore を作成したりしないでください。
参照モードでは、SessionStore に対する Logtail データインジェストのエントリは個別に存在しません。これは 2 つのモード間の仕様上の違いであり、リソース障害を示すものではありません。
直接書き込みモード:収集設定の作成
前提条件
-
直接書き込みモードの SessionStore が作成されていること。
-
収集するデータが、SessionStore の生データ形式に一致していること。
-
Logtail を使用してサーバーファイルを収集する場合は、コレクターがインストールされ、マシングループが構成され、接続が確認されており、収集プロセスがログファイルを読み取れること。
操作手順
-
宛先の SessionStore を開きます。
-
[概要] ページの Logtail 構成セクションにある作成エントリに移動するか、[生データ] ページで [データインジェスト] をクリックします。次に、Logtail 構成を作成します。
-
データインジェストのカタログで、アプリケーションに適した、SessionStore をサポートする収集方法を選択します。
-
収集ウィザードに従って、データソース、処理方法、および宛先情報を設定します。出力先が現在の SessionStore であることを確認します。
-
設定を作成し、対応するマシングループに適用します。
-
新しいログを生成し、このトピックの「データインジェストの検証」セクションの説明に従って結果を確認します。
注:インジェストカタログには、Simple Log Service (SLS) の収集方法が複数含まれる場合があります。カタログにカードが表示されることは、その方法が選択した SessionStore のデータ形式をサポートしていることを意味しません。各方法の適用性に関する説明と、実際のウィザードを参照してください。
収集設定の確認
ウィザードは収集方法によって異なります。選択した方法のページを参照してください。ファイル収集の場合は、設定を送信する前に次の項目を確認してください。
|
確認項目 |
確認内容 |
例 |
|
設定名 |
アプリケーションと環境を識別しやすく、ページ要件を満たしていること |
|
|
ログディレクトリ |
お使いのコンピューター上のディレクトリではなく、コレクターが存在するマシン上のディレクトリであること |
|
|
ファイルマッチング |
アプリケーションによって生成されるログファイルを実際にカバーしていること |
|
|
エンコードと解析 |
ファイルの実際のエンコードと内容に一致していること |
UTF-8 と JSON 形式。 |
|
マシングループ |
実際にログを生成するマシンが含まれており、マシンが正しく接続されていること |
実際のマシングループを確認します。 |
|
出力先 |
現在のプロジェクトと SessionStore |
別のリソースに変更しないでください。 |
JSON 解析はログ内容のみを解析し、セッション ID やモデルの入力と出力などの業務フィールドは自動的に追加しません。ファイルレコードが選択した生データ形式に準拠していることを確認してください。
設定の作成または適用の失敗
設定を正常に作成できたからといって、すべてのマシングループに正常に適用されたとは限りません。エラーが発生した場合は、既存の設定と適用状況を先に確認し、現在のウィザードが提供する復旧エントリを使用して失敗項目を処理し、コレクターが実際に設定を受信していることを確認してください。
マシングループへの適用を再試行するために、同じ名前の設定を繰り返し作成しないでください。ページを閉じるか更新した後、既存の結果を確認してから次の手順を判断してください。
参照モード:ソース Logstore の維持
-
SessionStore の [概要] ページで、ソースプロジェクトと Logstore を確認します。
-
ソース Logstore の収集管理ページを開き、元の収集設定を作成または変更します。
-
新しいデータが継続的に Logstore に入ることを確認してください。
-
SessionStore に戻り、生データをクエリしてから、処理済みの軌跡とセッションを確認します。
ソース Logstore は他の用途でも使用されている場合があります。収集ルール、インデックス、権限、または保持期間を変更する前に、他の利用者への影響を評価してください。
Logtail 構成の表示と維持
直接書き込みモードの SessionStore では、構成名の検索、ページの切り替え、構成リストの更新が可能です。構成名または管理エントリをクリックして構成詳細ページに移動します。次に、ページの機能に基づいて構成を変更し、マシングループの適用状況を確認します。
収集設定の削除と SessionStore の削除は別の操作です。設定を削除する前に、使用範囲とマシングループの依存関係を確認し、必要な収集が中断されないようにしてください。保存済みデータを消去する目的で収集設定を削除しないでください。
データインジェストの検証
-
新しいテストインタラクションの発生時刻と識別子を記録してください。
-
[生データ] ページで、発生時刻を含む時間範囲を選択し、
*を使用してデータをクエリしてください。 -
実際のフィールドとその値を確認してください。特に、実行をセッションに関連付ける識別子を確認してください。
-
[単一軌跡] ページと [セッション] ページで同じインタラクションをクエリし、処理に必要な時間を確保してください。
|
症状 |
最初に確認する項目 |
|
生データが空である |
書き込み先、ソースに新しいデータが存在するかどうか、ファイルパス、マシングループ、コレクター、書き込み権限、および時間範囲。 |
|
生データは表示されるが、軌跡が空である |
データ形式、処理の待機時間、バックエンドサービスの認可、および軌跡に必要なフィールド。 |
|
軌跡は表示されるが、セッションが空である |
セッション ID が存在し一貫性があるかどうか、およびクエリの時間範囲に対応するレコードが含まれているかどうか。 |
|
ツールスパンは表示されるが、軌跡にツールステップが表示されない |
ソースデータに、処理に必要な関連コンテンツが含まれているかどうか。単一のツールスパンだけでは、表示可能なツールステップを形成するには不十分な場合があります。 |
処理結果は、生データよりも後に生成される場合があります。サイレンスベースのトリガーを使用する OpenTelemetry トレースパイプラインでは、継続的なアクティビティと遅延データもスナップショットの生成に影響します。