إنشاء التقارير المخصّصة وإدارتها

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

تتيح لك التقارير المخصّصة التوغّل في مقاييس محددة لواجهة برمجة التطبيقات وعرض البيانات الدقيقة التي تريد الاطّلاع عليها. يمكنك إنشاء تقرير مخصّص باستخدام أي من metrics والسمة المضمَّنة في Edge. بالإضافة إلى ذلك، يمكنك إرفاق سياسة StatisticsCollector بالخوادم الوكيلة لواجهة برمجة التطبيقات لجمع مقاييس مخصصة، مثل معرِّف المستخدم أو المنتج والسعر وإجراء REST والإصدار المستهدف وعنوان URL المستهدف وطول الرسالة.

الفيديوهات الطويلة

شاهد الفيديوهات التالية للاطّلاع على مزيد من المعلومات عن التقارير المخصّصة.

حملة فيديو	الوصف
إنشاء تقارير مخصّصة باستخدام واجهة المستخدم	تعرَّف على كيفية إنشاء تقارير مخصّصة باستخدام واجهة مستخدم Edge.
نظرة عامة على التقارير المخصَّصة	إلقاء نظرة عامة على استخدام التقارير المخصّصة
تتبُّع وقت استجابة واجهة برمجة التطبيقات	اطّلع على كيفية تتبّع وقت استجابة واجهة برمجة التطبيقات باستخدام التقارير المخصّصة.
تتبُّع الردود على أخطاء واجهة برمجة التطبيقات	تتبّع الردود على أخطاء واجهة برمجة التطبيقات باستخدام التقارير المخصّصة.

حول التقارير المخصصة

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

ويمكنك أيضًا ضبط نوع الرسم البياني المعروض في التقرير المخصّص على أنّه رسم بياني عمودي أو خطي. تعرض الصور التالية أمثلة على الرسوم البيانية للمقياس الخاص بالمعاملات لكل ثانية، ويتم تجميعها حسب بُعد الخادم الوكيل لواجهة برمجة التطبيقات:

• عمود - يتم تمثيل كل خادم وكيل لواجهة برمجة التطبيقات بعمود مختلف:

  

• سطر - يتم تمثيل كل واجهة برمجة تطبيقات في سطر مختلف:

  

إعداد المقاييس والسمات

تحدِّد metrics التي تختارها لتقريرك المخصّص البيانات التي تحاول قياسها. وتشمل المقاييس الشائعة ما يلي:

• المعاملات في الثانية
• مدة الردّ
• أخطاء متعلقة بالسياسة

تتيح لك بعض المقاييس إعداد دالة تجميع لتنفيذها وفقًا للمقياس. على سبيل المثال، يمكنك استخدام دوال التجميع التالية مع مقياس وقت الاستجابة:

• avg: لعرض متوسط وقت الاستجابة
• min: لعرض الحدّ الأدنى لوقت الاستجابة
• max: لعرض الحدّ الأقصى لوقت الاستجابة
• sum: لعرض مجموع كل أوقات الاستجابة

لا تتيح بعض المقاييس كل وظائف التجميع. تحتوي المستندات حول metrics على جدول يحدد اسم المقياس والدالة (sum وavg وmin وmax) المتوافقة مع المقياس.

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

• وقت الاستجابة لكلّ منتج من منتجات واجهة برمجة التطبيقات
• وقت الاستجابة لكل خادم وكيل لواجهة برمجة التطبيقات
• وقت الردّ لكلّ عنوان بريد إلكتروني خاص بمطوّر البرامج

تستند طريقة عرض السمة في الرسم البياني الخاص بالتقرير المخصّص إلى نوع الرسم البياني:

• العمود: يقابل كل عمود قيمة مختلفة للبُعد.
• الخطي: يتجاوب كل سطر في الرسم البياني مع قيمة مختلفة للبُعد، ويمثّل المحور س الوقت.

إنشاء مقاييس وسمات مخصّصة

أضِف سياسة StatisticsCollector إلى الخوادم الوكيلة لواجهة برمجة التطبيقات لجمع بيانات إحصاءات مخصّصة، مثل معرِّف المستخدم أو المنتج والسعر وإجراء REST والإصدار المستهدف وعنوان URL المستهدف وطول الرسالة. ويمكن أن تأتي البيانات من متغيّرات التدفق المحدّدة مسبقًا من خلال Apigee أو عناوين الطلبات أو مَعلمات طلب البحث أو المتغيّرات المخصّصة التي تحدّدها. وبعد جمع البيانات، يمكنك إنشاء تقرير مخصّص لعرض تلك البيانات.

