فهم سجلات HAR واستكشاف أخطائها وإصلاحها ل WxCall

المقدمة

يصف هذا المستند فهم سجلات HAR واستكشاف أخطائها وإصلاحها.

نظرة عامة على الميزة

سجل HAR (قصير لتسجيل أرشيف HTTP) هو سجل لكل نشاط الشبكة بين المستعرض وموقع ويب أثناء جلسة معينة.

عندما تقوم بزيارة موقع ويب، يرسل المستعرض الخاص بك طلبات إلى الخادم ويستلم استجابات. يلتقط ملف HAR كل تلك الطلبات، الردود، ومعلومات التوقيت.

تعد ضرورية لتشخيص مشاكل أداء الويب واستكشاف أخطاء الشبكة وإصلاحها وتحليل حركات واجهة برمجة التطبيقات (API).

تساعد سجلات HAR في تحديد موارد التحميل البطيء والطلبات الفاشلة وتتبع تفاعلات المستخدم مع تطبيقات الويب.

القيود

• يمكن أن تكون ملفات HAR كبيرة ويصعب تحليلها يدويا.
• يمكن تسجيل البيانات الحساسة؛ ضمان عملية تصفية البيانات قبل المشاركة.
• يمكن أن تمنع بعض سياسات الأمان التقاط HAR بالكامل.

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

أداة HAR Sanitizer

المحفوظات

وفي عام 2023، وقعت مخالفة أمنية في أوكتا حيث سرقت ملفات HAR من نظم إدارة حالات الدعم الخاصة بها. أستخدم المهاجمون الرمز المميز للوصول وملفات تعريف الارتباط من هذه الملفات للوصول إلى حسابات العملاء الخاصة بهم. وفي الرد، قامت OKTA بتنفيذ أداة التعقيم.

حالة حالية

يوجد حاليا نظام أتمتة قيد التنفيذ يحاول إستبعاد المواد الحساسة من الآثار، ولكنه يترك الباقي على حاله للحفاظ على القدرة على أستكشاف المشكلات وحلها وتحليل مشكلتك.

عندما تقوم بتحميل ملف HAR، الأداة تلقائيا:

1. يكتشف أنه تم تحميل ملف HAR
2. يقوم بتعقيم ملف HAR باستخدام https://har-sanitize.cisco.com
3. تحميل الملف المعطل بالحالة
4. تشفير ملف HAR الأصلي باستخدام GPG
5. تحميل ملف HAR المشفر إلى الحالة
6. يحذف ملف HAR الأصلي من الحالة
7. إضافة ملاحظة توضح الحالة ما تم القيام به وارتباط بهذه الأداة

ملاحظة: إذا تعذر عليك حل المشكلة باستخدام الإصدار المطهر من ملف HAR، يمكنك وضع إستثناء كما هو موضح في الأقسام التالية والحصول على نسخة من ملف HAR الأصلي مرة أخرى.

كيفية إستخراج سجل HAR

إنشاء ملف HAR في المستعرض

ارجع إلى: قم بإنشاء ملف HAR في المستعرض الخاص بك.

إستخراج من المستند:

• الكروم:
  افتح أدوات المطور (F12) > صفحة الشبكة > الحفاظ على السجل > بدء التسجيل > إعادة إنتاج إصدار > تصدير ملف HAR.
• برنامج Firefox:
  افتح أدوات المطور (F12) > علامة تبويب الشبكة > أيقونة المحرك > التحقق من "إستمرار السجلات" > بدء التسجيل > حفظ HAR.

معلومات مفيدة قبل تحليل سجلات HAR

أساليب HTTP

تحدد طرق HTTP (المعروفة أيضا بأفعال HTTP) نوع العملية التي يريد العميل تنفيذها على مورد معين (مثل البيانات أو صفحة ويب).

ولكل طريقة قصد معين ولغة معبرة.

أكثر طرق HTTP شيوعا هي: احصل على مع مواد النشر ووضعها وتصحيحها وحذفها ورأسها وخيارات وتتبع.

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

