Compartir a través de

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) 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 Platform, 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í: Microsoft Power Platform CLI

¿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 permiten administrar la configuración de telemetría para todas las operaciones de la CLI de PAC. Estos cambios se conservan entre ejecuciones.

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 , sin afectar a otros comandos de la CLI de Power Platform.

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

El contenido del archivo tiene tres propiedades:

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

La carpeta se encuentra en la ubicación designada por la variable de 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 PAC, el comando no enviará telemetría, aunque la habilite para el 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 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 a 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 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
}
  • se ignora efectivamente para el envío remoto.
  • 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 o ), 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 y e incluir si es necesario.

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

PowerShell (Windows, macOS, Linux)

Utilice el cmdlet o los operadores de redireccionamiento.

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