クエリログ

Adobe Experience Platformは、APIとUIの両方を通じて発生するすべてのクエリイベントのログを保持します。 この情報は、クエリサービス UIの「​ ログ ​」タブで確認できます。

ログファイルは、任意のクエリイベントによって自動的に生成され、使用されたSQL、クエリのステータス、所要時間、最後の実行時間などの情報が含まれます。 クエリログデータは、非効率的なクエリや問題のあるクエリをトラブルシューティングするための強力なツールとして使用できます。 監査ログ機能の一部として、より包括的なログ情報が保持されます。詳しくは、監査ログのドキュメント ​を参照してください。

クエリログの確認 check-query-logs

クエリログを確認するには、​ クエリ ​を選択してクエリサービスワークスペースに移動し、使用可能なオプションから​ ログ ​を選択します。

NOTE
システムクエリとダッシュボードクエリの両方がデフォルトで除外されます。 設定に基づいて表示されるログを調整する方法については、​ フィルターの節を参照してください。

​ クエリとログがハイライト表示されたExperience Platform UI。

クエリサービスのログは、カスタマイズ可能なテーブル形式で表示されます。 テーブル列をカスタマイズするには、設定アイコン ( 設定アイコン。 )を選択します Q&A ボックスを解放していますので。 各列の選択を解除できる​ テーブルをカスタマイズ ​ ダイアログが表示されます。

検索フィールドにテンプレート名を入力して、特定のクエリテンプレートに関連するログを検索することもできます。

検索バーと列テーブルの管理ドロップダウンがハイライト表示されたクエリログワークスペース。

各ログテーブル列🔗の説明は、クエリサービスの概要の「ログ」セクションにあります。

ログデータの確認

各行は、クエリテンプレートに関連付けられたクエリ実行のログデータを表します。 テーブルから任意の行を選択して、右側のサイドバーにその実行のログデータを入力します。

行が選択され、右側のサイドバーのログデータがハイライト表示されたクエリログワークスペース。

ログの詳細パネルでは、様々なアクションを実行できます。 クエリをCTASとして実行して、新しい出力データセットを作成したり、実行で使用された完全なSQL クエリを参照またはコピーしたり、クエリを削除したりできます。

NOTE
CTASとして実行するオプションは、SELECT クエリでのみ使用できます。

行が選択されたクエリログワークスペース、CTASとして実行、クエリを削除、SQLをコピーのアイコンがハイライト表示されています。

名前列からクエリテンプレート名を選択して、​ クエリログの詳細 ビューに直接移動することもできます。

NOTE
クエリがAPIを使用して作成され、初期化中にテンプレート名が提供されなかった場合は、代わりにSQL クエリの最初の数十の文字が表示されます。

​ クエリログの詳細ビュー。

ログの編集 edit-logs

各行のテンプレート名またはSQL スニペットの横には、鉛筆アイコン( 鉛筆アイコン。 )があります クエリエディターに移動するために使用できます。 その後、編集用にクエリがエディターに事前入力されます。

鉛筆アイコンがハイライト表示されたクエリログワークスペース。

ログのフィルタリング filter-logs

さまざまな設定に基づいて、クエリログのリストをフィルタリングできます。 フィルターアイコンを選択( ​ フィルターアイコン。 ) ワークスペースの左上で、左側のパネルで一連のフィルターオプションを開きます。

​ フィルターアイコンがハイライト表示されたクエリログワークスペース。

使用可能なフィルターのリストが表示されます。

​ フィルターのオプションが表示され、ハイライト表示されたクエリ ログ ワークスペース。

次の表に、各フィルターの説明を示します。

フィルター
説明
​ ダッシュボードクエリを除外
このチェックボックスはデフォルトで有効になっており、インサイトの生成に使用されるクエリによって生成されたログは除外されます。 これらのクエリはシステムで生成され、監視、管理、トラブルシューティングに必要なユーザー生成ログの記録を不明瞭にします。 システム生成ログを表示するには、チェックボックスをオフにします。
​ システムクエリを除外
このチェックボックスはデフォルトで有効になっており、システムによって生成されたログは除外されます。 システム生成クエリには、多くの場合、ユーザーの監視、管理、トラブルシューティングの目的とは関連しないバックグラウンドタスクやメンテナンス操作が含まれます。 システムで生成されたログを調べる必要がある場合は、このチェックボックスをオフにしてログビューに含めます。
開始日
特定の期間に作成されたクエリのログをフィルタリングするには、開始日 セクションで開始日と終了日を設定します。
完了日
特定の期間に完了したクエリのログをフィルタリングするには、完了日 セクションで開始日と終了日を設定します。
ステータス
クエリの​ ステータス ​に基づいてログをフィルタリングするには、適切なラジオボタンを選択します。 使用可能なオプションには、送信済み、進行中、成功、失敗があります。 一度に1つのステータス条件に基づいてログのみをフィルタリングできます。
​ クライアント ​
使用するクエリクライアントに基づいてログをフィルタリングするには、次のいずれかの受け入れられる値をフリーテキストフィールドに入力します:APIAdobe Query Service UI、またはQsAccel
自分のクエリ ​
​ マイクエリ ​ トグルを使用して、自分が実行したクエリのログをフィルタリングします。
​ クエリログ ID
クエリの一意のログ IDに基づいてフィルタリングするには、空きテキストフィールドにログ IDを入力します。 この情報は、​ ログの詳細にあります。

適用されたフィルターは、フィルタリングされたログ結果の上に表示されます。

適用されたフィルターのリストがハイライト表示されたクエリワークスペースの「ログ」タブ。

次の手順

このドキュメントでは、クエリサービス UIでクエリログにアクセスして使用する方法について詳しく説明します。

クエリサービスの機能について詳しくは、UI の概要または Query Service API ガイドを参照してください。

スケジュールされたクエリ実行の可視性をクエリサービスがどのように向上させるかについては、​ クエリの監視ドキュメント ​を参照してください。

recommendation-more-help
experience-platform-help-query-service