Compartir vía

Cómo: Administrar la configuración de telemetría para los comandos de código de la CLI de Power Platform

Los comandos de la CLI de Power Platform (PAC CLI) code recopilan telemetría limitada para ayudar a Microsoft a mejorar la confiabilidad, el rendimiento y la facilidad de uso. En esta sección se explica lo que se recopila, cómo fluye y cómo puede controlarlo.

Nota:

En esta sección se hace referencia a la configuración de telemetría de los comandos de la CLI de Power Platformcode, y no a la telemetría recopilada cuando se ejecuta una aplicación de código. Obtenga más información sobre la CLI de Power Platform aquí: CLI de Microsoft Power Platform

¿Por qué habilitar la telemetría?

Cuando la telemetría está habilitada, la CLI de Power Platform envía la siguiente información:

  • Eventos de actividad : acciones de alto nivel, como comandos en ejecución o escenarios de finalización (por ejemplo, generación de archivos de modelo y servicio, selección de entorno).
  • Eventos de error : errores y excepciones (errores de comando, errores inesperados), incluidos los nombres de error y los mensajes.
  • Tiempo de escenario: inicio y detención de flujos clave, con tiempo transcurrido para el análisis de rendimiento.
  • Contexto del entorno : metadatos que no son de PII sobre el entorno y la región (por ejemplo, región, geo, clúster), que se usan para enrutar la telemetría correctamente.
  • Identificador de inquilino (cuando está disponible): si la CLI se ha autenticado correctamente, el identificador de inquilino actual se adjunta para diagnósticos y agregaciones.

Nota:

Los errores de telemetría nunca bloquean las operaciones de la CLI.

Alternar la telemetría

Los comandos PAC telemetry permiten administrar la configuración de telemetría para todas las operaciones de la CLI de PAC. Estos cambios se conservan entre ejecuciones.

code telemetría específica del comando

A partir de la versión 1.51.1 de la CLI de Power Platform publicada en diciembre de 2025, puede administrar la telemetría de los comandos code, sin afectar a otros comandos de la CLI de Power Platform.

La configuración configurable por el usuario se almacena en un userSettings.json archivo JSON en el directorio de configuración de la CLI denominado .powerapps-cli.

El contenido del userSettings.json archivo tiene tres propiedades:

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

La .powerapps-cli carpeta se encuentra en la ubicación designada por la variable de USERPROFILE entorno.

Puede crear este archivo manualmente o usar el siguiente script de 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

El propósito de estas propiedades booleanas se describe en la tabla siguiente:

Propiedad Description
enabled Indica si la telemetría remota está habilitada.
consoleOnly Si solo se registra la telemetría en la consola y nunca se envía de forma remota.
outputToConsole Si se deben reflejar además los eventos de telemetría en la consola.

Nota:

Si ha deshabilitado la telemetría globalmente para la CLI de PAC mediante los comandos PACtelemetry, el code comando no enviará telemetría, aunque la habilite para el code comando.

En las secciones siguientes se describen combinaciones válidas de valores y sus resultados:

Telemetría habilitada, solo remota (valor predeterminado)

Si no existe ningún userSettings.json archivo, este es el comportamiento. No se imprime telemetría en la consola.

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

Telemetría totalmente deshabilitada

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

Establezca outputToConsole a true si desea ver eventos.

Telemetría habilitada, remota + consola

Los eventos se envían de forma remota. Los mismos eventos se imprimen también localmente.

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

Telemetría solo de consola (sin envío remoto)

Cuando consoleOnly es verdadero, solo se usa el registro en la consola. No se envía telemetría externamente, todo permanece en el terminal.

{
  "enabled": false,
  "consoleOnly": true,
  "outputToConsole": false
}
  • enabled se ignora efectivamente para el envío remoto.
  • outputToConsole no es obligatorio; el registro en la consola está implícito.

Redirigir telemetría a un archivo

Cuando la telemetría está configurada para mostrar la salida en la consola (mediante consoleOnly: true o outputToConsole: true), puede redirigir la salida a un archivo. Esto es especialmente útil para capturar registros para la depuración o las solicitudes de soporte técnico.

Símbolo del sistema de Windows

Usar el operador > para redirigir stdout y 2>&1 e incluir stderr si es necesario.

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

PowerShell (Windows, macOS, Linux)

Utilice el cmdlet Out-File o los operadores de redireccionamiento.

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