הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
חומר עזר לפקודה של CLI
נהל יומני אבחון של CLI. פקודת logs מייצאת עותקים מצונזרים של קבצי יומן CLI שבטוחים לשיתוף עם התמיכה Microsoft. השתמש בפקודת logs export המשנה כדי לערוך ולהעתיק קבצי יומן של ה-CLI. הקבצים המיוצאים בטוחים להצמדה לכרטיס תמיכה מבלי לדלוף מיילים, GUIDs או טוקנים.
תפקיד מינימלי נדרש: אין. הפקודה קוראת וכותבת מחדש רק קבצי לוגים מקומיים.
Syntax
a365 logs [command] [options]
logs export
ייצא עותק מצונזר של קובץ יומן אבחון של CLI שבטוח לשיתוף עם תמיכת Microsoft. מוחק טוקני JWT, כתובות דוא"ל, GUIDs ושמות משתמש של OS-path, ומחליף ערכים זהים בכינויים עקביים כדי לשמור על קורלציה ביומן.
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>, ... (כינויים עקביים לכל מייל) |
| GUIDs (8-4-4-4-12) — ראו מה נשמר לחריגים |
<id-1>, <id-2>, ... (כינויים עקביים לפי GUID) |
שמות משתמש של OS-path (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 ו-Agent 365: • Microsoft Graph ( 00000003-0000-0000-c000-000000000000)• API לבוט הודעות Agent 365 • API לתצפית של סוכן 365 • Power Platform API (קישוריות) • כלי סוכן 365 (קהל 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, מיילים, GUIDs ושמות משתמש במערכת ההפעלה (OS-path), אבל הם לא מכסים כל סוד אפשרי. אם היומן שלך מכיל סודות מותאמים אישית או מזהים רגישים בפורמטים אחרים, הסר אותם ידנית לפני השיתוף.
Note
logs export לא מוחק או משנה את קבצי הלוג המקוריים. היומנים המקוריים נשארים בתיקיית היומנים המקומית שלך. הפקודה כותבת רק עותקים מצונזרים לתיקיית הפלט.