デスクトップ フロー アクション ログの構成

このページは、Power Platform 管理センター の環境機能セクションにあるデスクトップ フロー ログの構成ガイダンスを提供します。

実行アクション ログのアクティブ化ステータス 設定では、デスクトップ フロー実行アクション ログをいつキャプチャするかを定義し、ログを完全にオフにすることもできます。

デスクトップ フローア クション ログ バージョンの構成 (プレビュー)

アクション ログ バージョン では、V1、V2、またはその両方を選択できます。

FlowLogs エンティティの有効期間 (分) (プレビュー) の値は、アクション ログをフロー ログのエラスティック テーブルに保持する期間を決定します。 Dataverse は指定された期間よりも古いレコードを自動的に削除します。 たとえば、次のような値があります。

デスクトップ フロー ログ V1 と V2 の主な違い

次の表は、デスクトップ フロー ログ V1 と V2 の違いを示しています。

Logs V2 は、以前のバージョンである V1 に比べて大幅に機能強化されています。 V2 は、アクション ログ シナリオなどの大量のデータを処理するのに適しており、データ保持 (TTL) が組み込まれた エラスティック テーブル 機能を使用します。 レポート、ガバナンス、自動データ保持制御との統合のために大量のデータにアクセスする必要がある組織に最適です。

Dataverse ログV2の容量需要計算 (プレビュー)

次の表は、ログ V2 を使用した場合の、デスクトップフロー実行ごとの Dataverse データベース ストレージ消費量の見積もり例です。 アクションごとに平均 3 KB のストレージを想定し、さまざまな数のアクションのおおよそのストレージ需要を示します。

ログV2 (プレビュー) データのクエリ

デスクトップ フロー アクション ログ データにアクセスするには、従来の API 呼び出し構文を使用するか、新しい ExecuteCosmosSqlQuery メソッドを使用して、Dataverse バックエンドに API 呼び出しを行います。 この方法では、Dataverse に対して SQL クエリを実行することができ、データの検索やフィルターが可能になります。

ログ V2 のデータ モデルは、フロー セッション テーブルとフロー ログ テーブル間の親子関係に基づいています。 すべてのレコードは、親フロー セッション レコードから権限を継承します。 特定のデスクトップ フロー実行のアクション ログをクエリするには、次のクエリ構文を使用できます。

従来の Dataverse API 呼び出し構文

以下の API 呼び出しは、ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) によって特定のフローセッションを取得し、flowsession_flowlog_parentobjectid リレーションシップを使用して関連するアクション ログにアクセスします。

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid  

FlowLogs テーブルを使用した新しい ExecuteCosmosSqlQuery API 呼び出し構文

    [Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
    QueryText=@p1,EntityLogicalName=@p2,PartitionId=@p3,QueryParameters=@p4,PageSize=@p5)?
    @p1: 'SELECT c.props.flowlogid as flowlogid, c.props.createdon as createdon, c.props.data as data, c.props.level as level, c.props.type as type, c.ttl as ttlinseconds, c.props.cloudflowid as cloudflowid, c.props.cloudflowrunid as cloudflowrunid, c.props.desktopflowid as desktopflowid, c.props.flowmachineid as flowmachineid, c.props.flowmachinegroupid as flowmachinegroupid, c.props.flowsessionid as flowsessionid, c.props.workqueueid as workqueueid, c.props.workqueueitemid as workqueueitemid FROM c WHERE c.props.type IN (100000001) ORDER BY c.props.data.startTime DESC'
    @p2: 'flowlog'
    @p3: 'flowsession_40590757-a9c0-4f4c-abfc-e2f389049d90'
    @p4: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
    @p5: 50

エラスティック テーブル内の JSON 列のクエリ の詳細情報。

通話を個々のパーツに分解する

• ベース URL (https:// [自分の組織].api.crm[自分の地域].dynamics.com/api/data/v9.2/) は、Dataverse Web API のエンドポイントです。
• 呼び出されるメソッドは ExecuteCosmosSqlQuery です。 このメソッドでは、Dataverse に対して SQL クエリを実行することができます。
• ExecuteCosmosSqlQuery メソッドのパラメーターは、メソッド名の後の括弧内に示されます。 次のようなことを行うことができます。
  • QueryText=@p1: 実行する SQL クエリ。 この場合、クエリは、タイプ が 100000001 (デスクトップ フロー アクション ログ タイプ) であるテーブルからさまざまなプロパティを選択し、startTime プロパティによって結果を降順に並べます。
  • EntityLogicalName=@p2: これは、アクション ログを格納するテーブル (flowlog) の論理名です。
  • PartitionId=@p3: このパラメーターは、クエリが実行される Azure Cosmos DB 内のパーティションの識別に使用されます。 flowsession_[flowsessionid] に設定されています。
  • QueryParameters=@p4: これはクエリのパラメータを指定する JSON オブジェクトです。 前の例では、キーが @referencingParentId であり @referencingParentLogicalName 、値が flowsessionid (GUID) とテーブルのタイプ flowsessionである キーと値のペア を指定しています。
  • PageSize=p5: これはクエリ ページ サイズです。

既知の制限

• ログV2 (プレビュー) は、デスクトップ フロー コネクタ アクションを介して クラウド フロー から起動される デスクトップ フロー 実行でのみ使用できます。
• アクション ログのバージョンを変更しても、以前のデスクトップ フロー アクション ログは新しいログ ストレージ タイプに移行されません。