شرح الأعمدة

• الأمان: يشير إلى ما إذا كان أسلوب HTTP يعتبر آمنا، مما يعني أنه لا يعدل الموارد أو أن طرق أمان حالة الخادم مخصصة للاسترداد فقط، وليس لإجراء تغييرات. يتم إستخدامها بشكل نموذجي لعمليات القراءة فقط.
• تحديد ما إذا كان تكرار طلب HTTP نفسه عدة مرات له نفس التأثير الذي يكون له مرة واحدة. إحدى الطرق الفعالة تعني أنه بغض النظر عن عدد مرات تكرار الطلب، فإن النتيجة تبقى بدون تغيير (بعد أول طلب ناجح)
• الاستخدام النموذجي: يصف الغرض أو السيناريو المشترك الذي يتم إستخدام طريقة HTTP من أجله. يوفر هذا السياق متى ولماذا تستخدم كل طريقة في تصميم تطوير الويب أو واجهة برمجة التطبيقات (API).
• نص الطلب: يشير إلى ما إذا كان طلب HTTP يحتوي عادة على نص (البيانات المرسلة إلى الخادم). غالبا ما يتم إستخدام نص الطلب لإرسال البيانات (مثل JSON و XML وبيانات النموذج) إلى الخادم، مثل عند إنشاء الموارد أو تحديثها. 
• نص الاستجابة: يحدد ما إذا كانت إستجابة HTTP تحتوي عادة على نص (بيانات مرجعة بواسطة الخادم). نص الاستجابة هو البيانات المرسلة من الخادم إلى العميل، مثل المورد المطلوب أو رسائل الحالة أو تأكيد إجراء ما.

تشريح سجل HAR

ملاحظة: كل أمثلة الصور في هذا القسم، تم التقاطها عند محاولة تحميل المواقع في Control HUB للمؤسسة

العنوان الرئيسي

التقاط بيانات التعريف المتبادلة بين العميل (المستعرض) والخادم أثناء طلبات HTTP واستجاباتها.

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

يتم تضمين الرؤوس في هذه الأقسام من سجل HAR:

1. رؤوس الطلبات: يتم إرسال هذه العناصر من المستعرض (العميل) إلى الخادم كجزء من طلب HTTP.
2. رؤوس الاستجابات: يتم إرجاع هذه الملفات بواسطة الخادم إلى المستعرض إستجابة للطلب.

يتم تخزين الرؤوس على هيئة صفيفات من أزواج القيم الأساسية، حيث:

• المفتاح: اسم الرأس.
• القيمة: القيمة المقترنة بالرأس.

رؤوس الطلبات الشائعة

1. المضيف: يحدد اسم المجال للخادم (مثل as example.com) ورقم المنفذ.

• مثال: المضيف: www.example.com

2. وكيل المستخدم: تعريف المستعرض أو العميل الذي يقوم بإجراء الطلب، بالإضافة إلى الإصدار ونظام التشغيل الخاصين به.

• مثال: وكيل المستخدم: Mozilla/5. 0 \(Windows NT 10. 0؛ نظام التشغيل Win64؛ x64\)

3. قبول: الإشارة إلى أنواع المحتوى الذي يمكن للعميل معالجته (مثل HTML و JSON والصور).

• مثال: قبول: نص/html،تطبيق/xhtml+xml

4. قبول-ترميز: يحدد أنواع الترميز (مثل gzip، إزاحة) يمكن للعميل فك الترميز.

• مثال: قبول-ترميز: gzip، انكمش

5. الترخيص: يحتوي على بيانات اعتماد للمصادقة، مثل العلامات المميزة أو بيانات اعتماد المصادقة الأساسية.

• مثال: الاعتماد: الحامل <token>

6. ملفات تعريف الارتباط: يتضمن ملفات تعريف الارتباط التي يرسلها العميل إلى الخادم.

