Power Apps CLI のテレメトリ設定を管理する

この記事では、現在の状態を表示したり、収集を有効または無効にしたり、デバッグまたはサポート用にコンソール出力を構成したりできるように、Power Apps CLI テレメトリ設定を管理する方法について説明します。

テレメトリを有効にする理由

テレメトリが有効になっている場合、CLI は次の情報を収集できます。

テレメトリ データ 説明
アクティビティ イベント コマンドの実行やシナリオの完了など、高度なアクション。
エラー イベント エラー名とメッセージを含むエラーと例外。
シナリオのタイミング 主要な操作の開始イベントと停止イベント、およびその経過時間。
環境コンテキスト 環境とリージョンに関する個人を特定できないメタデータ。
テナント識別子 CLI が認証されたときの現在のテナント ID。

Note

テレメトリエラーによって CLI 操作がブロックされることはありません。

CLI コマンドを使用してテレメトリを管理する

テレメトリを管理するには、次のコマンドを使用します。

命令 説明
pa telemetry enable テレメトリ収集を有効にします。
pa telemetry disable テレメトリ収集を無効にします。
pa telemetry status 現在のテレメトリ設定を表示します。

例えば次が挙げられます。

pa telemetry disable
pa telemetry status

これらの設定は、CLI の実行間で保持されます。

コンソール出力を構成する

CLI は、ユーザーが構成可能な設定をuserSettings.json.powerapps-cli構成ディレクトリに格納します。

.powerapps-cli フォルダーは、USERPROFILE環境変数によって指定された場所にあります。

ファイルは手動で作成することも、次の PowerShell スクリプトを使用することもできます。

$settingsPath = Join-Path $env:USERPROFILE ".powerapps-cli\userSettings.json"
$settingsDir = Split-Path $settingsPath
if (-not (Test-Path $settingsDir)) { New-Item -ItemType Directory -Path $settingsDir -Force }
$settings = @{
    enabled = $true
    consoleOnly = $false
    outputToConsole = $false
}
$settings | ConvertTo-Json | Set-Content $settingsPath

このファイルでは、次のプロパティがサポートされています。

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": false
}
プロパティ 説明
enabled リモート テレメトリが有効かどうかを示します。
consoleOnly テレメトリをコンソールにのみ書き込み、リモートで送信しません。
outputToConsole リモートから送信されたテレメトリ イベントをコンソールにミラーリングします。

テレメトリが有効、リモートのみ (既定)

ファイルが存在しない場合、リモート テレメトリは有効になり、テレメトリはコンソールに書き込まれません。

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": false
}

テレメトリが完全に無効

{
  "enabled": false,
  "consoleOnly": false,
  "outputToConsole": false
}

イベントを表示する場合は、 outputToConsole を true に設定します。

テレメトリの有効化、リモート、コンソール

システムはイベントをリモートで送信し、ローカルに出力します。

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": true
}

コンソールのみのテレメトリ (リモート送信なし)

リモートで送信せずにコンソールにテレメトリを書き込むには、次を使用します。

{
  "enabled": false,
  "consoleOnly": true,
  "outputToConsole": false
}
  • enabled は、リモート送信では事実上無視されます。
  • outputToConsole コンソールのログ記録が暗黙的に行われるため、必須ではありません。

パイプ テレメトリをファイルに送信する

コンソール出力が有効になっている場合は、デバッグやサポートのために pa app add data-source などのコマンドからファイルに出力をリダイレクトできます。

Windows コマンド プロンプト

pa app add data-source ... > telemetry.log 2>&1

PowerShell (Windows、macOS、Linux)

pa app add data-source ... | Out-File -FilePath telemetry.log -Encoding utf8
  • Last updated on