تعتمد طريقة عرض بيانات الإحصاءات المخصّصة في التقرير المخصّص على نوع بياناته:

• بالنسبة إلى بيانات نوع السلسلة، عليك الإشارة إلى البيانات الإحصائية على أنّها سمة في تقرير مخصّص.
• بالنسبة إلى أنواع البيانات الرقمية (عدد صحيح/عدد عائم/طويل/مزدوج)، أشِر إلى البيانات الإحصائية في تقرير مخصّص إما على أنّها سمة أو مقياس.

اطّلِع على سياسة StatisticsCollector للحصول على أمثلة عن جمع بيانات الإحصاءات المخصّصة.

فلاتر الإعدادات

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

تستخدم الفلاتر بنية شرطية تتيح لك إنشاء فلاتر معقّدة باستخدام عوامل تشغيل مثل eq وne وgt وlt وغيرها.

أمثلة على التقارير المخصّصة

في أبسط نوع من التقارير المخصّصة، يمكنك تحديد سمة واحدة وسمة واحدة. على سبيل المثال، يمكنك تحديد تقرير مخصّص باستخدام الإعدادات التالية:

• type = عمود
• المقياس = متوسط المعاملات في الثانية
• السمة = الخادم الوكيل لواجهة برمجة التطبيقات

يحتوي التقرير المخصّص على رسم بياني عمودي يتضمّن بيانات مقياس "متوسط المعاملات في الثانية" مجمّعة حسب سمة الخادم الوكيل لواجهة برمجة التطبيقات:

وتعرض المقاييس التي تعرض المتوسطات أيضًا الرابط عرض التشتّت على الجانب الأيسر من الرسم البياني، كما يظهر في الرسم البياني أعلاه. مرِّر مؤشر الماوس فوق الرابط لفتح مربّع التشتّت. يعرض مربع التشتت الاتجاهات المركزية لبياناتك.

يمكنك إضافة مقاييس متعددة إلى التقرير المخصّص. على سبيل المثال، يمكنك تحديد تقرير مخصّص بمقياسَين:

• type = عمود
• المقياس = متوسط المعاملات في الثانية
• المقياس = أخطاء السياسة
• السمة = الخادم الوكيل لواجهة برمجة التطبيقات

يحتوي التقرير المخصّص على رسم بياني منفصل لكل مقياس:

يمكنك إضافة سمات متعددة إلى التقرير المخصّص. على سبيل المثال، يمكنك تحديد تقرير مخصّص باستخدام الإعدادات التالية التي تتضمّن مقياسين وسمتَين:

• type = عمود
• المقياس = متوسط المعاملات في الثانية
• المقياس = أخطاء السياسة
• السمة = الخادم الوكيل لواجهة برمجة التطبيقات
• البُعد = طلب الفعل

يعرض الرسم البياني في البداية المقاييس مجمّعة حسب الخادم الوكيل، وهو السمة الأولى المحدّدة عند إنشاء التقرير المخصّص:

يمكنك بعد ذلك استخدام القائمة المنسدلة الخادم الوكيل، المقابلة للسمة الأولى، لاختيار خادم وكيل فردي. يعرض الرسم البياني المعدَّل الآن مقاييس الخادم الوكيل المحدَّد حسب فعل الطلب:

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

عرض جميع التقارير المخصّصة

الوصول إلى صفحة التقارير المخصّصة، كما هو موضّح أدناه.

تعرض صفحة "التقارير المخصّصة" جميع التقارير المخصّصة التي تم إنشاؤها لمؤسستك، كما هو موضّح في الشكل التالي:

كما هو موضّح في الشكل، تتيح لك صفحة التقارير المخصّصة إجراء ما يلي:

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

استكشاف لوحة بيانات التقرير المخصص

تعرض لوحة بيانات التقرير المخصّص نتائج تقريرك المخصّص لنطاق زمني محدّد، بما في ذلك الرسم البياني العمودي أو الخطي للمقياس المحدّد:

تتيح لك لوحة بيانات التقرير المخصّص ما يلي:

• عرض بيانات التقرير المخصّص للنطاق الزمني المحدّد
• اختر البيئة التي تريد عرض بيانات التقرير المخصّص لها.
• اختَر سمة معيّنة لفلترة بيانات التقرير المخصّص. لا يتم تفعيل هذه المنطقة إلّا عند تحديد سمات متعدّدة للتقرير.

• اختر عرض المخطط أو الجدول.

