أنت تعرض مستندات Apigee Edge.
انتقل إلى
مستندات Apigee X. معلومات
هذا الموضوع هو مرجع لمقاييس الإحصاءات والسمات والفلاتر. لمزيد من السياق حول باستخدام هذه الأدوات، يُرجى الاطّلاع على نظرة عامة على "إحصاءات واجهة برمجة التطبيقات".
يعرِض هذا الموضوع أسماء المقاييس والسمات كما تظهر في واجهة المستخدِم وحسب حاجتك. لاستخدامها في طلبات بيانات من واجهة برمجة التطبيقات.
- ستظهر لك أسماء واجهات المستخدم عند إنشاء تقارير مخصّصة.
- استخدام الأسماء الخاصة بواجهة برمجة التطبيقات عند الحصول على مقاييس، وإنشاء تقرير أو تعريف تحديث تقرير.
المقاييس
في ما يلي مقاييس واجهة برمجة التطبيقات التي يمكنك استردادها في التقارير المخصّصة وإدارة طلبات البيانات من واجهة برمجة التطبيقات.
اسم التقارير المخصّصة | الاسم المطلوب استخدامه في واجهة برمجة تطبيقات الإدارة | الدوال | الوصف |
---|---|---|---|
متوسط المعاملات في الثانية | عدد النقاط في الثانية | لا ينطبق |
متوسط عدد المعاملات في الثانية، أي طلبات الخادم الوكيل لواجهة برمجة التطبيقات لاحظ أنه إذا كان لديك انخفاض نسبيًا عدد المعاملات خلال الفترة الزمنية، ومتوسط عدد المعاملات لكل يمكن أن تكون قيمة الثانية صفرًا في التقارير المخصّصة لواجهة المستخدم إذا كان الرقم أقل من اثنين المنازل العشرية. بنية واجهة برمجة التطبيقات: |
نتيجة ذاكرة التخزين المؤقت | cache_hit | المجموع |
عدد طلبات البيانات الناجحة من واجهة برمجة التطبيقات التي تستخدم ذاكرة التخزين المؤقت للاستجابة بدلاً من استجابة من الخدمة المستهدفة. بنية واجهة برمجة التطبيقات: |
عدد عناصر ذاكرة التخزين المؤقت L1 | ax_cache_l1_count | متوسط، أدنى، حدّ أقصى |
عرض عدد العناصر في ذاكرة التخزين المؤقت L1 (في الذاكرة) لكل معاملة عبر معاملة محددة
فترة زمنية محددة. على سبيل المثال، إذا اخترت بنية واجهة برمجة التطبيقات: |
أخطاء السياسة | policy_error | المجموع |
إجمالي عدد أخطاء السياسة خلال الفترة الزمنية المحددة تحدث أخطاء السياسة غالبًا عن طريق التصميم. على سبيل المثال، تعرض سياسة "مفتاح واجهة برمجة التطبيقات" ظهور خطأ عند تمرير مفتاح واجهة برمجة تطبيقات غير صالح في الطلب، وسياسة منع الارتفاع تعرض رسالة خطأ إذا تجاوز عدد طلبات البيانات من واجهة برمجة التطبيقات الحدّ الأقصى الذي تم تحديده في السياسة. إذًا، يفيد هذا المقياس في العثور على نقاط المشاكل المحتملة في واجهات برمجة التطبيقات. على سبيل المثال: قد تساعدك مقاييس Policy_error، المجمّعة حسب السمة developer_app، في اكتشاف انتهاء صلاحية مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز لتطبيق معيّن، أو قد تجد أن خادم وكيل محدد لواجهة برمجة التطبيقات يؤدي إلى حدوث العديد من أخطاء Spike Arrest، مما يقودك إلى اكتشاف أن فالحد الأقصى لارتفاع عدد مرات الاعتقال لدى الخادم الوكيل لا يراعي الزيادة في عدد الزيارات أثناء العطلات. لا يتم تسجيل خطأ في السياسة في "إحصاءات Google" إلا إذا أدى الخطأ إلى تعذُّر خادم وكيل واجهة برمجة التطبيقات.
على سبيل المثال، عند ضبط سمة يُعد بُعد اسم السياسة المتعلق بالخطأ (ax_execution_FALSE_policy_name) مفيدًا بالنسبة إلى تجميع أخطاء السياسة حسب اسم السياسة. لا يُعتبر إخفاق الهدف (مثل 404 أو 503) إخفاقًا في السياسة. تلك احتساب إخفاقات خادم وكيل واجهة برمجة التطبيقات (is_error). بنية واجهة برمجة التطبيقات: |
أخطاء الخادم الوكيل | is_error | المجموع |
إجمالي عدد مرّات تعذُّر الخوادم الوكيلة لواجهة برمجة التطبيقات خلال الفترة الزمنية المحدّدة. الوكيل قد يحدث أي فشل عند إخفاق سياسة ما أو عند فشل بيئة التشغيل، مثل خطأ 404 أو 503 من الخدمة المستهدفة. يُعد بُعد الخادم الوكيل (apiproxy) مفيدًا لتجميع حالات إخفاق خادم وكيل واجهة برمجة التطبيقات حسب الخادم الوكيل. بنية واجهة برمجة التطبيقات: |
وقت استجابة معالجة الطلبات | request_processing_latency | متوسط، أدنى، حدّ أقصى |
مقدار الوقت (المتوسط أو الأدنى أو الأقصى)، بالمللي ثانية، أنّ متصفّح Edge يتطلب معالجة الطلبات الواردة. يبدأ الوقت عندما يصل الطلب Edge وينتهي عندما يعيد Edge توجيه الطلب إلى الخدمة المستهدفة. باستخدام سمات مختلفة، يمكنك فحص وقت استجابة معالجة الطلبات من خلال خادم وكيل واجهة برمجة التطبيقات وتطبيق مطوّر البرامج والمنطقة وما إلى ذلك. بنية واجهة برمجة التطبيقات: |
حجم الطلب | request_size | مجموع، متوسط، دقيقة، كحد أقصى |
حجم حمولة الطلب التي تم استلامها بواسطة Edge، بـ بايت بنية واجهة برمجة التطبيقات: |
تم تنفيذ ذاكرة التخزين المؤقت للردود | ax_cache_executed | المجموع |
إجمالي عدد المرات التي تم فيها تنفيذ سياسة ذاكرة التخزين المؤقت للردود خلال الفترة الزمنية المحدّدة الفترة. بما أن سياسة ذاكرة التخزين المؤقت للاستجابة مرفقة في مكانين في خادم وكيل لواجهة برمجة التطبيقات (مرة واحدة في ومرة واحدة في الاستجابة)، عادةً ما يتم تنفيذها مرتين في طلب بيانات من واجهة برمجة التطبيقات. ذاكرة التخزين المؤقت "الحصول على" وذاكرة التخزين المؤقت "put" حيث يتم احتساب كل منها على أنها عملية تنفيذ واحدة. ومع ذلك، يكون تنفيذ ذاكرة التخزين المؤقت للاستجابة 0 إذا كانت
في أداة التتبُّع،
يمكنك النقر على رمز ذاكرة التخزين المؤقت للاستجابة في استدعاء واجهة برمجة التطبيقات الذي تم تنفيذه وعرض
متغيّر التدفق بنية واجهة برمجة التطبيقات: |
وقت استجابة معالجة الردّ | response_processing_latency | متوسط، أدنى، حدّ أقصى |
مقدار الوقت (المتوسط أو الأدنى أو الأقصى)، بالمللي ثانية، أن متصفّح Edge يتطلب معالجة ردود واجهة برمجة التطبيقات. يبدأ الوقت عند تلقي الخادم الوكيل لواجهة برمجة التطبيقات استجابة الخدمة المستهدفة وتنتهي عندما تعيد Apigee توجيه الرد إلى المتصل. باستخدام سمات مختلفة، يمكنك فحص وقت الاستجابة لمعالجة الردود حسب واجهة برمجة التطبيقات. والوكيل والمنطقة وما إلى ذلك. بنية واجهة برمجة التطبيقات: |
حجم الردّ | response_size | مجموع، متوسط، دقيقة، كحد أقصى |
حجم حمولة الاستجابة التي تم إرجاعها إلى العميل، بايت. بنية واجهة برمجة التطبيقات: |
أخطاء الاستهداف | target_error | المجموع |
إجمالي عدد 5xx إجابة من الخدمة المستهدفة. هذه هي الخدمات المستهدفة الأخطاء التي لم تنتج عن Apigee. بنية واجهة برمجة التطبيقات: |
وقت الاستجابة المستهدَف | target_response_time | مجموع، متوسط، دقيقة، كحد أقصى |
مقدار الوقت (المجموع أو المتوسط أو الحد الأدنى أو الحد الأقصى)، مللي ثانية، حتى يستجيب الخادم الهدف لمكالمة. هذا المقياس بأداء الخوادم المستهدفة. يبدأ الوقت عندما يعيد Edge توجيه الطلب. إلى الخدمة المستهدفة وينتهي عندما يتلقى Edge الرد. يُرجى ملاحظة أنّه إذا عرض طلب بيانات من واجهة برمجة التطبيقات ردًا من ذاكرة التخزين المؤقت (باستخدام ذاكرة التخزين المؤقت للاستجابة). مثلًا)، فلن يصل الاستدعاء أبدًا إلى الخدمة المستهدفة، ولن يكون هناك هدف تسجيل مقاييس وقت الاستجابة بنية واجهة برمجة التطبيقات: |
إجمالي وقت الاستجابة | total_response_time | مجموع، متوسط، دقيقة، كحد أقصى |
مقدار الوقت (المجموع أو المتوسط أو الحد الأدنى أو الحد الأقصى)، مللي ثانية، بدءًا من وقت تلقّي Edge لطلب من أحد العملاء وحتى وقت يرسل Edge الرد مرة أخرى إلى العميل. ويشمل الوقت حمل الشبكة (مثل الوقت الذي تستغرقه أجهزة موازنة الحمل وأجهزة التوجيه لأداء مهامها)، طلب معالجة وقت الاستجابة ووقت استجابة معالجة الاستجابة ووقت الاستجابة المستهدف (إذا تم عرض الاستجابة من الخدمة المستهدفة بدلاً من ذاكرة التخزين المؤقت). باستخدام سمات مختلفة، يمكنك فحص وقت استجابة المعالجة حسب خادم وكيل واجهة برمجة التطبيقات وتطبيق مطوّر البرامج والمنطقة وما إلى ذلك. بنية واجهة برمجة التطبيقات: |
حركة المرور | message_count | المجموع |
إجمالي عدد طلبات البيانات من واجهة برمجة التطبيقات التي تعالجها Edge في الفترة الزمنية المحدّدة. استخدِم السمات لتجميع أعداد الزيارات بطرق مفيدة جدًا بالنسبة إليك. بنية واجهة برمجة التطبيقات: |
الأبعاد
تتيح لك السمات الاطّلاع على المقاييس في مجموعات مفيدة. على سبيل المثال، قد يؤدي الاطّلاع على إجمالي عدد الزيارات وتزداد فعالية الأعداد عند عرضها لكل تطبيق مطوِّر أو لكل خادم وكيل لواجهة برمجة التطبيقات.
في ما يلي الأبعاد التي توفّرها Apigee بشكل فوري. بالإضافة إلى ذلك، يمكنك إنشاء السمات الخاصة بها، على النحو الموضّح في مقالة تحليل محتوى الرسائل من واجهة برمجة التطبيقات باستخدام الإحصاءات المخصّصة.
اسم التقارير المخصّصة | الاسم المطلوب استخدامه في واجهة برمجة تطبيقات الإدارة | الوصف |
---|---|---|
كيانات Apigee | ||
رمز الدخول | access_token | رمز دخول OAuth للمستخدم النهائي للتطبيق. |
منتج واجهة برمجة التطبيقات | api_product |
اسم منتج واجهة برمجة التطبيقات الذي يحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم استدعاؤها. من أجل الحصول على لهذه السمة، يجب أن تكون تطبيقات المطوّرين التي تُجري الطلبات مرتبطة بواجهة برمجة تطبيقات واحدة أو أكثر يجب أن تتحقق المنتجات التي تحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات والخوادم الوكيلة التي يتم استدعاؤها من وجود واجهة برمجة تطبيقات أو رمز OAuth المميز الذي تم إرساله مع طلب بيانات من واجهة برمجة التطبيقات. يرتبط المفتاح أو الرمز المميز بواجهة برمجة تطبيقات. المنتج. لمزيد من المعلومات، يُرجى مراجعة النقاط المهمة أولاً: كيفية إنشاء بيانات إحصاءات كاملة في حال عدم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجع أيضًا ما الذي تعنيه قيمة كيان التحليلات "(not set)" أعني؟. |
مفتاح ذاكرة التخزين المؤقت | ax_cache_key |
المفتاح الذي يحتوي على قيمة ذاكرة التخزين المؤقت للاستجابة التي تم الوصول إليها. لمزيد من المعلومات حول كيفية إنشاء المفتاح لذاكرة التخزين المؤقت للاستجابة، راجِع سياسة ذاكرة التخزين المؤقت للاستجابة. في أداة التتبُّع،
فعند تحديد سياسة ذاكرة التخزين المؤقت للاستجابة التي تقرأ من أو تكتب إلى ذاكرة التخزين المؤقت، فإنك
يمكننا رؤية هذه القيمة في متغيّر التدفق |
اسم ذاكرة التخزين المؤقت | ax_cache_name |
اسم ذاكرة التخزين المؤقت التي تحتوي على المفاتيح/القيم التي تستخدمها سياسة ذاكرة التخزين المؤقت للاستجابة مسبوقة بـ orgName__envName__. على سبيل المثال، إذا كانت المؤسسة هي "foo"، الـ بيئة التشغيل هي "test" واسم ذاكرة التخزين المؤقت هو "mycache"، يكون ax_cache_name foo__test__myCache. في أداة التتبُّع،
عند اختيار سياسة ذاكرة التخزين المؤقت للردود، يمكنك رؤية هذه القيمة في
متغيّر التدفق |
مصدر ذاكرة التخزين المؤقت | ax_cache_source |
مستوى ذاكرة التخزين المؤقت (قاعدة البيانات "L1" في الذاكرة أو "L2") الذي تم إنشاء استرداده. تعرض هذه السمة أيضًا "CACHE_MISS" وقت تسليم الرد من الهدف بدلاً من ذاكرة التخزين المؤقت (وتم تحديث ذاكرة التخزين المؤقت للاستجابة بالاستجابة المستهدفة) أو عندما يكون مفتاح ذاكرة التخزين المؤقت في الطلب غير صالح. تقتصر مفاتيح ذاكرة التخزين المؤقت على حجم 2 كيلوبايت في أداة التتبُّع،
عند اختيار سياسة ذاكرة التخزين المؤقت للردود، يمكنك رؤية هذه القيمة في
متغيّر التدفق للحصول على مزيد من المعلومات حول مستويات ذاكرة التخزين المؤقت، يُرجى الاطّلاع على العناصر الداخلية لذاكرة التخزين المؤقت. |
معرِّف العميل | client_id |
مفتاح المستهلك (مفتاح واجهة برمجة التطبيقات) الخاص بتطبيق المطوّر الذي يُجري طلبات بيانات من واجهة برمجة التطبيقات، سواء تم تمريره في الطلب كمفاتيح واجهة برمجة التطبيقات أو مضمّنة في رموز OAuth المميزة. للحصول على هذه السمة، يجب ضبط الخوادم الوكيلة التي تتلقّى المكالمات للتحقّق من للحصول على مفتاح واجهة برمجة تطبيقات أو رمز OAuth مميز صالح. تحصل تطبيقات المطوّرين على مفاتيح واجهة برمجة التطبيقات التي يمكن استخدامها إنشاء رموز OAuth المميزة، عند تسجيل التطبيقات في Edge. لمزيد من المعلومات، يُرجى مراجعة النقاط المهمة أولاً: كيفية إنشاء بيانات إحصاءات كاملة في حال عدم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجِع أيضًا مقالة ما الذي تعنيه قيمة كيان "إحصاءات Google" "(not set)"؟ أعني؟. |
تطبيق مطوِّر | developer_app |
تطبيق المطوِّر المسجّل لدى Edge الذي يُرسل طلبات البيانات من واجهة برمجة التطبيقات للحصول على هذه السمة، يجب ربط التطبيقات بمنتج واحد أو أكثر من منتجات واجهة برمجة التطبيقات. تحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم استدعاؤها، ويجب أن تبحث الخوادم الوكيلة عن مفتاح واجهة برمجة التطبيقات أو تم إرسال رمز OAuth المميز مع طلب بيانات من واجهة برمجة التطبيقات. يحدِّد المفتاح أو الرمز المميّز تطبيق المطوِّر. بالنسبة للحصول على مزيد من المعلومات، يُرجى الاطّلاع على النقاط الأولى أولاً: كيفية إنشاء بيانات إحصائية كاملة. في حال عدم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجِع أيضًا مقالة ما الذي تعنيه قيمة كيان "إحصاءات Google" "(not set)"؟ أعني؟. |
البريد الإلكتروني الخاص بمطوّر البرامج | developer_email |
البريد الإلكتروني للمطوّرين المسجَّلين في Edge الذين أجروا طلبات بيانات من واجهة برمجة التطبيقات باستخدام تطبيقاتهم للحصول على هذه السمة، يجب أن يكون لدى المطوّرين تطبيقات مرتبطة بعنصر واحد أو أكثر. منتجات واجهة برمجة التطبيقات التي تحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم طلبها، ويجب أن تبحث الخوادم الوكيلة عن مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز الذي تم إرساله مع طلب بيانات من واجهة برمجة التطبيقات. يحدد المفتاح أو الرمز المميز مطوِّر البرامج التطبيق. لمزيد من المعلومات، يُرجى الاطّلاع على النقاط الأولى أولاً: كيفية إنشاء بيانات إحصاءات كاملة. في حال عدم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجِع أيضًا مقالة ما الذي تعنيه قيمة كيان "إحصاءات Google" "(not set)"؟ أعني؟. |
رقم تعريف المطوّر | المطوّر |
رقم التعريف الفريد للمطوّر الذي أنشأه Edge في شكل org_name@@@unique_id. للحصول على هذه السمة، يجب أن يكون لدى المطوّرين تطبيقات مرتبطة بعنصر واحد أو أكثر. منتجات واجهة برمجة التطبيقات التي تحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم طلبها، ويجب أن تبحث الخوادم الوكيلة عن مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز المُرسَل مع طلبات بيانات من واجهة برمجة التطبيقات. يحدد المفتاح أو الرمز المميز مطور البرامج. لمزيد من المعلومات، يُرجى الاطّلاع على النقاط الأولى أولاً: كيفية إنشاء بيانات إحصاءات كاملة. في حال عدم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجِع أيضًا مقالة ما الذي تعنيه قيمة كيان "إحصاءات Google" "(not set)"؟ أعني؟. |
البيئة | بيئة | بيئة Edge التي يتم فيها نشر الخوادم الوكيلة لواجهة برمجة التطبيقات. على سبيل المثال، "اختبار" أو "إنتاج". |
رمز خطأ عند رصد خطأ | ax_edge_execution_fault_code |
رمز الخطأ للخطأ. مثل:
|
اسم التدفق عند وجود خطأ | ax_execution_fault _flow_name |
التدفق المُسمّى في الخادم الوكيل لواجهة برمجة التطبيقات الذي أظهر خطأ. على سبيل المثال، "PreFlow" و"PostFlow"، أو اسم تدفق شرطي قمت بإنشائه. لاحظ أن الاسم الكامل المستخدم في واجهة برمجة تطبيقات الإدارة هو ax_execution_error_flow_name، بدون فاصل أسطر. في حال عدم حدوث أي أخطاء، ستظهر القيمة "(not set)". |
مورد التدفق | flow_resource | لاستخدام Apigee فقط. إذا كان يهمّك معرفة المزيد من المعلومات، يمكنك الاطّلاع على هذه المشاركة في "المنتدى". |
حالة التدفق عند حدوث خطأ | ax_execution_fault _flow_state |
يشير اسم مسار الخادم الوكيل لواجهة برمجة التطبيقات إلى حدوث أخطاء، مثل "PROXY_REQ_FLOW" أو "TARGET_RESP_FLOW". لاحظ أن الاسم الكامل المستخدم في واجهة برمجة تطبيقات الإدارة هو ax_execution_billing_flow_state، بدون فاصل أسطر. |
رقم تعريف تدفق المدخل | gateway_flow_id | ومع انتقال طلبات البيانات من واجهة برمجة التطبيقات عبر Edge، يحصل كل طلب على رقم تعريف تدفق المدخل الخاص به. مثال: rrt329ea-12575-114653952-1. يُعد رقم تعريف تدفق المدخل مفيدًا لتمييز المقاييس في حالات ارتفاع TPS عندما تكون هناك أبعاد أخرى مثل المؤسسة والبيئة والطابع الزمني متطابقة عبر المكالمات. |
المؤسسة | مؤسسة | يشير ذلك المصطلح إلى مؤسسة Edge التي يتم نشر الخوادم الوكيلة لواجهة برمجة التطبيقات فيها. |
اسم السياسة عند وجود خطأ | ax_execution_fault _policy_name |
اسم السياسة التي عرضت خطأ وتسببت في تعذُّر طلب البيانات من واجهة برمجة التطبيقات. لاحظ أن الاسم الكامل المطلوب استخدامه في واجهة برمجة تطبيقات الإدارة هو ax_execution_Error_policy_name، بدون فاصل أسطر. إذا عرضت سياسة خطأً، لكنّ السمة الجذر للسياسة |
الخادم الوكيل | خادم وكيل | اسم الجهاز (وليس الاسم المعروض) للخادم الوكيل لواجهة برمجة التطبيقات. |
المسار الأساسي للخادم الوكيل | proxy_basepath |
BasePath الذي تم ضبطه على الخادم الوكيل لواجهة برمجة التطبيقات ProxyEndpoint لا يشتمل المسار الأساسي على النطاق والمنفذ لعنوان URL للخادم الوكيل لواجهة برمجة التطبيقات. على سبيل المثال، إذا كان عنوان URL الأساسي لخادم وكيل واجهة برمجة التطبيقات هو https://apigeedocs-test.apigee.net/releasenotes/، المسار الأساسي هو /releasenotes. يتم أيضًا تخزين القيمة في متغيّر التدفق |
لاحقة مسار الخادم الوكيل | proxy_pathsuffix |
مسار المورد الذي تمت إضافته إلى المسار الأساسي للخادم الوكيل لواجهة برمجة التطبيقات. على سبيل المثال، إذا كانت واجهة برمجة التطبيقات الوكيلة
عنوان URL الأساسي هو وفي حال عدم استخدام أي لاحقة، تكون القيمة فارغة. يتم أيضًا تخزين القيمة في متغيّر التدفق |
مراجعة الخادم الوكيل | apiproxy_revision | رقم النسخة السابقة للخادم الوكيل لواجهة برمجة التطبيقات الذي عالج طلبات البيانات من واجهة برمجة التطبيقات. هذا ليس بالضرورة آخر مراجعة لخادم وكيل واجهة برمجة التطبيقات. إذا كان خادم وكيل واجهة برمجة التطبيقات يحتوي على 10 مراجعات، فإن قد يتم نشر المراجعة حاليًا. أيضًا، قد يكون لواجهة برمجة التطبيقات مراجعات متعددة تم نشرها طالما أن النُسخ تحتوي على مسارات أساسية مختلفة، كما هو موضَّح في نشر الخوادم الوكيلة في واجهة المستخدم. |
عنوان IP للعميل الذي تم حله | ax_resolved_client_ip |
يحتوي على عنوان IP المصدر للعميل. قيمة لاحظ أنه عند استخدام منتجات التوجيه مثل Akamai لتسجيل عناوين IP الحقيقية للعملاء،
يتم تمرير عنوان IP للعميل إلى Edge في عنوان HTTP يتمّ احتساب قيمة السمة
|
رمز حالة الردّ | response_status_code | رمز حالة استجابة HTTP الذي تمت إعادة توجيهه من Apigee إلى العميل، مثل 200 و404، 503 وهكذا. في Edge، يمكن استبدال رمز حالة الاستجابة من الهدف باستخدام مثل تعيين الرسالة ورفع الخطأ، ولهذا السبب يمكن أن تختلف هذه السمة عن رمز الاستجابة المستهدَفة (target_response_code). |
المضيف الافتراضي | virtual_host | اسم المضيف الافتراضي
تم إجراء طلب بيانات من واجهة برمجة التطبيقات إلى. على سبيل المثال، تمتلك المؤسسات اثنتين
المضيفات الافتراضية تلقائيًا: default (http) وsecure (https). |
الرسائل الواردة/العميل | ||
عنوان IP للعميل | client_ip | عنوان IP للنظام الذي يصِل إلى جهاز التوجيه، مثل العميل الأصلي
(proxy_client_ip) أو موازن تحميل. عندما تكون هناك عناوين IP متعددة في
X-Forwarded-For ، هذا هو عنوان IP الأخير المدرج. |
فئة الجهاز | ax_ua_device_category | نوع الجهاز الذي تم إجراء طلب بيانات من واجهة برمجة التطبيقات منه، مثل "جهاز لوحي" أو "الهاتف الذكي". |
عائلة نظام التشغيل | ax_ua_os_family | مجموعة نظام تشغيل الجهاز الذي يُجري المكالمة، مثل "Android" أو "iOS". |
إصدار نظام التشغيل | ax_ua_os_version |
إصدار نظام تشغيل الجهاز الذي يجري المكالمة. من المفيد استخدام هذا كـ "توغّل" ثانٍ مع مجموعة نظام التشغيل (ax_ua_os_family) للاطّلاع على إصدارات أنظمة التشغيل. |
عنوان IP لعميل الوكيل | proxy_client_ip |
عنوان IP لعميل الاتصال، والذي تم تخزينه في |
عنوان IP للعميل المشار إليه | ax_true_client_ip | عند استخدام منتجات التوجيه مثل Akamai لتسجيل عناوين IP الحقيقية للعملاء،
يتم تمرير عناوين IP للعميل إلى Edge في عنوان HTTP لتحديد عنوان IP الأصلي للعميل، يمكن الوصول إليه من خلال |
مسار الطلب | request_path |
مسار المورد (لا يشمل النطاق) إلى الخدمة المستهدفة، باستثناء طلب البحث المعلَمات. على سبيل المثال، نموذج استهداف Apigee |
عنوان URI للطلب | request_uri |
مسار المورد (لا يشمل النطاق) إلى الخدمة المستهدفة، بما في ذلك طلب البحث المعلَمات. على سبيل المثال، نموذج استهداف Apigee |
طلب فعل | request_verb | يشير هذا المصطلح إلى فعل طلب HTTP في طلبات واجهة برمجة التطبيقات، مثل GET وPOST وPUT وDELETE. |
وكيل المستخدم | useragent |
اسم وكيل المستخدم أو وكيل البرامج المستخدَم لإجراء طلب بيانات من واجهة برمجة التطبيقات. أمثلة:
|
مجموعة وكيل المستخدم | ax_ua_agent_family | عائلة وكيل المستخدم، مثل "Chrome Mobile" أو "cURL". |
نوع وكيل المستخدم | ax_ua_agent_type | نوع وكيل المستخدم، مثل "المتصفح" و"مستعرض الهاتف المحمول" و"المكتبة" وهكذا |
إصدار وكيل المستخدم | ax_ua_agent_version |
إصدار وكيل المستخدم من المفيد استخدام هذا كـ "توغّل" ثانٍ مع مجموعة وكيل المستخدم (ax_ua_agent_family) للحصول على إصدار مجموعة الوكيل. |
الصادر/المستهدف | ||
المسار الأساسي المستهدف | target_basepath |
مسار المورد (لا يشمل النطاق) إلى الخدمة المستهدفة، باستثناء طلب البحث
المحدد في على سبيل المثال، لنفترض أنّ الخادم الوكيل لواجهة برمجة التطبيقات يستدعي الهدف التالي: <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> في هذا المثال، تكون قيمة target_basepath هي إذا كان الاستهداف هو هذا: <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net</URL> </HTTPTargetConnection> فسيكون target_basepath فارغًا. في أداة التتبُّع، عند
حدد أيقونة AX في نهاية مخطط التدفق،
|
المضيف المستهدف | target_host | مضيف الخدمة المستهدفة. على سبيل المثال، إذا استدعاء خادم وكيل لواجهة برمجة التطبيقات
http://mocktarget.apigee.net/help ، المضيف target_host هو
mocktarget.apigee.net |
عنوان IP المستهدف | target_ip | عنوان IP للخدمة المستهدفة التي تعرض الاستجابة للخادم الوكيل لواجهة برمجة التطبيقات. |
رمز الاستجابة المستهدَفة | target_response_code |
رمز حالة استجابة HTTP الذي تعرضه الخدمة المستهدفة على الخادم الوكيل لواجهة برمجة التطبيقات، مثل 200 و404 و503 وهكذا. قيمة "null" تعني أن الطلب لم يصل أبدًا إلى الخدمة المستهدفة. يحدث هذا عندما يتم عرض الاستجابة من خلال سياسة ذاكرة التخزين المؤقت للاستجابة أو عند حدوث خطأ في الطلب قيد المعالجة. ويختلف هذا عن رمز حالة الاستجابة (response_status_code). |
عنوان URL المستهدف | target_url |
عنوان URL الكامل للخدمة المستهدَفة المحدّدة في TargetEndpoint لخادم وكيل واجهة برمجة التطبيقات. <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> في هذا المثال، تكون قيمة target_url هي
تجدر الإشارة إلى أنّه يمكن أيضًا إلغاء عنوان URL أثناء معالجة الخادم الوكيل لواجهة برمجة التطبيقات باستخدام السمة
متغيّر التدفق في الخادم الوكيل بالتسلسل وعند استخدام النص البرمجي (Node.js)، يكون target_url في الخادم الوكيل للاستدعاء فارغًا. |
تمت إعادة توجيه X للحصول على | x_forwarded_for_ip | قائمة عناوين IP في العنوان لتحديد عنوان IP الأصلي للعميل، يمكن الوصول إليه من خلال |
الوقت | ||
يوم من الأسبوع | ax_day_of_week | اختصار اليوم المكوّن من ثلاثة أحرف والذي تم إجراء استدعاءات واجهة برمجة التطبيقات فيه. بالنسبة على سبيل المثال، إثنين، ثلاثاء، أربعاء. |
الشهر | ax_month_of_year | الشهر الرقمي الذي تم فيه إجراء طلبات البيانات من واجهة برمجة التطبيقات. على سبيل المثال: "03" لشهر مارس. |
الوقت | ax_hour_of_day |
استنادًا إلى تنسيق 24 ساعة، أي ساعة مكوّنة من رقمَين تم فيها إجراء طلبات البيانات من واجهة برمجة التطبيقات. على سبيل المثال: استدعاءات واجهة برمجة التطبيقات التي يتم إجراؤها في الساعة بين 10 مساءً و11 مساءً، ستكون ax_hour_of_day هي 22. يتم عرض قيمة الوقت بالتوقيت العالمي المنسّق (UTC). |
المنطقة الزمنية | ax_geo_timezone | الأسماء الشائعة للمناطق الزمنية التي تم إجراء استدعاءات واجهة برمجة التطبيقات منها، مثل أمريكا/نيويورك وأوروبا/دبلن. |
أسبوع من الشهر | ax_week_of_month | الأسبوع الرقمي من الشهر. على سبيل المثال، لطلبات البيانات من واجهة برمجة التطبيقات التي يتم إجراؤها في الأسبوع الثالث من الشهر، يكون ax_week_of_month هو 3. |
الموقع الجغرافي | ||
المدينة | ax_geo_city | المدينة التي تم إجراء طلبات البيانات من واجهة برمجة التطبيقات منها. |
القارة | ax_geo_continent | الرمز المكون من حرفين للقارة التي تم إجراء طلبات البيانات من واجهة برمجة التطبيقات منها. على سبيل المثال: أمريكا الشمالية. |
البلد | ax_geo_country | الرمز المكوَّن من حرفين للبلد الذي تم إجراء طلبات البيانات من واجهة برمجة التطبيقات منه. على سبيل المثال، US للولايات المتحدة. |
المنطقة الجغرافية | ax_geo_region | رمز الواصلة للمنطقة الجغرافية، مثل state-COUNTRY. على سبيل المثال: WA-US لواشنطن والولايات المتحدة. |
المنطقة | ax_dn_region | اسم مركز بيانات Apigee حيث يتم نشر الخوادم الوكيلة لواجهة برمجة التطبيقات، مثل us-east-1. |
تحقيق الربح | ||
إنشاء رسالة تجاهل المعاملة | x_apigee_mint_tx_ignoreMessage | علامة تحدد ما إذا كان سيتم تجاهل الرسائل المتعلقة بتحقيق الربح اضبط القيمة على false لجميع المؤسسات التي تحقّق الربح. |
حالة معاملة سكّ العُملة | x_apigee_mint_tx_status | تشير هذه الحالة إلى حالة طلب تحقيق الربح، مثل نجاحه أو عدم نجاحه أو أنّه غير صالح أو لا ينطبق. |
الفلاتر
تتيح لك الفلاتر حصر النتائج بمقاييس ذات خصائص معيّنة. إليك بعض الأمثلة فلاتر العينة. استخدِم أسماء أنماط واجهة برمجة التطبيقات للمقاييس والسمات عند تحديد الفلاتر.
عرض مقاييس للخوادم الوكيلة لواجهة برمجة التطبيقات مع كتب الأسماء أو الموسيقى:
filter=(apiproxy in 'books','music')
عرض مقاييس للخوادم الوكيلة لواجهة برمجة التطبيقات بأسماء تبدأ بـ "m":
filter=(apiproxy like 'm%')
عرض مقاييس للخوادم الوكيلة لواجهة برمجة التطبيقات بأسماء لا تبدأ بـ "m":
filter=(apiproxy not like 'm%')
تعرض مقاييس طلبات البيانات من واجهة برمجة التطبيقات التي تتضمّن رموز حالة الاستجابة بين 400 و599:
filter=(response_status_code ge 400 and response_status_code le 599)
تعرض مقاييس طلبات البيانات من واجهة برمجة التطبيقات برمز حالة الاستجابة 200 ورمز الاستجابة المستهدف 404:
filter=(response_status_code eq 200 and target_response_code eq 404)
تعرض مقاييس طلبات البيانات من واجهة برمجة التطبيقات برمز حالة الاستجابة 500:
filter=(response_status_code eq 500)
تعرض مقاييس طلبات البيانات من واجهة برمجة التطبيقات التي لم تؤدّي إلى حدوث أخطاء:
filter=(is_error eq 0)
في ما يلي عوامل التشغيل التي يمكنك استخدامها لإنشاء فلاتر للتقارير.
مُشغِّل | الوصف |
---|---|
in |
الإضافة إلى القائمة |
notin |
الاستبعاد من القائمة |
eq |
يساوي، == |
ne |
لا يساوي، != |
gt |
أكبر من، > |
lt |
أقل من، < |
ge |
أكبر من أو يساوي >= |
le |
أقل من أو يساوي، <= |
like |
تعرض القيمة true إذا كان نمط السلسلة يتطابق مع النمط المقدم. |
not like |
تعرض القيمة false إذا كان نمط السلسلة يتطابق مع النمط المقدم. |
similar to |
لعرض true أو false بناءً على ما إذا كان نمطه يطابق السلسلة المحددة. من المهم
تشبه like إلا أنها تفسر النمط باستخدام جدول SQL القياسي
تعريف التعبير العادي. |
not similar to |
لعرض false أو true بناءً على ما إذا كان نمطه يطابق السلسلة المحددة. من المهم
تشبه not like ، إلا أنها تفسر النمط باستخدام SQL
تعريف معياري للتعبير العادي. |
and |
يتيح لك استخدام "and" لتضمين أكثر من تعبير فلتر واحد. الفلتر يتضمن بيانات تفي بجميع الشروط. |
or |
يتيح لك استخدام "or" لتقييم تعبيرات التصفية المحتملة المختلفة. الفلتر يتضمن البيانات التي تفي بشرط واحد على الأقل. |