• مثال: ملف تعريف الارتباط: sessionId=12345؛ userPref=darkMode

7. نوع المحتوى: يشير إلى نوع البيانات التي يتم إرسالها في نص الطلب (لطلبات POST/PUT).

• مثال: المحتوى - النوع: التطبيق/json

8. المرجع: تعريف URL الخاص بالصفحة التي أحالت العميل إلى المورد الحالي.

• مثال: المرجع: https://www.example.com/

رؤوس الاستجابة الشائعة

1.نوع المحتوى: تحديد نوع MIME للمورد (مثل text/html، application/json).

• مثال: المحتوى - النوع: التطبيق/json

2. طول المحتوى: الإشارة إلى حجم نص الاستجابة بالبايت.

• مثال: طول المحتوى: 1234

3. التحكم في ذاكرة التخزين المؤقت: تحديد سياسات التخزين المؤقت للمورد (مثل ما إذا كان قابلا للتخزين المؤقت، ولمدة التخزين المؤقت).

• مثال: التحكم في ذاكرة التخزين المؤقت: عدم التخزين المؤقت، عدم التخزين، يجب إعادة التحقق

4. الخادم: تعريف برنامج/إصدار الخادم.

• مثال: الخادم: أباتشي/2.4.29

5. set-cookie: يحتوي على ملفات تعريف الارتباط التي يريد الخادم من العميل تخزينها.

• مثال: set-cookie: sessionId=67890؛ المسار=/؛ آمن

6. التاريخ: تاريخ ووقت إنشاء الخادم للاستجابة.

• مثال: التاريخ: الثلاثاء، 10 أكتوبر 2023 الساعة 12:00:00 بتوقيت جرينتش

7. الموقع: يستخدم في عمليات إعادة التوجيه، للإشارة إلى URL الذي يجب على العميل الانتقال إليه.

• مثال: الموقع: https://www.example.com/new-page

8. تقرير الفريق: معرف فريد للمورد، غالبا ما يستخدم للتخزين المؤقت والإصدار.

• مثال: مجموعة المنتجات: 12345

9. ترميز المحتوى: يشير إلى كيفية تشفير نص الاستجابة (مثل gzip، انحراف).

• مثال: ترميز المحتوى: gzip

10. مصدر السماح بالتحكم بالوصول: تحديد الأصل المسموح به للوصول إلى الموارد (المستخدم في CORS).

• مثال: عنصر التحكم في الوصول - عنصر السماح بالأصل: *

ملاحظة: تعد رأس Trackingid هي الأكثر صلة بمكالمات Webex، نظرا لأن هذا هو المعرف الذي يمكنك البحث عنه في أداة LMA.

الحمولة

البيانات المرسلة أو المستلمة في نص طلب HTTP أو إستجابته.

غالبا ما يكون مرتبطا بطلبات POST أو PUT أو PATCH، حيث يرسل العميل بيانات إلى الخادم، مثل إرسال النموذج أو تحميل الملفات أو بيانات JSON لواجهات برمجة التطبيقات.

يمكن أن توجد الحمولة أيضا في استجابات HTTP، والتي تحتوي على بيانات مرتجعة من قبل الخادم، مثل HTML أو JSON أو المحتوى الثنائي (مثل الصور والملفات).

حيث تظهر الحمولة في سجلات HAR

عادة ما توجد الحمولة في قسمين رئيسيين من سجل HAR:

1. حمولة الطلب: البيانات المرسلة من العميل (المستعرض) إلى الخادم في نص طلب HTTP.
2. حمولة الاستجابة: البيانات التي قام الخادم بإرجاعها إلى العميل في نص إستجابة HTTP.

معاينة

هو جزء من كائن response.content ويوفر تمثيلا للبيانات التي تم إرجاعها بواسطة الخادم بتنسيق مهيكل وقابل للقراءة من قبل الإنسان، إذا كان متوفرا.

