Αναφορά εντολών CLI logs παράγοντα 365

Διαχείριση αρχείων καταγραφής διαγνωστικών CLI. Η εντολή logs εξάγει αντίγραφα αρχείων καταγραφής CLI που είναι ασφαλή για κοινή χρήση με Microsoft υποστήριξη. Χρησιμοποιήστε τη logs export δευτερεύουσα εντολή για να αποκρύψετε και να αντιγράψετε αρχεία καταγραφής CLI. Τα εξαγόμενα αρχεία είναι ασφαλή για επισύναψη σε δελτίο υποστήριξης χωρίς διαρροή email, GUID ή διακριτικών.

Ελάχιστος απαιτούμενος ρόλος: Κανένας. Η εντολή διαβάζει και ξαναγράφει μόνο τοπικά αρχεία καταγραφής.

Syntax

a365 logs [command] [options]

logs export

Εξαγάγετε ένα διορθωμένο αντίγραφο ενός αρχείου καταγραφής διαγνωστικών CLI που είναι ασφαλές για κοινή χρήση με την υποστήριξη της Microsoft. Αποκρύπτει τα διακριτικά JWT, τις διευθύνσεις email, τα 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>, ... (συνεπή ψευδώνυμα ανά email)
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

Ο διορθωτής σκόπιμα διατηρεί αυτολεξεί το ακόλουθο περιεχόμενο, ώστε το αρχείο καταγραφής που έχει διορθωθεί να εξακολουθεί να είναι χρήσιμο για τον εντοπισμό σφαλμάτων και για Microsoft κλιμάκωση υποστήριξης:

Preserved	Γιατί είναι ασφαλές
Χρονικές σημάνσεις, επίπεδα καταγραφής, ονόματα πεδίων, κωδικοί σφαλμάτων, διαδρομές αρχείων (με αντικατάσταση ονομάτων χρήστη), κωδικοί κατάστασης HTTP, σχήματα JSON	Κανένα από αυτά δεν προσδιορίζει έναν μισθωτή ή χρήστη.
TraceId: <guid> και CorrelationId: <guid> αξίες	Τυχαία αναγνωριστικά τοπικής συνεδρίας που δημιουργούνται από το CLI. Δεν είναι ευαίσθητα και είναι αυτά που συνδυάζουν το αρχείο καταγραφής με ίχνη από την πλευρά του διακομιστή.
Τιμές request-id και client-request-id εντός Microsoft Graph σωμάτων σφάλματος	Δημιουργείται από διακομιστή ανά κλήση. Η υποστήριξη της Microsoft τα χρησιμοποιεί για να αναζητήσει την ακριβή αίτηση στα αρχεία καταγραφής υπηρεσίας κατά την κλιμάκωση.
Δημόσια, γνωστά αναγνωριστικά εφαρμογών πόρων της Microsoft και του παράγοντα 365: • Microsoft Graph (00000003-0000-0000-c000-000000000000) • Agent 365 Messaging Bot API • 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 δεν διαγράφει ούτε τροποποιεί τα αρχικά αρχεία καταγραφής. Τα αρχικά αρχεία καταγραφής παραμένουν στον τοπικό κατάλογο αρχείων καταγραφής. Η εντολή γράφει μόνο αντίγραφα που έχουν διορθωθεί στον κατάλογο εξόδου.