Agent 365:n komentorivikäyttöliittymän logs komentoviittaus

Hallinnoi CLI-diagnostiikkalokit. logs-komento vie sensuroituja kopioita CLI-lokitiedostoista, jotka ovat turvallisia jakaa Microsoft-tuen kanssa. Käytä alikomentoa logs export sensuroidaksesi ja kopioimaan CLI-lokitiedostoja. Vietyt tiedostot on turvallista liittää tukipyyntöön ilman sähköposteja, GUID-tiedostoja tai tokeneita.

Vaadittu vähimmäisrooli: Ei yhtään. Komento lukee ja kirjoittaa uudelleen vain paikallisia lokitiedostoja.

Syntax

a365 logs [command] [options]

logs export

Vie sensuroitu kopio CLI-diagnostiikkalokitiedostosta, joka on turvallista jakaa Microsoft-tuen kanssa. Sensuroi JWT-tunnukset, sähköpostiosoitteet, GUID-tunnukset ja käyttöjärjestelmän polun käyttäjätunnukset, ja korvaa identtiset arvot johdonmukaisilla aliaksilla, jotta lokikorrelaatio säilyy.

a365 logs export [<command>] [options]

Komentokomento kirjoittaa diagnostiikkalokitiedoston jokaiselle ylätason komennolle paikalliseen lokihakemistoosi (esimerkiksi %LOCALAPPDATA%\Microsoft.Agents.A365.DevTools.Cli\logs\ Windows:ssa). logs export lukee yhden tai kaikki näistä tiedostoista, poistaa arkaluontoisen sisällön ja kirjoittaa sensuroidut kopiot valitsemaasi tulostiedostokansioon.

Mitä sensuroidaan

Pattern	Replacement
JWT-kantajatokenit (header.payload.signature)	<JWT-TOKEN>
Email addresses	<email-1>, <email-2>, ... (johdonmukaiset nimimerkit sähköpostissa)
GUIDs (8-4-4-4-12) — katso Mitä säilytetään poikkeuksille	<id-1>, <id-2>, ... (johdonmukaiset aliakset per GUID)
OS-polun käyttäjätunnukset (C:\Users\<name>, /Users/<name>, /home/<name>)	<username-1>, <username-2>, ...

Identtiset arvot säilyttävät saman alian koko tiedostossa, joten ristiviittaukset lokissa ovat hyödyllisiä ongelmien diagnosointiin. Sensuroitu tiedosto sisältää otsikon, joka tallentaa lähdepolun (samoilla sensursseilla) ja jokaisen korvatun kuvion määrän.

What's preserved

Muokkaaja tarkoituksella säilyttää seuraavan sisällön sanasta sanaan, jotta sensuroitu loki olisi edelleen hyödyllinen virheenkorjaukseen ja Microsoft tukieskalointiin:

Preserved	Miksi se on turvallista
Aikaleimat, lokitasot, scope-nimet, virhekoodit, tiedostopolut (nimet korvattu), HTTP-tilakoodit, JSON-muodot	Mikään näistä ei paljasta vuokralaista tai käyttäjää.
TraceId: <guid> ja CorrelationId: <guid> arvot	Istuntopaikan satunnaistunnisteet, jotka on luotu CLI:llä. Ne eivät ole herkkiä, ja ne yhdistävät lokin palvelinpuolen jäljityksiin.
request-id ja client-request-id arvot Microsoft Graph virhekappaleiden sisällä	Palvelin luoma per puhelu. Microsoftin tuki käyttää näitä tarkistaakseen tarkan pyynnön palvelulokeista, kun eskaloit.
Julkiset, tunnetut Microsoft- ja Agent 365 -resurssisovellus-ID:t: • Microsoft Graph (00000003-0000-0000-c000-000000000000) • Agent 365 Messaging Bot API • Agent 365 Havaittavuusrajapinta • Power Platform API (yhteydet) • Agent 365 Tools (MCP-yleisö, tuotanto)	Nämä ovat dokumentoituja julkisia vakioita — ne eivät paljasta mitään vuokralaisestasi. Niiden säilyttäminen tarkoittaa, että rivi kuten Validated permission AgentIdentityBlueprint.ReadWrite.All against 00000003-0000-0000-c000-000000000000 pysyy luettavana eikä muuttuisi ... against <id-4>.

Tenant-kohtaiset palvelupääobjektin ID:t ja muut GUID:t, jotka eivät vastaa yllä mainittuja malleja, sensuroidaan edelleen johdonmukaisen alias-mekanismin kautta.

Important

Redaktiokuviot on suunniteltu poistamaan yleisin arkaluonteinen sisältö. Jos lokissasi on omia salaisuuksia (esimerkiksi salaisuuksia, jotka on kirjattu koodilla tämän komentoketjun ulkopuolelta, tai arvoja, jotka on liitetty pinon jäljityksiin) formaateissa, joita tämä muokkaaja ei tunnista, poista ne manuaalisesti ennen jakamista.

Kuinka varmistaa ennen jakamista

Avaa sensuroitu tiedosto tekstieditorissa ja skannaa kaikkea, mikä vaikuttaa vuokralaiskohtaiselta:

# 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

Vientitiedoston otsikkorivi tiivistää luvut. Jos näet aliaksien määrän <id-N> enemmän kuin odotat, aliaskartta tekee tehtävänsä — jokainen vuokralaiskohtainen GUID saa täsmälleen yhden aliaksen.

export asetukset

Option	Description
<command>	Komennon nimi, jonka lokia haluat viedä (esim setup . tai cleanup). Jätä pois tämä argumentti, jonka mukaan kaikki saatavilla olevat lokitiedostot voidaan viedä yhdellä ajokerralla.
-o, --output <output>	Hakemisto, johon sensuroidun lokitiedoston tai tiedostojen kirjoittamiseen. Oletuksena nykyinen hakemisto.
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Examples

Vie loki setup nykyiseen hakemistoon:

a365 logs export setup

Vie kaikki saatavilla olevat lokit tiettyyn kansioon:

a365 logs export --output ./support-bundle

Vie loki cleanup tiettyyn kansioon:

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

Tulostiedostojen nimeäminen

Viety tiedosto kirjoitetaan muodossa a365.<command>.redacted.log. Kun jätät <command>pois , CLI vie jokaisen saatavilla olevan lokin omaan sensuroituun tiedostoonsa, jossa on sama nimikuvio.

Important

Tarkista sensuroitu tiedosto ennen kuin jaat sen. Redaktiokuviot kattavat JWT-tokenit, sähköpostit, GUID:t ja käyttöjärjestelmän polun käyttäjätunnukset, mutta ne eivät kata kaikkia mahdollisia salaisuuksia. Jos lokissasi on omia salaisuuksia tai arkaluonteisia tunnisteita muissa muodoissa, poista ne manuaalisesti ennen jakamista.

Note

logs export ei poista tai muokkaa alkuperäisiä lokitiedostoja. Alkuperäiset lokit pysyvät paikallisessa lokihakemistossa. Komento kirjoittaa vain sensuroidut kopiot tulostushakemistoon.