Query Service監査ログの統合

Adobe Experience Platform Query Service監査ログ統合では、クエリ関連のユーザーアクションのレコードが提供されます。 監査ログは、企業のデータ管理ポリシーや規制要件のトラブルシューティングや遵守に役立つ重要なツールです。 この機能を使用すると、多くのイベントタイプのアクションログを返し、レコードをフィルタリングおよびエクスポートできます。 ログは、Experience Platform UIまたはAudit Query APIを通じてアクセスし、CSVまたはJSON ファイル形式でダウンロードできます。

監査ログのユーザーインターフェイスについて詳しくは、監査ログの概要ドキュメント ​を参照してください。 Experience Platform APIの呼び出しについて詳しくは、監査ログ API ガイド ​を参照してください。

NOTE
セッション削除アクションがログに記録されます。 UI ワークフローについては、​ クエリサービスセッションの管理を参照してください。

前提条件

Experience Platform UI内で監査ログダッシュボードを表示するには、Data Governance ​ ユーザーアクティビティログの表示権限を有効にする必要があります。 この権限は、Adobe Admin Console を使用して有効にできます。 この権限を有効にするための管理者権限がない場合は、組織の管理者に問い合わせてください。 Admin Console を使用した権限の追加に関する完全な手順については、アクセス制御に関するドキュメントを参照してください。

Query Service個の監査ログ カテゴリ audit-log-categories

Query Serviceが提供する監査ログのカテゴリは次のとおりです。

カテゴリ
説明
クエリ
このカテゴリでは、クエリ実行を監査できます。
​ クエリテンプレート ​
このカテゴリでは、クエリテンプレートで実行されたさまざまなアクション(作成、更新、削除)を監査できます。
​ スケジュール済みクエリ ​
このカテゴリでは、Query Service内に作成、更新、または削除されたスケジュールを監査できます。

Query Service監査ログの実行 perform-an-audit-log

Query Service アクティビティの監査を実行するには、左側のナビゲーションから「監査」を選択し、続いてfunnel アイコン( ​ フィルターアイコン ​ )を選択します。 フィルターのコントロールのリストを表示して、結果を絞り込みます。

左側のナビゲーションとフィルター制御に「監査」がハイライト表示されたExperience Platform UI監査ログダッシュボード。

監査 ダッシュボード ​ アクティビティログ ​ タブから、記録されたすべてのExperience Platform アクションをQuery Service カテゴリーでフィルタリングできます。 ログ結果は、実行された期間、実行されたアクション/関数、またはクエリを実行したユーザーに基づいて、さらにフィルタリングできます。 カテゴリ、アクション、ユーザー、ステータス 🔗に基づいてログをフィルタリングする方法については、監査ログのドキュメントを参照してください。

返される監査ログデータには、選択したフィルター条件を満たすすべてのクエリに関する次の情報が含まれます。

列の名前
説明
​ タイムスタンプ ​
month/day/year hour:minute AM/PM形式で実行されたアクションの正確な日時。
​ アセット名
​ アセット名 フィールドの値は、フィルターとして選択したカテゴリによって異なります。 ​ スケジュール済みクエリ ​ カテゴリを使用する場合、これは​ スケジュール名 ​です。 ​ クエリテンプレート ​ カテゴリを使用する場合、これは​ テンプレート名 ​です。 ​ クエリ ​ カテゴリを使用する場合、これは​ セッション ID ​です
カテゴリ
このフィールドは、フィルタードロップダウンで選択したカテゴリと一致します。
アクション
これは、作成、削除、更新、実行のいずれかです。 使用可能なアクションは、フィルターとして選択したカテゴリによって異なります。
ユーザー
このフィールドは、クエリを実行したユーザーIDを提供します。

​ フィルタリングされたアクティビティログがハイライト表示された監査ダッシュボード。

NOTE
ログ結果をCSVまたはJSON ファイル形式でダウンロードすると、監査ログダッシュボードにデフォルトで表示されるよりも多くのクエリの詳細が提供されます。

詳細パネル

監査ログの結果の任意の行を選択して、画面の右側にある詳細パネルを開きます。

詳細パネルがハイライト表示されたダッシュボードアクティビティログのタブを監査します。

詳細パネルを使用して、​ アセット IDと​ イベントステータス ​を検索できます。

​ アセット IDの値は、監査で使用されるカテゴリによって異なります。

  • ​ クエリ ​ カテゴリを使用する場合、​ アセット IDは​ セッション ID ​です。
  • ​ クエリテンプレート ​ カテゴリを使用する場合、​ アセット IDは​ テンプレート ID ​で、templateID:というプレフィックスが付きます。
  • ​ スケジュール済みクエリ ​ カテゴリを使用する場合、​ アセット IDは​ スケジュール ID ​で、scheduleID:というプレフィックスが付きます。

​ イベントステータス ​の値は、監査で使用されるカテゴリによって異なります。

  • ​ クエリ ​ カテゴリを使用する場合、​ イベントステータス ​ フィールドには、そのセッション内でユーザーが実行したすべての​ クエリ ID ​のリストが表示されます。
  • ​ クエリテンプレート ​ カテゴリを使用する場合、​ イベントステータス ​ フィールドには、イベントステータスのプレフィックスとして​ テンプレート名 ​が表示されます。
  • ​ クエリスケジュール ​ カテゴリを使用する場合、​ イベントステータス ​ フィールドには、イベントステータスのプレフィックスとして​ スケジュール名 ​が表示されます。

Query Service個の監査ログカテゴリで使用可能なフィルター available-filters

使用可能なフィルターは、ドロップダウンで選択したカテゴリによって異なります。 次の表は、Query Service 監査ログカテゴリ ​で使用できるフィルターの詳細を示しています。

フィルター
説明
カテゴリ
使用可能なカテゴリの完全なリストについては、Query Service 監査ログカテゴリ ​の節を参照してください。
アクション
Query Service個の監査カテゴリを参照する場合、更新は既存のフォーム ​変更され、削除は​ スケジュールまたはテンプレート ​の削除、作成は​新しいスケジュールまたはテンプレートの作成、実行は​クエリを実行しています
ユーザー
完全なユーザーID (johndoe@acme.comなど)を入力して、ユーザーでフィルタリングします。
ステータス
許可、成功および失敗 オプションは、「ステータス」または「イベントステータス」に基づいてログをフィルタリングしますが、拒否 オプションは​すべての ログをフィルタリングします。
日付
結果をフィルターする日付範囲を定義する開始日および/または終了日を選択します。

次の手順

このドキュメントを読むことで、Query Service監査ログ機能と、それを使用してQuery Service ユーザーアクションをフィルタリングする方法について理解を深めることができます。

トラブルシューティングの目的でQuery Service監査ログ機能を使用している場合は、​ トラブルシューティングガイド ​をお読みになることをお勧めします。

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