ログ検索

Workflow Lineage のログを検索タブでは、実行を横断してサービスログを検索できます。ログ検索を使用して、繰り返し発生するエラーを調査したり、特定のメッセージを見つけたり、ワークフロー内の異なるリソースのログを比較したりできます。

ログ検索モード

グローバルログ検索は、すべてのクラウドエンロールメントで利用可能です。非クラウドエンロールメントでは、代わりに単一ソースエグゼキューター検索を使用します。

単一ソースエグゼキューター検索

単一ソースエグゼキューター検索では、特定のソースエグゼキューターを起点とする実行を検索します。ソースエグゼキューターとは、関数、アクション、自動化、AIP Logic 関数、AIP Chatbot、モデルのライブデプロイメントなど、呼び出しチェーン内で最初の実行可能なリソースです。

選択したリソースが別のリソースから呼び出された場合、そのリソースはソースエグゼキューターではないため、そのログは検索結果に含まれません。代わりに、呼び出しチェーンを開始したリソースから検索します。

ソースエグゼキューターの候補

選択したリソースのログが見つからない場合、ログを検索パネルは、そのリソースが最近ほかのソースエグゼキューターから呼び出されたかどうかを確認し、それらを候補として表示します。候補のソースエグゼキューターを選択すると、グラフ内のそのノードに移動し、代わりにそのログを検索します。

パネルヘッダーには、最近のほかの実行元インジケーターも表示されます。このインジケーターを選択すると、選択したリソースを最近呼び出したソースエグゼキューターを表示し、移動できます。

グローバルログ検索

グローバルログ検索では、Workflow Lineage グラフ内の実行可能なリソースを横断して検索できます。単一ソースエグゼキューター検索とは異なり、選択したノードを常にソースエグゼキューターとして扱うわけではありません。

サポート対象のノードを1個選択した場合、検索の動作はそのリソースの種類によって異なります。

• 関数、AIP Logic 関数、アクション、AIP Chatbot、モデルのライブデプロイメント、言語モデル： 選択したノードをログ生成リソースとして、そのノードが発行したログを検索します。結果には、別のソースエグゼキューターを起点とする実行のログも含まれます。
• 自動化： 選択した自動化を起点とする実行のログを検索します。

ほかの種類のリソースは、現在グローバルログ検索ではサポートされていません。

言語モデルのログは、関数や AIP Logic 関数など、サポート対象のソースエグゼキューターからモデルが呼び出された場合にのみ、グローバルログ検索に表示されます。特定の言語モデルのログを検索するには、グラフ内のそのノードを選択するか、リソースを生成中フィルターで言語モデルを選択します。

サポート対象のノードを複数選択した場合は、検索範囲を決める方法を選択します。

• 選択したリソース全体： 呼び出しチェーンに関係なく、選択したリソースのいずれかが生成リソースまたはソースエグゼキューターであるログを含めます。結果には、グラフに表示されていない呼び出しチェーンのログが含まれる場合があります。この選択肢はデフォルトで選択されています。
• 選択した呼び出しチェーン内： 生成リソースとソースエグゼキューターの両方が選択されている、選択範囲内の呼び出しチェーンのログに結果を限定します。

ノードを選択していない場合、グローバルログ検索はグラフ内のサポート対象のすべてのリソースを横断して検索します。

ログ検索にアクセスする

ログ検索にアクセスするには、次の手順を実行します。

1. Workflow Lineage を開き、調査するワークフローに移動します。
2. 検索するリソースノードを選択します。グローバルログ検索では、どのノードも選択しないまま、グラフ全体を検索できます。
3. 下部パネルのログを検索タブを選択します。
4. サポート対象のリソースを複数選択した場合は、ログを検索の横にある範囲メニューを使用して、選択したリソース全体または選択した呼び出しチェーン内を検索します。

ログを検索して絞り込む

