次の方法で共有


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

このトピックはプレリリース ドキュメントであり、変更される場合があります。

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

重要

  • これはプレビュー機能です。
  • プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。
  • この機能は、Power Automate デスクトップからのローカル アテンド型実行ではまだ利用できません。
  • これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
  • このページに記載されている機能の一部はまだ段階的に展開中であり、お住まいの地域ではまだご利用いただけない可能性があります。

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

スクリーンショットと環境レベルの設定により、デスクトップ フロー ログをいつキャプチャするかを構成できます。

アクティブ化の状態 Details
有効 (既定) このオプションは既存の環境でも新しい環境でも既定で、ログは通常通り取得されます。
実行時エラー このオプションは、実行時エラーが発生した場合にのみ、デスクトップ フロー アクションのログを取得します。 つまり、ログは実行のたびに取得できるわけではなく、エラーが発生した場合にのみ取得できます。 ただし、エラーが発生した場合は、成功したアクションと失敗したアクションの両方を含め、その特定の実行に関するすべてのログが利用可能です。
無効 このオプションは、実質的に、デスクトップ フロー実行アクション ログを完全に無効化します。

注意

これらの設定を変更すると、実行失敗のトラブルシューティングや監査などの機能に大きな影響を与える可能性があります。 続行する前に、これらの設定を変更した場合の影響を考慮してください。

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

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

デスクトップ フロー ログ V2 を構成できるスクリーンショットと環境レベルの設定。

ログ バージョン 説明
V1 - FlowSession エンティティの AdditionalContext フィールドに格納されます これが既定のオプションです。 ログは、フロー セッション テーブルの AdditionalContext フィールドに格納されます。これは、Microsoft Dataverse に BLOB として格納されるファイル属性です。 ログ V1 は Dataverse ファイル キャパシティ を消費します。
V2 - FlowLogs エンティティに格納される (プレビュー) この新しいオプションにより、エラスティック テーブル に格納されているフロー ログ テーブルにログを格納することができます。 ログ V2 は Dataverse データベース キャパシティ を消費します。
両方 (プレビュー) この設定により、フロー セッション テーブルの従来 のAdditionalContext フィールドとフロー ログ テーブルの両方にログを保存できます。 この機能はプレビュー中で、Dataverse ファイルとデータベースの両方の容量を消費します。 これは Dataverse データベースとファイル キャパシティ の両方を消費するため、デバッグまたはテスト目的向けです。

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

日数 分数
1 日 1,440 分
3 日 4,320 分
7 日 10,080 分
14 日 20,160 分
28 日 40,320 分
60 日 86,400 分
90 日 129,600 分
180 日 259,200 分
365 日 525,600 分
永久 0 (ゼロ) 分以下

注意Note

ログ V2 を有効にする前に、データ保持設定をサポートする十分な Dataverse データベース容量があることを確認し、お客様の容量計画、権限、および必要に応じて調整します。 いくつかのサイズ設定の例については、次のセクションの サンプル Dataverse ログ V2 のキャパシティ需要計算 を参照してください。

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

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

特徴 ログ V1 ログ V2 Details
自動データ保持 N/A 対応可能 V2 は、Azure Cosmos DB が提供する エラスティック テーブル を使用しており、自動データ保持のための time-to-live 機能が組み込まれています。
大きなログ サイズのサポート 約 50,000~80,000 件のアクションログ (最大) V1 アクションログの数の約 2 倍 (初期) V2 は理論的には将来的に実行ごとにギガバイト相当のアクション ログまで拡張できますが、V1 はこの表で指定されたボリュームまでしか拡張できません。
高度なレポートとガバナンスのサポート N/A 対応可能 V1 では、AdditionalContext 属性はファイル タイプであり、Dataverse に BLOB として保存されるため、レポートやガバナンスコントロールのための解析が困難です。 V2 ではログへのアクセスがさらに容易になりました。
Azure Synapse Link for Dataverse 統合のサポート N/A 計画済み V1 では、AdditionalContex t属性はファイル タイプであり、 Dataverse にBLOBとして保存されますが、Azure Synapse への同期はサポートされていません。
Dataverse 監査のサポート N/A 計画済み V1 では、AdditionalContext 属性はファイル タイプであり、Dataverse に BLOB として格納され、Dataverse 監査ではサポートされていません。
Dataverse 長期保存のサポート N/A 計画済み V1 では、AdditionalContext 属性はファイル タイプであり、Dataverse に BLOB として格納され、Dataverse 長期保有ではサポートされていません。
Dataverse ロールベースのアクセス制御 (RBAC) に基づく 対応可能 対応可能 どちらのバージョンも Dataverse RBAC を使用し、親フロー セッション レコードからアクション ログ権限を継承します。

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

注意Note

監査がログ V2 でサポートされるまでは、フローログテーブルの詳細プロパティにあるデータへの変更の監査プロパティは選択解除してください。 この機能やその他の高度なテーブル設定の詳細については、こちらをご覧ください。

Dataverse ログ V2 のキャパシティ需要計算

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

アクション数 アクションごとのストレージ需要 (KB) 総ストレージ消費量 (MB)
1,000 3 2.93
10,000 3 29.3
30,000 3 87.9
60,000 3 175.8
100,000 3 293
160,000 3 480

重要

上記の表に示されている数値はあくまでも推定値であり、実際のストレージ消費量は大幅に異なる可能性があります。 正確なストレージ需要は、各アクション ログの具体的な詳細と複雑性によって異なります。 したがって、これらの数値は、潜在的なストレージ需要を理解し、それに応じてストレージ要件を計画するための大まかなガイドとして使用する必要があります。

ログ照会 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_9d51aa1f-315e-43ab-894f-bc445dfb049b'&
    @p4={"Keys":["@referencingParentId"],"Values":[{"Type":"System.Guid","Value":"9d51aa1f-315e-43ab-894f-bc445dfb049b"}]}&@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 で値が flowsessionid (GUID) のキーと値のペアを指定しています。

既知の制限

  • ログ V2 は、デスクトップ フロー コネクタ アクションを介してクラウド フローから起動されるデスクトップ フロー実行でのみ使用できます。
  • アクション ログのバージョンを変更しても、以前のデスクトップ フロー アクション ログは新しいログ ストレージ タイプに移行されません。
  • カスケード削除は現在サポートされていません。 フロー セッション レコードを削除しても、基礎となるログは自動的に削除されません。