クエリログ

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
クエリ

作成対象：

ユーザー
開発者

IMPORTANT

特定のクエリログ機能は、現在、限定リリースになっており、すべてのお客様が使用できるわけではありません。編集アイコンを使用しない場合、UI の表示が若干異なる場合があります。また、クエリ名を選択するプロセスで、クエリログの詳細ビューではなくクエリエディターに移動する場合もあります。

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

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

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

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

NOTE

システムクエリとダッシュボードクエリは、どちらもデフォルトで除外されます。設定に基づいて表示されるログを絞り込む方法については、フィルターの節を参照してください。

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

カスタマイズと検索 customize-and-search

クエリサービスログは、カスタマイズ可能なテーブル形式で表示されます。テーブルの列をカスタマイズするには、「設定」アイコン（）を選択します。テーブルをカスタマイズダイアログが表示され、各列の選択を解除できます。

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

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

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

ログデータの検出

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

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

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

NOTE

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

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

IMPORTANT

特定のクエリログ機能は、現在、限定リリースになっており、すべてのお客様が使用できるわけではありません。

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

NOTE

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

クエリログの詳細表示

ログを編集 edit-logs

各行のテンプレート名または SQL スニペットの横には、鉛筆アイコン（）を選択します。これを使用して、クエリエディターに移動できます。次に、エディターで編集できるようにクエリが事前設定されます。

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

ログをフィルター filter-logs

様々な設定に基づいて、クエリログのリストをフィルタリングできます。フィルターアイコン（）をクリックし、左側のパネルで一連のフィルターオプションを開きます。

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

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

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

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

フィルター

説明

ダッシュボードクエリを除外

このチェックボックスはデフォルトで有効になっており、インサイトの生成に使用されるクエリで生成されたログは除外されます。これらのクエリはシステムで生成され、監視、管理、トラブルシューティングに必要な、ユーザーが生成したログの記録を隠します。システム生成ログを表示するには、このチェックボックスをオフにします。

システムクエリを除外

このチェックボックスはデフォルトで有効になっており、システムで生成されたログは除外されます。システム生成クエリには、多くの場合、ユーザーの監視、管理、トラブルシューティングの目的には関係しない可能性のあるバックグラウンドタスクやメンテナンス操作が含まれます。システム生成ログを調べる必要がある場合は、このチェックボックスをオフにして、ログ表示に含めます。

開始日

特定の期間中に作成されたクエリのログをフィルタリングするには、「開始日」セクションで開始日と終了日を設定します。

完了日

特定の期間に完了したクエリについてログをフィルタリングするには、「完了日セクションで開始日と終了日の日付を設定します。

ステータス

クエリのステータスに基づいてログをフィルタリングするには、適切なラジオボタンを選択します。使用可能なオプションには、送信済み、処理中、成功、失敗などがあります。ログは、一度に 1 つのステータス条件に基づいてのみフィルタリングできます。

クライアント

使用するクエリクライアントに基づいてログをフィルタリングするには、許可された値 API、Adobe Query Service UI、QsAccel のいずれかをフリーテキストフィールドに入力します。

マイクエリ

マイクエリ切替スイッチを使用して、ログをフィルタリングし、実行したクエリを確認します。

クエリログ ID

クエリの一意のログ ID に基づいてフィルタリングするには、ログ ID をフリーテキストフィールドに入力します。この情報は、ログの詳細にあります。