検索バーにテキストを入力すると、メッセージとコンテンツのフィールドを含むログ行全体を対象に一致するテキストを検索します。検索では大文字と小文字が区別されます。* をワイルドカード文字として使用すると、任意の文字列に一致させることができます。

例：

• connection failed は、その語句に完全一致するテキストを含むログ行を検索します。
• timeout*retry は、timeout の後に retry が続くログ行を検索します。この2つの間には任意の文字を含められます。
• Error は Error を検索しますが、error や ERROR は検索しません。

フィルターサイドバーを使用して、結果を絞り込みます。検索範囲に応じて、次のフィルターが利用可能です。

• ログレベル： ERROR、WARN、INFO など、特定の重大度のログを表示します。
• Timestamp の範囲： 相対的な時間範囲、またはカスタムの開始時刻と終了時刻を選択します。デフォルトは過去1日です。単一ソースエグゼキューター検索では、選択可能な範囲はエンロールメントのログ保持期間に制限され、その期間は日付ピッカーに表示されます。グローバルログ検索では、選択可能な範囲は最大30日です。
• リソースを生成中： 呼び出しチェーン内の特定のリソースが発行したログを表示します。
• ソースエグゼキューター： 特定のソースエグゼキューターに関連するログを表示します。
• コードの発生元： ユーザーコードからのログのみ、または Foundry からのログのみを表示します。

複数のフィルターを適用した場合、ログはすべてのフィルターに一致する必要があります。デフォルトフィルターに戻すには、リセットを選択します。

結果テーブル

結果は最新のログから順に表示されます。表示される列は、検索モードと範囲によって異なる場合があります。

どちらの列が表示されるかは、検索範囲によって決まります。単一ソースエグゼキューター検索では、リソースを生成中が表示されます。グラフ全体または複数のリソースを横断するグローバルログ検索でも同様です。グローバルログ検索を特定のログ生成リソースに絞り込むと、代わりにソースエグゼキューターがテーブルに表示されます。

検索テキストに一致する部分は、メッセージ列とコンテンツ列で強調表示されます。

結果は、単一ソースエグゼキューター検索では1ページあたり100件、グローバルログ検索では1ページあたり25件ずつ読み込まれます。さらに結果を読み込むには、テーブルの末尾までスクロールします。検索はライブストリームではありません。検索開始後に生成されたログを含めるには、フィルターを変更するか、表示を再読み込みします。

ログエントリー全体を確認するには、メッセージまたはコンテンツのセルを選択します。詳細表示には、メッセージタブとコンテンツタブ、エントリー内のテキストを検索するための検索バー、長いログ行用の折り返して全体を表示する切り替えがあります。

結果を生成した実行を調査するには、行にカーソルを合わせてトレースを表示するを選択します。Workflow Lineage でトレースビューが開き、実行タイムラインと呼び出しチェーン内のリソースを確認できます。

権限と保持

ログ検索には、実行履歴に加えて、追加のアクセス要件があります。実行履歴内の実行にアクセスできても、そのログにアクセスできるとは限りません。共有の実行ログを検索するには、リソースに対する foundry-telemetry-service:view-execution-history 操作権限が必要です。デフォルトでは、編集者ロールにこの操作権限が付与されていますが、エンロールメント管理者がカスタムロールを通じて付与することもできます。また、管理者は、ユーザーがアクセスできるマーキングを使用してログへのアクセスを有効にする必要があります。

ログへのアクセスが有効になっていない場合は、過去24時間以内のご自身の実行のログのみを検索できます。この例外は CBAC エンロールメントでは利用できず、ログへのアクセスを有効にする必要があります。

利用可能な結果は、エンロールメントのログ保持ポリシーによって制限されます。保持期間外のログは検索結果に表示されません。

アクセス要件と設定の詳細については、ログの権限を参照してください。

関連機能

• サービスログ：特定の実行のログを表示します。
• 実行履歴：リソースの最近の実行の一覧を見ます。
• トレースビュー：実行のタイムラインを確認し、ログと関連付けます。
• ログの権限：ログへのアクセスを設定します。