تستخدم المعاينة عادة لعرض البيانات التي تم تحليلها أو هيكلتها من نص الاستجابة بطريقة سهلة الاستخدام، مثل JSON أو XML أو تنسيقات أخرى.

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

إستجابة

توفر الاستجابة معلومات تفصيلية حول إستجابة HTTP التي أرسلها الخادم إلى العميل (المستعرض) لطلب محدد. يحتوي هذا القسم على بيانات تعريف ورؤوس وتفاصيل محتوى وبيانات هامة أخرى يمكن أن تساعدك على فهم سلوك الخادم أثناء دورة الاستجابة للطلب. وهو يوفر لقطة تفصيلية لرد الخادم على طلب HTTP.

بادئ

توفر البادئ نظرة متعمقة على ما تم تشغيل طلب HTTP محدد أثناء تحميل صفحة ويب. تحدد مصدر أو سبب طلب الشبكة، مما يساعد المطورين على فهم سلسلة الأحداث التي أدت إلى الطلب. يساعد البادئ أيضا في تتبع أصل الطلب ويمكن أن يشير إلى الخط الدقيق للتعليمات البرمجية أو المورد المسؤول عن صنعه.

توقيت

يوفر التوقيت تفصيلا للمراحل المختلفة التي تشتمل عليها معالجة طلب HTTP والاستجابة. يساعد المطورين على فهم المدة التي تستغرقها كل خطوة في دورة الطلب والاستجابة، من بدء الاتصال إلى تلقي الاستجابة النهائية. كما يقوم التوقيت بتعقب تسلسل الأحداث ومدتها التي تحدث عندما يقوم متصفح بتقديم طلب إلى خادم ويستلم إستجابة. وهو يتضمن مقاييس مفصلة لدقة DNS، وإنشاء الاتصال، وإرسال الطلب، وانتظار إستجابة الخادم، وتنزيل بيانات الاستجابة.

استكشاف الأخطاء وإصلاحها

أداة داخلية لعرض سجلات HAR

انتقل إلى EasyLmaSearch > إستيراد ملف HAR/SAZ.

الخطوات العامة لاستكشاف الأخطاء وإصلاحها

1. افتح ملف HAR في .
2. تحديد الطلبات الفاشلة (مثل أخطاء HTTP 4xx/5xx).

3. تحقق من أوقات الاستجابة وعناصر التحميل البطيء.

4. تحليل رؤوس الطلبات/الاستجابات لمشاكل المصادقة و CORS.

5. ابحث عن معرفات التعقب في طلبات الشبكة و .
6. التحقق من حالات الفشل مقابل الردود إذا كان ذلك ممكنا.

مثال على أستكشاف الأخطاء وإصلاحها من التذاكر

عناصر التحميل البطيء

مثال:

• يستغرق "مركز التحكم" وقتا طويلا لتحميل الأرقام لموقع ما

أستكشاف الأخطاء وإصلاحها:

• طلب فيديو للمشكلة (محاولة تحميل صفحة الأرقام لموقع)
• طلب سجل HAR أثناء محاولة تحميل الأرقام لموقع ما

1. افتح ملف HAR في عارض HAR أو أدوات مطور المستعرض.
   
2. التعرف على الطلب في الشلال منظر
   
3. انقر في الطلب الذي يستغرق تحميله وقتا طويلا.
4. راجع علامة التبويب التوقيت في السجل:

5. تحقق من أوقات الاستجابة وعناصر التحميل البطيء.

6. اجمع Trackingid لذلك الرأس.

7. افتح EasyLMA وابحث باستخدام Trackingid.

شرح مراحل تقسيم التوقيت

وفيما يلي المزيد من المعلومات حول كل مرحلة من المراحل التي يمكنك رؤيتها في Timintab:

• قوائم الانتظار. طلبات قوائم انتظار المستعرض قبل بدء الاتصال ووقت:
  • توجد طلبات ذات أولوية أعلى. يتم تحديد أولوية الطلب بواسطة عوامل مثل نوع المورد، بالإضافة إلى موقعه داخل المستند. لمزيد من المعلومات، اقرأ قسم أولوية الموارد في دليل fechpriority.
  • هناك بالفعل ست إتصالات TCP مفتوحة لهذا الأصل، وهو الحد. (ينطبق على HTTP/1.0 و HTTP/1.1 فقط.)
  • يقوم المستعرض بتخصيص مساحة في ذاكرة التخزين المؤقت للقرص بإيجاز.
• متوقف. يمكن إيقاف الطلب بعد بدء الاتصال لأي سبب من الأسباب الموضحة في قوائم الانتظار.
• بحث DNS. يقوم المستعرض بحل عنوان IP للطلب.
• التوصيل الأولي. يقوم المستعرض بإنشاء اتصال، بما في ذلك تبادل رسائل TCP أو إعادة المحاولة والتفاوض مع SSL.
• تفاوض الوكيل. يقوم المستعرض بالتفاوض حول الطلب باستخدام خادم وكيل.
• تم إرسال الطلب. يتم إرسال الطلب.
• إعداد ServiceWorker. يقوم المستعرض ببدء تشغيل عامل الخدمة.
• طلب إلى ServiceWorker. يتم إرسال الطلب إلى عامل الخدمة.
• قيد الانتظار (TTFB). المستعرض ينتظر أول بايت من الاستجابة. TTFB يرمز إلى الوقت للبايت الأول. يتضمن هذا التوقيت رحلة وصول واحدة ذهابا وإيابا والوقت الذي إستغرقه الخادم لإعداد الاستجابة.
• تنزيل المحتوى. يتلقى المستعرض الاستجابة، إما مباشرة من الشبكة أو من عامل خدمة. هذه القيمة هي إجمالي مقدار الوقت المستغرق في قراءة نص الاستجابة. قد تشير القيم الأكبر من المتوقع إلى شبكة بطيئة أو أن المستعرض مشغول بتنفيذ أعمال أخرى تؤدي إلى تأخير قراءة الاستجابة.

المورد غير متوفر

مثال: 

"لقد قمت بتمكين SNR لمستخدمي على محور التحكم في المسؤول لكنني لا أرى خيار إعداد رقم SNR عند تسجيل الدخول إلى مدخل user.webex.com.
هل يمكنك التحقق من مؤسستي ومستخدمي لمعرفة سبب عدم قدرتي على مشاهدته على لوحة وصل المستخدمين؟"

أستكشاف الأخطاء وإصلاحها:

1. تأكد مما يراه المستخدم من خلال طلب لقطة شاشة للمستخدم العامل مقابل مستخدم غير عامل.

2. طلب سجل HAR أثناء تحميل الخيارات الخاصة بالمستخدم.

الخطوات التالية:

1. افتح ملف HAR في عارض HAR أو أدوات مطور المستعرض. 
   
2. تحديد الطلبات:

تقوم الخدمة بتقديم طلب (GET) للتعرف على خدمات المستخدم

إستدعاء طلب قالب وصول ميزة المستخدم النهائي (GET) قالب الخدمات التي يتم عرضها للمستخدم:

1. تحليل رؤوس الطلبات/الردود.
   
   يعني "عدم الوصول" أن القالب يخفي هذه الخيارات للمستخدم.
2. تحتاج إلى مراجعة القالب الخاص بالمؤسسة وتشغيل وصول الرقم المفرد للمستخدم حتى يتمكن من رؤيته في مركز المستخدم.

مثال:

لا يمكن تمكين ميزة

مثال مع تسجيل المكالمات:

عند محاولة تمكين تسجيل المكالمات لمستخدم ما، تتلقى رسالة خطأ: "فشل تغيير تسجيل المكالمات".

لاستكشاف الأخطاء وإصلاحها:

1. تأكد من الخطأ من خلال طلب نص رسالة الخطأ الكامل.

2. اطلب لقطة شاشة للخطأ.

