仮想ネットワーク (VNet) データ ゲートウェイのログをダウンロード

仮想ネットワーク データ ゲートウェイの診断ログは、[ 接続とゲートウェイの管理 ] ページからダウンロードできます。 次のセクションでは、各ログの種類、その保持期間とファイル形式、およびフィールドの解釈方法について説明します。

Note

  • ログをダウンロードするには、仮想ネットワーク データ ゲートウェイの管理者である必要があります。 管理者かどうかを判断するには、[ ユーザーの管理 ] オプションをオンにします。
  • ログの保持期間は固定されており、変更することはできません。
  • ログを生成するには、ゲートウェイがオンラインで実行されている必要があります。 以前に収集したログは、ゲートウェイがオフラインの間、保有期間内にダウンロードできます。 [状態] 列のアイコンを選択して、仮想ネットワークの状態を確認します。
  • テナントで Fabric プライベート リンクが有効になっている場合、ダウンロードは使用できません。
  • ダウンロードが表示されない場合は、ブラウザーでポップアップが無効になっていないことを確認してください。
  • この機能は、特定のリージョンおよび米国政府バージニアリージョンでは使用できません。

ログをダウンロードする方法

  1. Power BI サービスのページ ヘッダーから、[設定] アイコンを選択し、[接続とゲートウェイの管理] を選びます。

  2. [仮想ネットワーク データ ゲートウェイ] タブを選択します。

  3. 仮想ネットワーク データ ゲートウェイを見つけ、同じ行でダウンロード アイコンを選択します。

    診断ダウンロード アイコンを示す [接続とゲートウェイの管理] ページのスクリーンショット

  4. ポップアップ ウィンドウで、必要な特定のログ カテゴリを選択するか、使用可能なすべてのログを選択できます。 さらに、定義済みの時間範囲を選択したり、ニーズに合わせて時間範囲をカスタマイズしたりできます。

    ログ カテゴリと時間範囲を選択する [診断のダウンロード] ダイアログのスクリーンショット

  5. [診断のダウンロード] ボタンを選択し、ダウンロードしたフォルダーのログを表示します。

SystemCounters

システム カウンターは、個々のゲートウェイ インスタンスの CPU とメモリの測定値を提供します。

  • 保有期間: 29 日
  • 形式: Parquet
属性 説明
タイムスタンプ カウンターが出力された時刻。
ID 測定を報告したゲートウェイ インスタンス (ノード) の一意識別子。
コミットされたメモリ（MB単位） VNetごとに予約された合計8 GBのRAMのうち、使用されたメモリ。
CPU使用率 使用中のCPU
MemoryAvailableinMB 利用可能なメモリ。

MashupLogs

マッシュアップ ログには、Power Query エンジンによって実行されたアクションに関する詳細情報が含まれています。 これらのログを使用して、クエリの実行を調査し、エラーのトラブルシューティングを行います。

  • 保持期間: 48 時間
  • 形式: JSONL
属性 説明
開始 アクションの開始。
アクション アクション名。
製品バージョン マッシュアップのバージョン。
活動ID アクティビティ識別子。
CorrelationId 関連付け識別子。
プロセス プロセス名。
PID プロセス識別子。
ティッド スレッド識別子。
期間 作用時間。

クエリー実行レポート

クエリ実行レポートは、ゲートウェイによって処理された個々のクエリに関する情報 (状態や実行タイミングなど) を提供します。 これらのレポートを使用して、低速または失敗したクエリを調査し、それらを処理したゲートウェイ インスタンスを特定します。

  • 保有期間: 29 日
  • 形式: Parquet
属性 説明
ID ログ識別子。
タイムスタンプ クエリ実行の開始。
QueryId クエリ識別子。
インスタンスID 診断レコードを報告したゲートウェイ インスタンス (ノード) の一意識別子。
RequestId (リクエストID) リクエスト識別子。
クエリの種類 DirectQuery や、セマンティック モデルやデータフローの更新を含むデータ更新操作などのクエリの種類。
接続パス データ ソースの種類とパス。
ステータス クエリが失敗したか成功したかを示します。
開始時間 クエリ実行の開始。
DurationMS（持続時間ミリ秒） クエリの実行時間 (ミリ秒単位)。
実行開始時刻 クエリ実行の開始。
実行時間MS クエリの実行時間（ミリ秒）。
データ読み取りおよびシリアル化開始時刻 データのシリアル化の開始。
データ読み取りとシリアル化の持続時間MS データのシリアル化の所要時間。
StreamingDurationMS（ストリーミング持続時間MS） データ ストリーミングの期間。

