Kommandoreferanse for Agent 365 CLI logs

Håndter CLI-diagnostiske logger. Kommandoen logs eksporterer redigerte kopier av CLI-loggfiler som er trygge å dele med Microsoft support. Bruk underkommandoen logs export for å redigere og kopiere CLI-loggfiler. De eksporterte filene er trygge å legge ved en supportsak uten å lekke e-poster, GUID-er eller tokens.

Minimum rolle kreves: Ingen. Kommandoen leser og omskriver kun lokale loggfiler.

Syntax

a365 logs [command] [options]

logs export

Eksporter en redigert kopi av en CLI-diagnostisk loggfil som er trygg å dele med Microsoft support. Redigerer JWT-tokens, e-postadresser, GUID-er og OS-stibrukernavn, og erstatter identiske verdier med konsistente aliaser slik at loggkorrelasjon bevares.

a365 logs export [<command>] [options]

CLI-en skriver en diagnostisk loggfil for hver toppkommando inn i din lokale loggmappe (for eksempel %LOCALAPPDATA%\Microsoft.Agents.A365.DevTools.Cli\logs\ på Windows). logs export leser én eller alle disse filene, fjerner sensitivt innhold, og skriver de redigerte kopiene til din valgte utdatamappe.

Hva som blir redigert

Pattern	Replacement
JWT-bærertokens (header.payload.signature)	<JWT-TOKEN>
Email addresses	<email-1>, <email-2>, ... (konsistente aliaser per e-post)
GUIDs (8-4-4-4-12) — se Hva som bevares for unntak	<id-1>, <id-2>, ... (konsistente aliaser i henhold til GUID)
OS-sti-brukernavn (C:\Users\<name>, /Users/<name>, ) /home/<name>	<username-1>, <username-2>, ...

Identiske verdier beholder samme alias i hele filen, så kryssreferanser i loggen er nyttige for å diagnostisere problemer. Den redigerte filen inneholder en header som registrerer kildestien (med de samme redigeringene anvendt) og antall av hvert mønster som ble erstattet.

What's preserved

Redaktøren beholder følgende innhold ordrett, slik at den redigerte loggen fortsatt er nyttig for feilsøking og for Microsoft støtteeskalering:

Preserved	Hvorfor det er trygt
Tidsstempler, loggnivåer, omfangsnavn, feilkoder, filstier (med brukernavn erstattet), HTTP-statuskoder, JSON-former	Ingen av disse identifiserer en leietaker eller bruker.
TraceId: <guid> og CorrelationId: <guid> verdier	Sesjonslokale tilfeldige identifikatorer generert av CLI. De er ikke sensitive, og det er de som kobler loggen mot serversidespor.
request-id og client-request-id verdier inne i Microsoft Graph feillegemer	Servergenerert per samtale. Microsoft-support bruker disse for å slå opp nøyaktig forespørsel i tjenestelogger når du eskalerer.
Offentlige, velkjente Microsoft- og Agent 365-ressursapplikasjons-ID-er: • Microsoft Graph (00000003-0000-0000-c000-000000000000) • Agent 365 Messaging Bot API • Agent 365 Observability API • Power Platform API (tilkobling) • Agent 365 Tools (MCP-publikum, produksjon)	Dette er dokumenterte offentlige konstanter — de avslører ingenting om leietakeren din. Å bevare dem betyr at en linje som Validated permission AgentIdentityBlueprint.ReadWrite.All against 00000003-0000-0000-c000-000000000000 forblir lesbar i stedet for å bli ... against <id-4>.

Leietakerspesifikke tjenesteprincipal-objekt-ID-er og andre GUID-er som ikke samsvarer med mønstrene ovenfor, blir fortsatt redigert gjennom konsistent-alias-mekanismen.

Important

Redaksjonsmønstrene er laget for å fjerne det vanligste sensitive innholdet. Hvis loggene dine inneholder egendefinerte hemmeligheter (for eksempel hemmeligheter logget av kode utenfor denne CLI-en, eller verdier limt inn i stakkspor) i formater denne redaktøren ikke gjenkjenner, fjern dem manuelt før du deler.

Hvordan verifisere før deling

Åpne den redigerte filen i en teksteditor og skann etter noe som ser tenant-spesifikt ut:

# 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

Den eksporterte filens header-linje oppsummerer tellingene. Hvis du ser flere aliaser <id-N> enn forventet, gjør aliaskartet jobben sin — hver tenant-spesifikk GUID får nøyaktig ett alias.

export Alternativer

Option	Description
<command>	Navnet på kommandoen du vil eksportere loggen til (for eksempel setup eller cleanup). Utelat dette argumentet for å eksportere alle tilgjengelige loggfiler i én kjøring.
-o, --output <output>	Mappe for å skrive den redigerte loggfilen eller filene til. Går som standard til den nåværende katalogen.
-?, -h, --help	Vis informasjon om hjelp og bruk.

Examples

Eksporter loggen setup til den nåværende katalogen:

a365 logs export setup

Eksporter alle tilgjengelige logger til en spesifikk mappe:

a365 logs export --output ./support-bundle

Eksporter loggen cleanup til en spesifikk mappe:

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

Navngivning av utdatafiler

Den eksporterte filen skrives som a365.<command>.redacted.log. Når du utelater <command>, eksporterer CLI-en hver tilgjengelig logg til sin egen redigerte fil med samme navnemønster.

Important

Gå gjennom den redigerte filen før du deler den. Redaksjonsmønstrene dekker JWT-tokens, e-poster, GUID-er og OS-stibrukernavn, men de dekker ikke alle mulige hemmeligheter. Hvis loggen din inneholder egendefinerte hemmeligheter eller sensitive identifikatorer i andre formater, fjern dem manuelt før du deler dem.

Note

logs export Sletter eller endrer ikke de opprinnelige loggfilene. De opprinnelige loggene ligger fortsatt i din lokale loggkatalog. Kommandoen skriver kun redigerte kopier til utdatakatalogen.