3. طلب سجل HAR أثناء محاولة تمكين "تسجيل المكالمات" في المستخدم المتأثر .

4. افتح ملف HAR في عارض HAR أو أدوات مطور المستعرض.

5. تحديد الطلبات الفاشلة (مثل أخطاء HTTP 4xx/5xx).

6. ابحث عن معرفات التعقب في EasyLMA.


7. باستثناء CPAPI، يمكنك فتح بيمز:

8. افتح مجموعة صور مصغرة بالمعلومات التي تم جمعها:

• لقطات الشاشة
• إكمال رسالة الخطأ
• معرف التعقب
• إستثناء cpapi
  
  

9. اسأل في مساحة Dubber أو لفريق BU لمراجعة مع فريق Dubber الخطأ:
"ملخص الاستجابة للخطأ: 400: منتج غير صالح: فشل إنشاء النقطة الثنائية في Dubber. حالة HTTP: 502"

رسائل الفاكس

فيما يلي المخطط الذي يوضح تدفق الإمداد أثناء انتقاله عبر الخدمات متناهية الصغر:

عند أستكشاف أخطاء توفير رسائل الفاكس وإصلاحها داخل "مركز التحكم"، من الضروري تجميع تتبع HAR لجمع رؤى تفصيلية لطبيعة المشكلة وفهم الأسباب وراء فشل التوفير. 

عند تمكين ميزة مراسلة الفاكس، يلتقط تتبع HAR ويعرض الطلب ذي الصلة من CH إلى CPAPI. يتبع هذا الطلب الملتقط تنسيقا محددا.

من موقع سي إتش → سي بي آي:

رقعة
عنوان URL للطلب:https://cpapi-r.wbx2.com/api/v1/customers/[OrgID]/users/[ChuSerID]/VoiceEmail
TrackingID ATLAS_4fd0efd2-f0e4-4ca2-a932-16f4b0884a48_12

نشر البيانات {
"ممكن": صحيح،
"الاخطارات": {
"ممكن": صحيح،
"الوجهة": "lazoclaudiafi+faxmessaging@gmail.com"
},
"SendAllCalls": {
"ممكن": زائف
},
"SendBusyCalls": {
"ممكن": صحيح،
"تحية": "الافتراضي"
},
"SendUnansweredCalls": {
"ممكن": صحيح،
"تحية": "الافتراضي"،
"الحد الأقصى للحلقات": 3
},
"TransferToNumber": {
"ممكن": زائف
},
"emailCopyOfMessage": {
"ممكن": صحيح،
"معرف البريد الإلكتروني": "lazoclaudiafi+faxmessaging@gmail.com"
},
"رسالة الفاكس": {
"ممكن": خطأ،
"رقم الهاتف": "+12099193323"،
"التمديد": فارغ (null)
},
"تخزين الرسائل": {
"تمكين الوسائط: صحيح،
"نوع التخزين": "داخلي"،
"البريد الإلكتروني الخارجي": "lazoclaudiafi+faxmessaging@gmail.com"
}

لتعقب هذه المعلومات بشكل فعال في تقنية EasyLMA، يرجى الرجوع إلى الإرشادات التفصيلية المقدمة هنا: 

الفئة: معرف التعقب
الفئة الفرعية: العالمية
معرف تعقب Webex: ATLAS_4fd0efd2-f0e4-4ca2-a932-16f4b0884a48_12

معلومات التصعيد

• ملف سجل HAR
• لقطات شاشة للأخطاء
• خطوات لإعادة إنتاج المشكلة
• الطابع الزمني للحادث
• سجلات LMA

الرجاء الإجابة على هذه الأسئلة قبل فتح تصعيد BEMS لأن ذلك يساعد على أستكشاف الأخطاء وإصلاحها:

• ما الخطأ الذي تراه؟
• ما هي معرفات التعقب التي تراها؟
• هل راجعت معرف التعقب في LMA؟
• ماذا ترى في LMA؟
• هل هذه الأحواض ضرورية حقا؟