Справочник по команде agent 365 CLI logs

Управление логами диагностики CLI. Команда logs экспортирует отредактированные копии файлов журналов CLI, которые безопасно обмениваются с Microsoft поддержкой. Используйте logs export подкоманду для редактирования и копирования файлов журналов CLI. Экспортированные файлы можно безопасно прикреплять к заявке поддержки без утечки писем, GUID или токенов.

Минимальная требуемая роль: нет. Команда читает и перезаписывает только локальные файлы журналов.

Syntax

a365 logs [command] [options]

logs export

Экспортируйте отредактированную копию диагностического журнала CLI, которую можно безопасно поделиться с поддержкой Microsoft. Редактирует токены JWT, адреса электронной почты, GUID и имена пользователей пути ОС, а также заменяет идентичные значения на последовательные псевдонимы для сохранения корреляции журналов.

a365 logs export [<command>] [options]

CLI записывает диагностический файл журнала для каждой команды верхнего уровня в ваш локальный каталог логов (например, %LOCALAPPDATA%\Microsoft.Agents.A365.DevTools.Cli\logs\ на Windows). logs export Читает один или все эти файлы, удаляет чувствительный контент и записывает отредактированные копии в выбранную вами папку вывода.

Что редактируется

Pattern	Replacement
Токены носителя JWT (header.payload.signature)	<JWT-TOKEN>
Email addresses	<email-1>, <email-2>, ... (похожие псевдонимы по электронной почте)
GUID (8-4-4-4-12) — см. Что сохраняется для исключений	<id-1>, <id-2>, ... (постоянные псевдонимы по GUID)
Имена пользователей по пути ОС (C:\Users\<name>, /Users/<name>, /home/<name>)	<username-1>, , <username-2>...

Идентичные значения сохраняют одинаковый псевдоним по всему файлу, поэтому перекрёстные ссылки в журнале остаются полезными для диагностики проблем. Отредактированный файл содержит заголовок, который записывает исходный путь (с теми же редактированием) и счёт каждого заменённого шаблона.

What's preserved

Редактёр намеренно keeps следующий контент дословно чтобы отредактированный журнал оставался полезен для отладки и для эскалации Microsoft поддержки:

Preserved	Почему это безопасно
Временные метки, уровни журналов, имена областей действия, коды ошибок, пути к файлам (с заменой имён пользователей), коды статуса HTTP, JSON-фигуры	Ни одна из них не идентифицирует арендатора или пользователя.
TraceId: <guid> и CorrelationId: <guid> ценности	Локальные случайные идентификаторы сессии, генерируемые CLI. Они не чувствительны и связывают лог с трассами на стороне сервера.
request-id и client-request-id внутри Microsoft Graph ошибочных тел	Сервер генерируется за один вызов. Поддержка Microsoft использует их для поиска точного запроса в сервисных журналах при эскалации.
Публичные, хорошо известные идентификаторы ресурсных приложений Microsoft и Agent 365: * Microsoft Graph (00000003-0000-0000-c000-000000000000) * API бота для обмена сообщениями агента 365 * API наблюдаемости агента 365 * Power Platform API (Подключение) * Agent 365 Tools (аудитория MCP, продакшн)	Это задокументированные публичные константы — они ничего не раскрывают о вашем арендаторе. Сохранение их означает, что строка вроде Validated permission AgentIdentityBlueprint.ReadWrite.All against 00000003-0000-0000-c000-000000000000 остаётся читаемой, а не становится ... against <id-4>.

Специфические идентификаторы объектов главного сервиса и любые другие GUID, не соответствующие вышеуказанным шаблонам , всё равно редактируются через механизм согласованного алиаса.

Important

Шаблоны редактирования предназначены для удаления наиболее распространённого чувствительного контента. Если ваши логи содержат пользовательские секреты (например, секреты, зарегистрированные по коду вне этого CLI, или значения, вставленные в трассы стека) в форматах, которые этот редактёр не распознаёт, удалите их вручную перед тем, как делиться.

Как проверить перед тем, как поделиться

Откройте отредактированный файл в текстовом редакторе и отсканируйте на наличие всего, что похоже на специфичность арендатора:

# 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

Строка заголовка экспортируемого файла суммирует количество подсчёта. Если вы видите большее количество <id-N> псевдонимов, чем вы ожидаете, карта алиасов выполняет свою задачу — каждый GUID для конкретного арендатора получает ровно один алиас.

export варианты

Option	Description
<command>	Название команды, лог которой вы хотите экспортировать (например setup , или cleanup). Опустите этот аргумент для экспорта всех доступных файлов журналов за один запуск.
-o, --output <output>	Каталог для записи отредактированного файла журнала или файлов. По умолчанию отображается текущий каталог.
-?, -h, --help	Показать справку и информацию об использовании.

Examples

Экспортировать setup журнал в текущий каталог:

a365 logs export setup

Экспортируйте все доступные журналы в определённую папку:

a365 logs export --output ./support-bundle

Экспортируйте cleanup журнал в определённую папку:

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

Имя выходных файлов

Экспортированный файл записывается как a365.<command>.redacted.log. Если вы его опускаете <command>, CLI экспортирует каждый доступный лог в отдельный отредактированный файл с тем же шаблоном именования.

Important

Просмотрите отредактированный файл перед тем, как делиться им. Шаблоны редактирования охватывают токены JWT, электронные письма, GUID и имена пользователей пути ОС, но не охватывают все возможные секреты. Если в вашем журнале есть пользовательские секреты или чувствительные идентификаторы в других форматах, удаляйте их вручную перед публикацией.

Note

logs export не удаляет и не изменяет исходные файлы журнала. Оригинальные логи остаются в вашем локальном каталоге логов. Команда записывает только отредактированные копии в каталог вывода.