この記事では、Power Platform 管理センターの環境の「機能」セクションおよび デスクトップ用 Power Automate にあるデスクトップ フロー ログの構成方法について解説します。これらは、特定のフローの詳細レベルを構成するためのものです。
注
この機能は、クラウド フローから起動されたデスクトップ フローと、デスクトップ用の Power Automate からのローカル参加済み実行の両方に適用されます。
実行アクション ログのアクティブ化ステータス 設定では、デスクトップ フロー実行アクション ログをいつキャプチャするかを定義し、ログを完全にオフにすることもできます。
| アクティブ化の状態 | Details |
|---|---|
| 有効 (既定) | このオプションは、システムが通常通りログを収集する既存および新規の環境の両方において、既定の設定となります。 |
| 実行時エラー | このオプションは、実行時エラーが発生した場合にのみ、デスクトップ フロー アクションのログを取得します。 この設定では、すべての実行についてログが記録されるわけではなく、エラーが発生した場合にのみログが記録されます。 ただし、エラーが発生した場合は、成功したアクションと失敗したアクションの両方を含め、その特定の実行に関するすべてのログが利用可能です。 |
| Disabled | このオプションを有効にすると、デスクトップ フローの実行アクション ログが無効になります。 |
Caution
これらの設定のいずれかを変更すると、実行失敗のトラブル シューティングや監査などの機能に重大な影響を及ぼす可能性があります。 続行する前に、これらの設定を変更した場合の影響を考慮してください。
前提条件
- Premium Power Automate ライセンスおよびログ設定を構成するための管理者権限
- Power Automate の URL と IP アドレスの構成
デスクトップ フローのアクションログバージョンを構成する
アクション ログのバージョン設定を使用して、V1、V2、またはその両方を選択してください。
| ログ バージョン | 説明 |
|---|---|
| V1 - FlowSession エンティティの AdditionalContext フィールドに格納されます | これは既定のオプションです。 ログは、Flow Session テーブルの AdditionalContext フィールドに保存されます。これは、Microsoft Dataverse 内で BLOB として保存されるファイル属性です。 ログ V1 は Dataverse ファイル キャパシティを消費します。 |
| V2 - FlowLogs エンティティに格納されます | このオプションを使用すると、Elastic Tables に保存されているフロー ログ テーブルにログを保存できます。 ログ V2 は、Dataverse ログ キャパシティを消費します。 |
| 両方 | この設定により、フロー セッション テーブルの従来 の AdditionalContext フィールドとフロー ログ テーブルの両方にログを保存できます。 この機能は、Dataverse のファイルとログの両方のキャパシティを消費します。 この設定は、Dataverse のログとファイル キャパシティの両方を消費するため、デバッグやテストを目的として使用することを想定しています。 |
FlowLogs エンティティの有効期限 (分) の値は、アクション ログが 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 (ゼロ) 分 |
Important
TTL (有効期限) の設定は、構成変更後に作成されたログ レコードにのみ適用されます。 既存のログ レコードは元の TTL 値を保持し、この設定のその後の変更による影響を受けません。
たとえば、当初ログの保存期間を 90 日に設定し、その後 7 日に短縮した場合でも、変更前に作成されたログは当初の 90 日間は引き続き保存されます。 変更後に作成された新しいログのみが、7 日間の保存期間を使用します。
既存のログを直ちに削除する必要がある場合は、手動で削除するか、元の TTL の有効期限が切れるまで待つ必要があります。
注
ログ V2 を有効にする前に、データ保持設定に対応し、キャパシティ計画および利用権限に合致する十分な Dataverse ログのキャパシティが確保されていることを確認してください。 必要に応じて調整します。 サイジングの例については、ログ V2 に関する Dataverse キャパシティ需要の計算例のセクションを参照してください。
デスクトップ フロー ログ V1 と V2 の主な違い
次の表は、デスクトップ フロー ログ V1 と V2 の違いを示しています。
| 特徴 | ログ V1 | ログ V2 | Details |
|---|---|---|---|
| 自動データ保持 | 該当なし | 在庫有り | V2 では、Azure Cosmos DB を基盤とする エラスティック テーブル を使用しており、データの自動保持を行うための TTL (有効期限) 機能が組み込まれています。 |
| 大きいログサイズに対応する | 約 50,000～80,000 件のアクションログ (最大) | 最小 100,000 件、生成されるアクションの数や実行期間によっては最大 1,000 万件まで増加する可能性があります | V2 は将来的には 1 回の実行につきギガバイト単位のアクションログまで拡張可能ですが、V1 はこの表で指定されている容量までしか拡張できません。 |
| 高度なレポートとガバナンスのサポート | 該当なし | 在庫有り | V1 では、AdditionalContext 属性はファイル タイプであり、Dataverse 内に Blob として格納されているため、レポート作成やガバナンス管理のための解析が困難です。 V2 ではログへのアクセスがさらに容易になりました。 |
| Azure Synapse Link による Dataverse 統合のサポート | 該当なし | 在庫有り | V1 では、AdditionalContext 属性はファイル タイプであり、Dataverse 内に Blob として格納されていますが、Azure Synapse への同期には対応していません。 |
| Dataverse 監査のサポート | 該当なし | 在庫有り | V1 では、AdditionalContext 属性はファイルタイプであり、Dataverse 内に Blob として格納されますが、Dataverse の監査機能ではサポートされていません。 |
| Dataverse の長期保存機能のサポート | 該当なし | 対応予定 | V1 では、AdditionalContext 属性はファイル タイプであり、Dataverse 内に Blob として格納されますが、これは Dataverse の長期リテンション機能ではサポートされていません。 |
| Dataverse ロールベースのアクセス制御 (RBAC) に基づく | 在庫有り | 在庫有り | どちらのバージョンも Dataverse RBAC を使用しており、親フロー セッション レコードからアクション ログの権限を継承しています。 |
Logs V2 は、以前のバージョンである V1 に比べて大幅に機能強化されています。 V2 は、アクション ログ シナリオなどの大量のデータを処理するのに適しており、データ保持 (TTL) が組み込まれた エラスティック テーブル 機能を使用します。 レポート作成、ガバナンス、自動データ保持管理との連携のために、大量のデータにアクセスする必要がある組織にとって理想的です。
ログに関する Dataverse のキャパシティ需要の計算 (V2)
次の表は、ログ V2 を使用した場合の、デスクトップ フローの実行 1 回あたりの 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 |
Important
Dataverse のログ ストレージ使用量はあくまで概算です。 実際のストレージ使用量は大きく異なる場合があります。 具体的なストレージの要件は、各アクションログの詳細や複雑さによって異なります。 これらの数値は、潜在的なストレージ需要を把握し、ストレージ要件を計画するための目安として使用してください。
アクション ログの詳細度
デスクトップ フロー ログ V2 では、詳細度レベルを設定して、可観測性とストレージ効率のバランスを調整できます。 各レベルは、フローの実行中にログに表示される詳細度を制御します。 このセクションでは、デスクトップ フローのアクション ログで利用可能な詳細度レベル、Power Platform 管理センターでの環境レベルでの構成方法 (管理者限定)、および個々のデスクトップ フローでの構成方法について説明します。
デスクトップ フローのアクション ログにおける詳細度レベル
| 冗長度レベル | 説明 | 含む | Notes |
|---|---|---|---|
| 完全 | 組み込みのシステム操作を含め、すべてのログを記録します。 | ステータス、ループ、その他のすべてのシステム生成ログ。 | 既定の設定。 最も包括的ですが、ストレージ容量がさらに必要たなる可能性があります。 |
| Debug | 行動の結果に焦点を合わせます。 | フロー内で実行された各アクションの出力と結果。 | システム全体のノイズを排除した状態で、詳細なトラブルシューティングに使用できます。 |
| カスタム | ユーザー定義のメッセージとすべての警告とエラーをログに記録します。 | ユーザーによる明示的な Log Message アクションとすべての警告とエラー。 |
ユーザーがログに記録される内容を制御できるようにします。 詳細表示レベルを微調整するために使用できます。 |
| Warnung | 警告およびエラーメッセージのみをキャプチャします。 | フローの実行中に発生したランタイムの警告やエラー。 | 騒音を低減しつつ、潜在的な問題点を明らかにする際に役立ちます。 |
| エラー | エラー メッセージのみを記録します。 | フローの実行を停止させたり、不正な動作を引き起こしたりする重大な不具合。 | パフォーマンス重視の環境向けの最小限のログ記録。 |
Power Platform 管理センターでアクションログの詳細レベルを構成する (管理者専用)
管理者は、環境全体の既定の詳細レベルを設定できます。 この設定は、フロー レベルで上書きされない限り、すべてのデスクトップ フローに適用されます。
Power Platform 管理センターにサインインします。
ナビゲーション ウィンドウで、[管理] を選択 します。
管理セクションで、環境を選択し、デスクトップ フローが実行されている環境を選択します。
[ 設定] を選択します。
製品を展開して、機能を選択します。
デスクトップ フローの実行ログ設定セクションで、アクション ログの詳細度設定を探してください。
既定のレベルを選択します: エラー、警告、カスタム、デバッグ、または完全。
[保存] を選択して構成を適用します。
特定のデスクトップ フローのアクション ログの詳細度を構成する
作成者は、Power Automate ポータルから各デスクトップ フローの詳細レベルを構成できます。 このローカル設定は、管理者の既定設定を上書きします。
必要に応じて環境設定を上書きします。
- 環境全体のログ量を増やすことなく、特定のデスクトップ フローをデバッグします。
- テストやトラブルシューティング中は、一時的にログの出力レベルを引き上げます。
特定のデスクトップ フローのアクション ログの詳細レベルを構成するには、以下の手順に従ってください。
- Power Automate にサインインします。
- 構成するデスクトップフローのフロー詳細ページを開きます。
- 編集を選択し、「アクション ログの詳細度」セクションを見つけます。
- この特定のフローについて、希望する詳細レベルを選択します。
Important
作成者が個々のデスクトップ フローの詳細レベルを変更する場合、その環境の既定値と同等かそれ以上の詳細レベルのみを選択できます。 たとえば、環境が「デバッグ」に構成されている場合、作成者は「カスタム」、「警告」、または「エラー」レベルを選択できません。
フローが個別に構成された後、管理者が環境の詳細レベルを変更した場合、生成されるログは常に、環境設定とデスクトップ フロー自身の設定のうち、より高い方の値に従います。
- 変更を保存。
注
Power Automate デスクトップ アプリ (PAD) から詳細度を構成することもできます。
データログ クエリ V2
Dataverse バックエンドに対して API 呼び出しを行うことで、デスクトップ フローのアクション ログデータにアクセスできます。 従来の API 呼び出し構文か、新しい ExecuteCosmosSqlQuery メソッドを使用できます。 この方法を使用すると、Dataverse に対して SQL クエリを実行でき、データの取得やフィルターが可能になります。
データ ログ モデル V2 は、フローセッション テーブルとフロー ログ テーブルの親子関係に基づいています。 すべてのレコードは、親フロー セッション レコードから権限を継承します。 特定のデスクトップ フローの実行に関するアクション ログを照会するには、次のクエリ構文を使用します。
従来の Dataverse API 呼び出し構文
次の API 呼び出しでは、ID (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb) によって特定のフローセッションを取得し、flowsession_flowlog_parentobjectid の関係性を通じて関連するアクション ログにアクセスします。
[Organization URI]/api/data/v9.0/flowsessions(aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb)/flowsession_flowlog_parentobjectid
FlowLogs テーブルを使用した新しい ExecuteCosmosSqlQuery API 呼び出し構文
[Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
QueryText=@p1,EntityLogicalName=@p2,QueryParameters=@p3,PageSize=@p4)?
@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: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
@p4: 50
エラスティック テーブル内の JSON 列のクエリ の詳細情報。
通話を個々のパーツに分解する
- ベース URL (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) は、Dataverse Web API のエンドポイントです。
-
ExecuteCosmosSqlQueryは、呼び出しているメソッドです。 このメソッドは、Dataverse に対して SQL クエリを実行します。 -
ExecuteCosmosSqlQueryメソッドのパラメーターは、メソッド名の後に括弧で囲んで指定します:-
QueryText=@p1: 実行する SQL クエリです。 このクエリは、タイプが 100000001 (デスクトップ フローのアクション ログ タイプ) であるテーブルからさまざまなプロパティを選択し、結果をstartTimeプロパティで降順に並べ替えます。 -
EntityLogicalName=@p2: アクションログを格納するテーブルの論理名 (flowlog) です。 -
QueryParameters=@p3: クエリのパラメーターを指定する JSON オブジェクトです。 前の例では、キーが@referencingParentIdおよび@referencingParentLogicalName、値がflowsessionid(GUID)、テーブルのタイプがflowsessionであるキーと値のペアが指定されています。 -
PageSize=p4: クエリのページ サイズです。
-
既知の制限
- ログ V2 は、ユーザーがクラウド フローからデスクトップ フロー コネクタ アクションを介して開始したデスクトップ フローの実行でのみ利用可能です。
- 一括削除ジョブは現在、フロー ログ テーブルではサポートされていません。
- Power Apps Maker Portal のテーブル セクションでは、現時点ではフロー ログのレコードを表示できません。
- アクション ログのバージョンを変更しても、以前のデスクトップ フロー アクション ログは新しいログ ストレージ タイプに移行されません。
- 行が追加、変更、または削除されたときのフロー トリガーのターゲットとして、FlowRun および FlowLog エンティティを使用しないでください。 これらのエンティティをターゲットとして使用すると、フローが実行されるたびにシステムがこれらのテーブルにレコードを作成するため、無限ループが発生する可能性があります。