Gerenciar configurações de telemetria para a CLI do Power Apps

Este artigo explica como gerenciar as configurações de telemetria da CLI do Power Apps para que você possa visualizar o status atual, habilitar ou desabilitar a coleta e configurar a saída do console para depuração ou suporte.

Por que habilitar a telemetria?

Quando a telemetria está habilitada, a CLI pode coletar:

Dados de telemetria Description
Eventos de atividade Ações de alto nível, como executar comandos ou concluir cenários.
Eventos de erro Falhas e exceções, incluindo nomes de erro e mensagens.
Temporização do cenário Eventos de início e parada para operações principais e seu tempo decorrido.
Contexto de ambiente Metadados não identificáveis pessoalmente sobre o ambiente e a região.
Identificador de locatário A ID do locatário atual quando a CLI é autenticada.

Note

Falhas de telemetria nunca bloqueiam operações da CLI.

Gerenciar a telemetria com comandos da CLI

Use os seguintes comandos para gerenciar a telemetria:

Command Description
pa telemetry enable Habilite a coleção de telemetria.
pa telemetry disable Desabilite a coleção de telemetria.
pa telemetry status Exiba as configurações de telemetria atuais.

Por exemplo:

pa telemetry disable
pa telemetry status

Essas configurações persistem em execuções da CLI.

Configurar a saída do console

A CLI armazena configurações definidas pelo usuário em .powerapps-cli no diretório de configuração userSettings.json.

A .powerapps-cli pasta está localizada no local designado pela variável de USERPROFILE ambiente.

Você pode criar o arquivo manualmente ou usar o seguinte script do 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

O arquivo dá suporte às seguintes propriedades:

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": false
}
Propriedade Description
enabled Indica se a telemetria remota está habilitada.
consoleOnly Grava a telemetria apenas no console e não a envia remotamente.
outputToConsole Espelha eventos de telemetria enviados remotamente para o console.

Telemetria habilitada, somente remota (padrão)

Se o arquivo não existir, a telemetria remota estará habilitada e a telemetria não será gravada no console.

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

Telemetria totalmente desabilitada

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

Defina outputToConsole como true se você ainda quiser ver eventos.

Telemetria habilitada, remota e console

O sistema envia eventos remotamente e os imprime localmente.

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

Telemetria somente para console (sem envio remoto)

Para gravar a telemetria para o console sem enviá-la remotamente, use:

{
  "enabled": false,
  "consoleOnly": true,
  "outputToConsole": false
}
  • enabled é efetivamente ignorado para o envio remoto.
  • outputToConsole não é necessário porque o registro no console já está implícito.

Direcionar a telemetria para um arquivo

Quando a saída do console está habilitada, você pode redirecionar a saída de um comando, como pa app add data-source para um arquivo para depuração ou suporte.

Prompt de Comando do 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