• يمكنك تحليل مقياس من خلال اختيار الرمز في صف الجدول للمقياس المرتبط. يمكنك الاطّلاع على القيم الشاذة ومقارنتها بفترة سابقة أو بمقاييس أخرى.
• شغِّل التقرير المخصّص بالنقر على النطاق الزمني وإعداده.
• نزِّل التقرير المخصّص كملف CSV. تتم تسمية الملف على النحو التالي: metric.csv. مثلاً: Average_of_total_response_time.csv
• تعديل التقرير المخصّص

الاطّلاع على لوحة بيانات تحليل المقاييس

إذا اختَرت الرمز في صف جدول الملخّص، ستظهر الرسوم البيانية التالية (لا يظهر الرسم البياني العلوي إلا في حال إعداد التقرير لاستخدام مقاييس متعدّدة):

تعرض هذه المخططات المعلومات التالية:

• المقارنة بـ: إذا أعددت التقرير لاستخدام مقاييس متعدّدة، قارِن المقاييس ببعضها.
• مقارنة بفترة زمنية سابقة: يمكنك عرض المقياس للفترة الزمنية السابقة. على سبيل المثال، إذا اخترت عرض التقرير المخصّص لآخر 24 ساعة، سيعرض هذا الرسم البياني بيانات آخر 24 ساعة.

• تحليل القيم الشاذة: يعرض أي نقاط بيانات طرفية في بيانات التقرير. يعرض هذا الرسم البياني قيمتين:

  • تمثّل هذه السمة المتوسط المتحرك للمقياس المعروض على شكل خط. بالنسبة إلى نقطة معيّنة على الخط، يتم احتساب قيمة المتوسط المتحرك من خلال متوسط قيمة المقياس في هذه النقطة الزمنية وقيم المقياس لنقطتي البيانات السابقتين.
  • تحدِّد المنطقة الزرقاء من الرسم البياني متوسّط الحدّ الأقصى ومتوسط الحدّ الأدنى للمقياس. يبلغ متوسط الحد الأقصى 1.2 * (المتوسط المتحرّك)، ومتوسط الحد الأدنى هو 0.8 * (المتوسط المتغيّر).

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

إضافة تقرير مخصّص

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

وبعد إضافة التقرير المخصّص، يجب run بشكلٍ متزامن أو غير متزامن.

لإضافة تقرير مخصّص:

1. الوصول إلى صفحة "التقارير المخصَّصة".
2. انقر على + تقرير مخصّص.
3. في القسم "أساسية"، أدخِل المعلومات التالية:

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

4. في قسم "المقاييس":
   1. انقر على رمز بجانب المقاييس.
   2. اختَر المقياس الذي تريد تحليله.
   3. اختَر دالة تجميع لعرض قيم "المجموع" أو "المتوسط" أو "الحد الأدنى" أو "الحد الأقصى".
   4. انقر على حفظ.
   5. انقر على رمز لإضافة مقاييس أخرى.
5. في قسم السمات، انقر على واختَر سمة، مثل "الخادم الوكيل"، لفرض قيود على مجموعة البيانات المستخدَمة لإنشاء التقارير. يمكنك إضافة سمات أخرى لفرض قيود إضافية على البيانات.

6. في قسم الفلاتر، يمكنك تضييق نطاق البيانات المعروضة عن طريق إضافة فلاتر إلى تعريف تقريرك. على سبيل المثال، يمكنك إضافة فلتر يستثني بيانات الخادم الوكيل لواجهة برمجة تطبيقات الطقس أو المطوِّر jane@example.com.

   1. انقر على واختَر اسم الكيان الذي تريد الفلترة وفقًا له، وعامل تشغيل مثل = أو !=، وقيمة.
   2. انقر على إضافة لحفظ الفلتر.
   3. انقر على لإضافة فلاتر إضافية، واختَر موصِّل AND أو OR.

7. لتحديد مَن يمكنه الوصول إلى التقرير المخصّص، عدِّل الأدوار المخصّصة التي تم تحديدها للتقرير.

   1. انقر على لتعديل إعدادات الدور المخصَّص.
   2. اختَر الدور المخصَّص المطلوب للوصول إلى التقرير ومستوى الوصول (عرض أو تعديل أو حذف).
   3. انقر على إضافة.
   4. انقر على لتعديل أدوار إضافية.
8. انقر على حفظ لحفظ التقرير.

تشغيل تقرير مخصّص

تتيح لك إحصاءات Edge تشغيل التقرير بشكل متزامن أو غير متزامن.

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

  ويمكن أن يكون للتقرير المتزامن نطاق زمني أقصى يبلغ 14 يومًا. وإذا اخترت نطاقًا زمنيًا لمدة 15 يومًا أو أكثر، سيتم دائمًا تشغيل التقرير بشكل غير متزامن.

• بالنسبة إلى التقرير غير المتزامن، يمكنك تشغيل طلب التقرير واسترداد النتائج في وقت لاحق. في ما يلي بعض الحالات التي تكون فيها معالجة طلبات البحث غير المتزامنة بديلاً جيدًا:

  • تحليل وإنشاء التقارير التي تغطي فترات زمنية طويلة.
  • تحليل البيانات باستخدام مجموعة متنوعة من أبعاد التجميع والقيود الأخرى التي تضيف تعقيدًا إلى طلب البحث
  • إدارة طلبات البحث عندما تجد أن أحجام البيانات قد ازدادت بشكلٍ كبير لبعض المستخدمين أو المؤسسات.

  يصف هذا المستند كيفية بدء تقرير غير متزامن باستخدام واجهة المستخدم. يمكنك أيضًا استخدام واجهة برمجة التطبيقات على النحو الموضَّح في استخدام واجهة برمجة التطبيقات غير المتزامنة للتقارير المخصّصة.

لعرض تقرير مخصّص لنطاق زمني محدّد:

1. الوصول إلى صفحة "التقارير المخصَّصة".
2. اختَر التقرير المطلوب تشغيله. يعرض التقرير تلقائيًا بيانات الساعة السابقة.

3. لعرض التقرير لنطاق زمني مختلف:

   1. انقر في منطقة النطاق الزمني في أعلى التقرير لفتح النافذة المنبثقة اختيار وقت التقرير المخصَّص.
   2. اختَر أيًا مما يلي:
      • نطاق زمني محدَّد مسبقًا، مثل آخر ساعة أو أمس أو آخر 7 أيام.

      • نطاق مخصّص عن طريق اختيار تاريخ ووقت من/إلى، أو استخدام التقويم لتحديد تاريخَي البدء والانتهاء. انقر على التوقيت العالمي المنسَّق (UTC) لاستخدام نظام التوقيت العالمي المنسَّق (UTC).

   3. لتشغيل التقرير، حدِّد أحد الخيارات التالية:

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

      • أرسِل المهمة لتشغيل التقرير بشكل غير متزامن كوظيفة في الخلفية. سيظهر مربع الحوار التالي:

        

        انقر على عرض الحالة في مربّع الحوار لعرض حالة مهمة التقرير المخصّص.

عرض مهام التقارير المخصّصة غير المتزامنة

لعرض مهام التقارير المخصّصة غير المتزامنة، حدِّد أحد الخيارات التالية:

• انقر على عرض الحالة في مربع الحوار "تم إرسال التقرير كمهمة في الخلفية".
• حدد تحليل > التقارير المخصصة > الإبلاغ عن المهام من شريط التنقل الأيمن.

يتم عرض صفحة وظائف التقرير كما هو موضح في الشكل التالي:

تتيح لك صفحة "إعداد تقارير عن المهام":

• يمكنك عرض جميع نتائج مهام التقارير المخصّصة غير المتزامنة التي تم إرسالها خلال آخر 7 أيام.

• حدد البيئة التي تريد عرض مهام التقرير المخصص لها.

• لعرض التقرير المخصّص، تأكّد من اكتمال حالته. بعد ذلك، حرِّك مؤشر الماوس فوق الصف المقابل للتقرير. سيظهر الرمز والرمز . حدّد لعرض التقرير.

• نزِّل التقرير المخصّص بالنقر على .

  يتم تنزيل التقرير الكامل كملف ZIP باسم OfflineQueryResult-xxx.zip يحتوي على ملفات CSV.

• ابحث في قائمة التقارير المخصّصة عن طريق إدخال سلسلة ذات صلة بأكملها أو جزء منها في مربّع البحث، ويتم البحث في جميع الحقول المعروضة عن السلسلة.

تعديل تقرير مخصّص

لتعديل تقرير مخصّص:

1. الوصول إلى صفحة "التقارير المخصَّصة".
2. حرِّك مؤشر الماوس فوق اسم التقرير الذي تريد تعديله. يظهر رمزا التعديل والحذف على الجانب الأيسر من الصفحة.
3. انقر على رمز التعديل.
4. عدِّل تفاصيل التقرير المخصّص.
5. انقر على حفظ.

يتم إرجاعك إلى نتائج التقرير المخصّص.

حذف تقرير مخصّص

لحذف تقرير مخصّص:

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