Referencia de comandos de la CLI logs del agente 365

Gestiona los registros diagnósticos de la CLI. El comando logs exporta copias redactadas de archivos de registro CLI que son seguras para compartir con Microsoft soporte. Usa el logs export subcomando para tachar y copiar archivos de registro de CLI. Los archivos exportados son seguros para adjuntar a un ticket de soporte sin filtrar correos electrónicos, GUIDs o tokens.

Rol mínimo requerido: Ninguno. El comando solo lee y reescribe archivos de registro locales.

Syntax

a365 logs [command] [options]

logs export

Exporta una copia redactada de un archivo de registro de diagnóstico de CLI que sea seguro para compartir con el soporte de Microsoft. Redacta tokens JWT, direcciones de correo electrónico, GUIDs y nombres de usuario de rutas del sistema operativo, y reemplaza valores idénticos por alias consistentes para preservar la correlación de los registros.

a365 logs export [<command>] [options]

La CLI escribe un archivo de registro de diagnóstico para cada comando de nivel superior en tu directorio local de registros (por ejemplo, %LOCALAPPDATA%\Microsoft.Agents.A365.DevTools.Cli\logs\ en Windows). logs export Lee uno o todos esos archivos, elimina contenido sensible y escribe las copias redactadas en el directorio de salida que elijas.

Lo que se tacha

Pattern	Replacement
Tokens portadores JWT (cabecera.payload.signature)	<JWT-TOKEN>
Email addresses	<email-1>, <email-2>, ... (alias consistentes por correo electrónico)
GUIDs (8-4-4-4-4-12) — véase Qué se conserva para excepciones	<id-1>, <id-2>, ... (alias consistentes según la GUID)
Nombres de usuario de la ruta del sistema operativo (C:\Users\<name>, /Users/<name>, /home/<name>)	<username-1>, , <username-2>...

Valores idénticos mantienen el mismo alias en todo el archivo, por lo que las referencias cruzadas en el registro siguen siendo útiles para diagnosticar problemas. El archivo redactado incluye una cabecera que registra la ruta de origen (con las mismas redacciones aplicadas) y los conteos de cada patrón que se ha reemplazado.

What's preserved

El redactor intencionadamente mantén el siguiente contenido literalmente, por lo que el registro redactado sigue siendo útil para depurar y para Microsoft escalada de soporte:

Preserved	Por qué es seguro
Marcas de tiempo, niveles de registro, nombres de ámbito, códigos de error, rutas de archivos (con nombres de usuario sustituidos), códigos de estado HTTP, formas JSON	Ninguna de estas identifica a un inquilino o usuario.
TraceId: <guid> y CorrelationId: <guid> valores	Identificadores aleatorios locales de sesión generados por la CLI. No son sensibles y son las que emparejan el registro con las trazas del lado del servidor.
request-id y client-request-id dentro de Microsoft Graph cuerpos de error	Generado por servidor por llamada. El soporte de Microsoft utiliza estos datos para buscar la solicitud exacta en los registros de servicio cuando escalas.
IDs de aplicaciones de recursos públicos y conocidos de Microsoft y Agent 365: • Microsoft Graph (00000003-0000-0000-c000-000000000000) • API de bots de mensajería Agent 365 • API de observabilidad Agent 365 • API de Power Platform (conectividad) • Agent 365 Tools (audiencia MCP, producción)	Estas son constantes públicas documentadas: no revelan nada sobre tu inquilino. Preservarlas significa que una línea como Validated permission AgentIdentityBlueprint.ReadWrite.All against 00000003-0000-0000-c000-000000000000 permanece legible en lugar de convertirse ... against <id-4>en .

Los IDs de objetos principales de servicio específicos de inquilino y cualquier otro GUID que no coincida con los patrones anteriores siguen siendo tachados mediante el mecanismo de alias consistentes.

Important

Los patrones de redacción están diseñados para eliminar el contenido sensible más común. Si tus registros contienen secretos personalizados (por ejemplo, secretos registrados por código fuera de esta línea de usuario o valores pegados en las pilas de trazas) en formatos que este redactor no reconoce, elimínalos manualmente antes de compartirlos.

Cómo verificar antes de compartir

Abre el archivo redactado en un editor de texto y busca cualquier cosa que parezca específica del inquilino:

# Spot-check what was preserved vs aliased
Select-String -Path .\a365.setup.redacted.log -Pattern "CorrelationId|TraceId|request-id" | Select-Object -First 10
Select-String -Path .\a365.setup.redacted.log -Pattern "<id-|<email-|<JWT-TOKEN>|<username-" | Measure-Object

La cabecera del archivo exportado resume los conteos. Si ves un número mayor de <id-N> alias de lo que esperabas, el mapa de alias está cumpliendo su función — cada GUID específico de inquilino recibe exactamente un alias.

export Opciones

Option	Description
<command>	Nombre del comando cuyo registro quieres exportar (como setup o cleanup). Omite este argumento para exportar todos los archivos de registro disponibles en una sola ejecución.
-o, --output <output>	Directorio para escribir el archivo o archivos de registro redactados. Por defecto se usa el directorio actual.
-?, -h, --help	Mostrar información de ayuda y uso.

Examples

Exporta el setup registro al directorio actual:

a365 logs export setup

Exporta cada registro disponible a una carpeta específica:

a365 logs export --output ./support-bundle

Exporta el cleanup registro a una carpeta específica:

a365 logs export cleanup --output ./support-bundle

Nombres de archivos de salida

El archivo exportado se escribe como a365.<command>.redacted.log. Cuando omites <command>, la CLI exporta cada inicio de sesión disponible en su propio archivo tachado con el mismo patrón de nombres.

Important

Revisa el archivo redactado antes de compartirlo. Los patrones de redacción cubren tokens JWT, correos electrónicos, GUIDs y nombres de usuario de rutas del sistema operativo, pero no cubren todos los secretos posibles. Si tu registro contiene secretos personalizados o identificadores sensibles en otros formatos, elimínalos manualmente antes de compartirlos.

Note

logs export no elimina ni modifica los archivos de registro originales. Los registros originales permanecen en tu directorio local de registros. El comando solo escribe copias redactadas en el directorio de salida.