مرجع أمر Agent 365 CLI logs

إدارة سجلات تشخيص CLI. أمر logs يصدر نسخا محجوبة من ملفات سجل CLI التي يمكن مشاركتها مع دعم Microsoft. استخدم الأمر logs export الفرعي لتنقيب ونسخ ملفات سجل CLI. الملفات المصدرة آمنة للربط بتذكرة الدعم دون تسريب رسائل البريد الإلكتروني أو رموز المعلومات أو الرموز.

الحد الأدنى للدور المطلوب: لا يوجد. يقرأ الأمر ويعيد كتابة ملفات السجل المحلية فقط.

Syntax

a365 logs [command] [options]

logs export

تصدير نسخة محجوبة من ملف سجل تشخيصي لواجهة السطر (CLI) وتكون آمنة للمشاركة مع دعم Microsoft. يقوم بحذف رموز JWT، وعناوين البريد الإلكتروني، ورموز GUIDs، وأسماء مستخدمي مسار OS-path، ويستبدل القيم المتطابقة بأسماء مستعارة متسقة للحفاظ على ارتباط السجل.

a365 logs export [<command>] [options]

يكتب مؤشر القيادة ملف سجل تشخيصي لكل أمر على المستوى الأعلى في مجلد السجلات المحلي لديك (على سبيل المثال، %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)
أسماء مستخدمي مسار نظام التشغيل (C:\Users\<name>, /Users/<name>, /home/<name>)	<username-1>, <username-2>, ...

القيم المتطابقة تحتفظ بنفس الاسم المستعار عبر الملف، لذا تظل المراجع المتبادلة في السجل مفيدة لتشخيص المشاكل. يتضمن الملف المنقوح رأسا يسجل مسار المصدر (مع تطبيق نفس التنقيحات) وعدد كل نمط تم استبداله.

What's preserved

يقوم المحقر عمدا keep بالمحتوى التالي حرفيا حتى يظل السجل المحجوب مفيدا لتصحيح الأخطاء ولتصعيد دعم Microsoft:

Preserved	لماذا هو آمن
الطوابع الزمنية، مستويات السجل، أسماء النطاقات، رموز الخطأ، مسارات الملفات (مع استبدال أسماء المستخدمين)، رموز حالة HTTP، أشكال JSON	لا يحدد أي من هذه المستأجر أو المستخدم.
TraceId: <guid>والقيم CorrelationId: <guid>	معرفات عشوائية محلية للجلسة تولدها واجهة السطوع. هي ليست حساسة وهي ما يربط السجل بمسارات على جانب الخادم.
قيم request-id و client-request-id داخل Microsoft Graph أجسام الخطأ	يتم إنشاؤه من قبل الخادم لكل مكالمة. دعم Microsoft يستخدم هذه القواعد للبحث عن الطلبات الدقيقة في سجلات الخدمة عند تصعيد الأمور.
معرفات تطبيقات الموارد العامة والمعروفة ل Microsoft وAgent 365: • Microsoft Graph (00000003-0000-0000-c000-000000000000) • واجهة برمجة تطبيقات روبوت المراسلة Agent 365 • واجهة برمجة تطبيقات الرصد للعامل 365 • واجهة برمجة تطبيقات منصة الطاقة (الاتصال) • أدوات العميل 365 (جمهور MCP، إنتاج)	هذه ثوابت عامة موثقة — لا تكشف شيئا عن المستأجر الخاص بك. الحفاظ عليها يعني أن السطر يبقى Validated permission AgentIdentityBlueprint.ReadWrite.All against 00000003-0000-0000-c000-000000000000 قابلا للقراءة بدلا من أن يصبح ... against <id-4>.

معرفات الكائنات الرئيسية الخاصة بالخدمة الخاصة بالمستأجر وأي معرفات واجهة مستخدمة أخرى لا تتطابق مع الأنماط أعلاه لا تزال تنقع عبر آلية الاسم المستعار المتسق.

Important

تم تصميم أنماط التنقيح لإزالة أكثر المحتويات الحساسة شيوعا. إذا كانت سجلاتك تحتوي على أسرار مخصصة (مثل الأسرار المسجلة بواسطة كود خارج هذا السطوع، أو قيم ملصقة في تتبع المكدس) بصيغ لا يتعرف عليها هذا المحرر، قم بإزالتها يدويا قبل المشاركة.

كيفية التحقق قبل المشاركة

افتح الملف المحجوب في محرر نصوص وامسح أي شيء يبدو خاصا بالمستأجر:

# 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> الأسماء المستعارة مما تتوقع، فإن خريطة الأسماء المستعارة تقوم بعملها — كل واجهة مستخدم مستخدم خاصة بالمستأجر تحصل على اسم مستعار واحد فقط.

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>يقوم مؤشر القيادة بتصدير كل سجل بيانات متاح إلى ملف منقح خاص به بنفس نمط التسمية.

Important

راجع الملف المحجوب قبل مشاركته. أنماط التنقيح تشمل رموز JWT، والبريد الإلكتروني، ورموز GUIDs، وأسماء مستخدمي مسار OS، لكنها لا تغطي كل الأسرار الممكنة. إذا كان سجلك يحتوي على أسرار مخصصة أو معرفات حساسة بصيغ أخرى، قم بإزالتها يدويا قبل المشاركة.

Note

logs export لا يحذف أو يعدل ملفات السجل الأصلية. السجلات الأصلية تبقى في دليل السجلات المحلي الخاص بك. تكتب هذه الأوامر النسخ المحجوبة فقط إلى مجلد الإخراج.