Compartilhar via

Como gerenciar as configurações de telemetria para os comandos de código da CLI do Power Platform

Os comandos da CLI do PAC (Power Platform) code coletam telemetria limitada para ajudar a Microsoft a melhorar a confiabilidade, o desempenho e a usabilidade. Esta seção explica o que é coletado, como ele flui e como você pode controlá-lo.

Observação

Esta seção refere-se às configurações de telemetria para os comandos da CLI do Power Platform code, e não à telemetria coletada quando seu aplicativo de código é executado. Saiba mais sobre a CLI do Power Platform aqui: CLI do Microsoft Power Platform

Por que habilitar a telemetria?

Quando a telemetria está habilitada, a CLI do Power Platform envia as seguintes informações:

  • Eventos de atividade – ações de alto nível, como executar comandos ou concluir cenários (por exemplo, geração de arquivos de modelo e serviço, seleção de ambiente).
  • Eventos de erro – falhas e exceções (falhas de comando, erros inesperados), incluindo nomes de erro e mensagens.
  • Tempo de cenário – início e término de fluxos chave, com tempo decorrido para análise de desempenho.
  • Contexto de ambiente – metadados não PII sobre o ambiente e a região (por exemplo, região, geo, cluster), usados para rotear a telemetria corretamente.
  • Identificador de locatário (quando disponível) – se a CLI tiver sido autenticada com êxito, a ID do locatário atual será anexada para diagnóstico e agregação.

Observação

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

Alternância de telemetria

Os comandos PAC telemetry permitem que você gerencie as configurações de telemetria para todas as operações da CLI do PAC. Essas alterações são mantidas em todas as execuções.

code telemetria específica do comando

A partir da versão 1.51.1 do Power Platform CLI lançada em dezembro de 2025, você pode gerenciar a telemetria para os code comandos, sem afetar outros comandos da CLI PAC.

As configurações configuráveis pelo usuário são armazenadas em um userSettings.json arquivo JSON no diretório de configuração da CLI chamado .powerapps-cli.

O conteúdo do userSettings.json arquivo tem três propriedades:

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

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

Você pode criar esse 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

A finalidade dessas propriedades boolianas é descrita na tabela a seguir:

Propriedade Description
enabled Se a telemetria remota está habilitada.
consoleOnly Se deseja registrar apenas a telemetria no console e nunca enviá-la remotamente.
outputToConsole Se os eventos de telemetria devem ser espelhados adicionalmente no console.

Observação

Se você tiver desabilitado a telemetria globalmente para a PAC CLI usando os comandos PACtelemetry, o code comando não enviará telemetria, mesmo se você habilitá-la para o code comando.

As seções a seguir descrevem combinações válidas de valores e seus resultados:

Telemetria habilitada, somente remota (padrão)

Se nenhum userSettings.json arquivo existir, esse será o comportamento. Nenhuma telemetria é impressa 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 + console

Os eventos são enviados remotamente. Os mesmos eventos também são impressos localmente.

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

Telemetria somente para console (sem envio remoto)

Quando consoleOnly é verdadeiro, somente o registro em log do console é usado. Nenhuma telemetria é enviada externamente, tudo permanece em seu terminal.

{
  "enabled": false,
  "consoleOnly": true,
  "outputToConsole": false
}
  • enabled é efetivamente ignorado para o envio remoto.
  • outputToConsole não é necessário; O log do console está implícito.

Redirecionando telemetria para um arquivo

Quando a telemetria é configurada para saída para o console (usando consoleOnly: true ou outputToConsole: true), você pode redirecionar a saída para um arquivo. Isso é particularmente útil para capturar logs para solicitações de depuração ou suporte.

Prompt de Comando do Windows

Use o operador > para redirecionar stdout e 2>&1 para incluir stderr, se necessário.

pac code add-data-source .... > telemetry.log 2>&1

PowerShell (Windows, macOS, Linux)

Use o cmdlet Out-File ou operadores de redirecionamento.

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