ResourceConsumption

リソース消費ログには、ゲートウェイに起因する容量使用量が記録されます。 これらのログを使用して、時間の経過に伴う消費量を調べ、関連するFabric容量を特定します。

  • 保有期間: 29 日
  • 形式: Parquet
属性 説明
キャパシティID 課金される容量の ID。
容量単位秒 (CapacityUnitSeconds) CapacityUnitSeconds として出力される容量消費量。
GatewayId ゲートウェイ クラスター識別子。
ゲートウェイ名 ゲートウェイ クラスターの名前。
ID ログ識別子。
タイムスタンプ 時間消費量が出力されました。

PipelineExecutionReport と CopyJobExecutionReport

これらのレポートは、パイプライン アクティビティに関する情報を提供し、ゲートウェイが処理するコピー ジョブ タスクに関する情報を提供します。 これらのレポートでは、ゲートウェイ側のアクティビティの実行について説明します。 パイプライン全体やコピー ジョブのエンド ツー エンド期間が必ずしも記述されているわけではありません。 これらを使用して、キューイング、実行時間、状態、およびエラーを調査します。

  • 保有期間: 29 日
  • 形式: Parquet
属性 説明
Id 診断レポートの一意識別子。
Timestamp ゲートウェイがレポートを生成する時刻 (UTC)。
InstanceId 診断レコードを報告するゲートウェイ インスタンス (ノード) の一意識別子。
RequestId 要求に関連付けられている識別子。
ArtifactType 実行に関連付けられている成果物の種類。
TaskId 実行タスクの識別子。
WorkspaceId 利用可能な場合、関連付けられているワークスペースの識別子
PipelineRunId 関連付けられているパイプライン実行の識別子 (使用可能な場合)。
PipelineName 関連付けられているパイプラインの名前（利用可能な場合）。
ActivityRunId アクティビティの実行の識別子。
ActivityType アクティビティの種類。
QueueTime 報告されたキュー待機時間（秒）
Status 報告された実行状態。
ExecutionStartTime 実行の開始時刻 (UTC)。
ExecutionDurationMS 実行時間 (ミリ秒単位)。
ErrorCode 実行に関連付けられているエラー コード (使用可能な場合)。

InstanceLoad

インスタンスの負荷診断では、ゲートウェイ インスタンスごとのワークロード測定が提供されます。これには、自動スケールで使用される負荷シグナル、キューに登録された評価と実行中の評価の平均、パイプライン アクティビティが含まれます。 これらのログを使用して、キューイングとワークロードの需要を調べ、負荷を過去のインスタンス数の傾向と関連付けます。

  • 保有期間: 29 日
  • 形式: Parquet
属性 説明
Timestamp 負荷レポートが生成された時刻 (UTC)。
Id 測定値を報告したゲートウェイ インスタンス (ノード) の一意識別子。
AggregateLoadPercent 評価の需要とパイプライン アクティビティに基づいて、ゲートウェイ インスタンスに対して自動スケールで使用される全体的な負荷シグナル。
DefaultPoolLoadPercent 既定のプールの平均評価負荷 (キューに入っている評価や実行中の評価を含む) は、プールの容量に対する割合で表されます。
DefaultPoolAveragePendingCount 既定のプールでの実行を待機している評価の平均数。
DefaultPoolAverageRunningCount 既定のプールで実行されている評価の平均数。
DirectQueryPoolLoadPercent DirectQuery プールの平均評価負荷 (キューに入っている評価や実行中の評価を含む) は、プールの容量に対する割合で表されます。
DirectQueryPoolAveragePendingCount DirectQuery プールでの実行を待機している評価の平均数。
DirectQueryPoolAverageRunningCount DirectQuery プールで実行されている評価の平均数。
PipelinePoolActive パイプライン プールがアクティブな作業を報告したかどうか。 この値は、使用率ではなくブール値のアクティビティ指標です。

インスタンスカウントの履歴の傾向を理解するには、レコードを時間間隔にグループ化し、各間隔内の個別の Id 値をカウントします。 このメソッドは、各間隔でログを報告したインスタンスの数を示します。同時に実行されていたインスタンス数を必ずしも示すわけではありません。

  • 最終更新: