更新履歴を表示し、データフローを監視する

データフローが期待通りに動作するように、更新状況を監視してください。 リフレッシュ履歴とモニタリングハブは、リフレッシュ中に何が起こるかの詳細を提供します。 この記事では利用可能な監視機能とその使い方について説明します。

更新履歴

更新履歴は、ワークスペースのドロップダウン メニューを使用して使用できます。 「最近の実行」ボタンを選択することでアクセスできます。

更新履歴が強調されたデータフロー ドロップダウン ボックスのスクリーンショット。

データフローの更新履歴を開くと、最初にすべてのデータ更新の一覧が表示されます。 この最初の画面には、次の情報が表示されます。

  • [開始時間]
  • 状態
  • 長さ
  • タイプ

[更新履歴] 画面のスクリーンショット。

履歴更新ページには最大50回の更新、または6ヶ月分の履歴が表示されます。 OneLakeは最大250件のリフレッシュ、つまり6か月分の履歴を保存します。 このページから新しいリフレッシュを開始したり、リフレッシュをスケジュールしたり、データフローを編集したりできます。

更新の CSV ファイルをダウンロードする

時には1回以上のリフレッシュにCSVファイルが必要なこともあります。 ファイルをダウンロードするには:

  1. データフローの最近の実行を開きます。

  2. CSV ファイルを取得する実行を選択します。

  3. CSV をダウンロードします。

    ダウンロード対象の特定の更新と、CSV としてダウンロードする選択を強調したスクリーンショット。

更新の詳細なログをダウンロードする

詳細なログにはPower Query Mashupエンジンからの診断情報が含まれています。 リフレッシュのトラブルシューティングや、Microsoftサポートに連絡する際の背景情報提供に使うと良いでしょう。 ログをダウンロードするには:

  1. データフローの最近の実行を開きます。

  2. 詳細なログを取得する実行を選びましょう。

  3. 詳細画面の左下にある [ 詳細ログのダウンロード ] ボタンを選択します。

    ダウンロードする特定の更新と、ダウンロードの詳細なログの選択を強調するスクリーンショット。

ZIPアーカイブには、選択したリフレッシュ用の複数のMashupエンジンログファイルが含まれています。 ログはリフレッシュ完了後数分で利用可能となり、最大28日間利用可能です。 ダウンロードするには少なくともワークスペース内のビューワーロールが必要です。

アーカイブの構成方法やJSON Linesレコードの解釈方法については、「 Understanding Dataflow Gen2」の詳細リフレッシュログをご覧ください。

ゲートウェイを使用して更新されるデータフローの詳細ログをダウンロードするには、ゲートウェイ レベルで Admin consent for gateway diagnostics 機能を有効にする必要があります。

UI からデータフローの更新を確認する

調査するデータフローを決定したら、[ 開始時刻 ] フィールドを選択して、更新の 1 つにドリルダウンできます。 この画面には、実行された更新に関する詳細情報が表示されます。 これには、更新に関する一般的な情報と、テーブルとアクティビティの一覧が含まれます。

更新履歴の概要を示すスクリーンショット。

簡単に言うと、この概要では次の情報が提供されます。

  • データフローの状態
  • 更新の種類
  • 開始時刻と終了時刻
  • 長さ
  • リクエスト ID
  • セッション ID
  • データフロー ID

[ テーブル] セクションには、データフローでの読み込みを有効にするすべてのエンティティが反映されます。 ここに示すテーブルが、データフローのステージング領域に読み込まれていることを意味します。 これらのテーブルは、Power BI、Excel、またはデータフローの Power Query Dataflow コネクタを使用してアクセスできるエンティティです。 一覧表示されているテーブル名のいずれかを選択して、この特定のテーブルの詳細を表示できます。 名前を選択すると、次の [詳細] 画面が表示されます。

特定のテーブルの詳細を示した [詳細] 画面のスクリーンショット。

[アクティビティ] セクションには、更新中に行われたすべてのアクション (出力先へのデータの読み込みなど) が反映されます。 このテーブルでは、特定のアクティビティの詳細について詳しく知ることもできます。 アクティビティの名前を選択すると、次の [詳細] 画面が表示されます。

特定のアクティビティの詳細を示した [詳細] 画面のスクリーンショット。

この画面では、アクティビティ中に何が起こったかをより明確に示します。 たとえば、出力先の場合、アクティビティ画面には次の情報が表示されます。

  • アクティビティの状態
  • 開始時刻と終了時刻
  • 長さ
  • アクティビティ統計情報:
    • 接続されたエンドポイント
      • コネクタによって処理されるボリューム
        • 読み取られたバイト数
        • 読み込まれた行数
        • 書き込まれたバイト数
        • 書き込まれた行数

何が起こったかを調査するには、アクティビティまたはテーブルを詳しく絞り込んでください。 次の画面には、更新とエラーに関する一般的な情報が表示されます。 アクティビティをドリルダウンする場合は、処理されて出力先に送信されたデータの量が表示されます。 一部のコネクタでは行数がレポートされ、バイト数に関するレポートもあります。 統計情報は、 アクティビティ 統計セクションに表示されます。

ワークスペースの状態

ワークスペースでは、ワークスペース内のすべてのデータフローの状態を確認できます。 この情報はワークスペースビューの ステータス 列で確認できます。 この列は、最後の更新状況と変更が保存・検証された最後の時刻を示します。 どちらかの行動が失敗すると、赤い感嘆符が表示されます。 故障の詳細を見るにはアイコンにカーソルを合わせてください。

状態列を示すワークスペース ビューのスクリーンショット。

更新に失敗した場合は、更新履歴に移動して、問題の原因を調査できます。 保存または検証アクションが失敗した場合は、データフロー エディターでデータフローを開いて問題を調査し、そこから検証を実行できます。

監視ハブ

監視ハブはサイド メニューを使用して使用できます。 [監視ハブ] ボタンを選択すると、アクセスできます。

[監視ハブ] ボタンのスクリーンショット。

監視ハブには、データフローの状態の概要を示すダッシュボードが用意されています。

[監視ハブ] ダッシュボードのスクリーンショット。

このダッシュボードには、次の情報が表示されます。

  • データフローの状態
  • 更新の開始時刻
  • リフレッシュ時間
  • 更新の送信者
  • ワークスペース名
  • データフローの更新に使用されるファブリック容量
  • 平均更新期間
  • 1 日あたりの更新回数
  • 更新の種類