مرجع المقاييس والسمات والفلاتر في "إحصاءات Google"

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

هذا الموضوع هو مرجع لمقاييس الإحصاءات والسمات والفلاتر. لمزيد من السياق حول باستخدام هذه الأدوات، يُرجى الاطّلاع على نظرة عامة على "إحصاءات واجهة برمجة التطبيقات".

يعرِض هذا الموضوع أسماء المقاييس والسمات كما تظهر في واجهة المستخدِم وحسب حاجتك. لاستخدامها في طلبات بيانات من واجهة برمجة التطبيقات.

المقاييس

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

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

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

بنية واجهة برمجة التطبيقات: tps

نتيجة ذاكرة التخزين المؤقت cache_hit المجموع

عدد طلبات البيانات الناجحة من واجهة برمجة التطبيقات التي تستخدم ذاكرة التخزين المؤقت للاستجابة بدلاً من استجابة من الخدمة المستهدفة.

بنية واجهة برمجة التطبيقات: sum(cache_hit)

عدد عناصر ذاكرة التخزين المؤقت L1 ax_cache_l1_count متوسط، أدنى، حدّ أقصى

عرض عدد العناصر في ذاكرة التخزين المؤقت L1 (في الذاكرة) لكل معاملة عبر معاملة محددة فترة زمنية محددة. على سبيل المثال، إذا اخترت max لهذه الفترة من اليوم، خلال ذلك اليوم، يكون أعلى عدد من العناصر في ذاكرة التخزين المؤقت 12 عنصرًا لمعاملة معينة، فسيكون العدد 12. بالنسبة إلى avg، إذا كانت هناك ثلاث معاملات في الفترة الزمنية التي تقوم بالاستعلام عنها، ويكون عدد ذاكرة التخزين المؤقت 5 و6 و7، يكون المتوسط هو 6. L1 هي ذاكرة تخزين مؤقت في الذاكرة بدلاً من ذاكرة التخزين المؤقت لقاعدة بيانات L2، كما هو موضح في العناصر الداخلية لذاكرة التخزين المؤقت.

بنية واجهة برمجة التطبيقات: avg(ax_cache_l1_count)

أخطاء السياسة policy_error المجموع

إجمالي عدد أخطاء السياسة خلال الفترة الزمنية المحددة

تحدث أخطاء السياسة غالبًا عن طريق التصميم. على سبيل المثال، تعرض سياسة "مفتاح واجهة برمجة التطبيقات" ظهور خطأ عند تمرير مفتاح واجهة برمجة تطبيقات غير صالح في الطلب، وسياسة منع الارتفاع تعرض رسالة خطأ إذا تجاوز عدد طلبات البيانات من واجهة برمجة التطبيقات الحدّ الأقصى الذي تم تحديده في السياسة. إذًا، يفيد هذا المقياس في العثور على نقاط المشاكل المحتملة في واجهات برمجة التطبيقات. على سبيل المثال: قد تساعدك مقاييس Policy_error، المجمّعة حسب السمة developer_app، في اكتشاف انتهاء صلاحية مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز لتطبيق معيّن، أو قد تجد أن خادم وكيل محدد لواجهة برمجة التطبيقات يؤدي إلى حدوث العديد من أخطاء Spike Arrest، مما يقودك إلى اكتشاف أن فالحد الأقصى لارتفاع عدد مرات الاعتقال لدى الخادم الوكيل لا يراعي الزيادة في عدد الزيارات أثناء العطلات.

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

يُعد بُعد اسم السياسة المتعلق بالخطأ (ax_execution_FALSE_policy_name) مفيدًا بالنسبة إلى تجميع أخطاء السياسة حسب اسم السياسة.

لا يُعتبر إخفاق الهدف (مثل 404 أو 503) إخفاقًا في السياسة. تلك احتساب إخفاقات خادم وكيل واجهة برمجة التطبيقات (is_error).

بنية واجهة برمجة التطبيقات: sum(policy_error)

أخطاء الخادم الوكيل is_error المجموع

إجمالي عدد مرّات تعذُّر الخوادم الوكيلة لواجهة برمجة التطبيقات خلال الفترة الزمنية المحدّدة. الوكيل قد يحدث أي فشل عند إخفاق سياسة ما أو عند فشل بيئة التشغيل، مثل خطأ 404 أو 503 من الخدمة المستهدفة.

يُعد بُعد الخادم الوكيل (apiproxy) مفيدًا لتجميع حالات إخفاق خادم وكيل واجهة برمجة التطبيقات حسب الخادم الوكيل.

بنية واجهة برمجة التطبيقات: sum(is_error)

وقت استجابة معالجة الطلبات request_processing_latency متوسط، أدنى، حدّ أقصى

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

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

بنية واجهة برمجة التطبيقات: max(request_processing_latency)

حجم الطلب request_size مجموع، متوسط، دقيقة، كحد أقصى

حجم حمولة الطلب التي تم استلامها بواسطة Edge، بـ بايت

بنية واجهة برمجة التطبيقات: avg(request_size)

تم تنفيذ ذاكرة التخزين المؤقت للردود ax_cache_executed المجموع

إجمالي عدد المرات التي تم فيها تنفيذ سياسة ذاكرة التخزين المؤقت للردود خلال الفترة الزمنية المحدّدة الفترة.

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

ومع ذلك، يكون تنفيذ ذاكرة التخزين المؤقت للاستجابة 0 إذا كانت <SkipCacheLookup> في السياسة يتم تقييمه إلى true (في الطلب)، و0 إذا كانت قيمة <SkipCachePopulation> عنصر في السياسة يتم تقييمه على "صحيح" (في الاستجابة).

في أداة التتبُّع، يمكنك النقر على رمز ذاكرة التخزين المؤقت للاستجابة في استدعاء واجهة برمجة التطبيقات الذي تم تنفيذه وعرض متغيّر التدفق responsecache.executed إلى معرفة ما إذا كان هناك عملية تنفيذ لذاكرة التخزين المؤقت (القيمة 1) أم لا.

بنية واجهة برمجة التطبيقات: sum(ax_cache_executed)

وقت استجابة معالجة الردّ response_processing_latency متوسط، أدنى، حدّ أقصى

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

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

بنية واجهة برمجة التطبيقات: min(response_processing_latency)

حجم الردّ response_size مجموع، متوسط، دقيقة، كحد أقصى

حجم حمولة الاستجابة التي تم إرجاعها إلى العميل، بايت.

بنية واجهة برمجة التطبيقات: max(response_size)

أخطاء الاستهداف target_error المجموع

إجمالي عدد 5xx إجابة من الخدمة المستهدفة. هذه هي الخدمات المستهدفة الأخطاء التي لم تنتج عن Apigee.

بنية واجهة برمجة التطبيقات: sum(target_error)

وقت الاستجابة المستهدَف target_response_time مجموع، متوسط، دقيقة، كحد أقصى

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

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

بنية واجهة برمجة التطبيقات: avg(target_response_time)

إجمالي وقت الاستجابة total_response_time مجموع، متوسط، دقيقة، كحد أقصى

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

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

بنية واجهة برمجة التطبيقات: avg(total_response_time)

حركة المرور message_count المجموع

إجمالي عدد طلبات البيانات من واجهة برمجة التطبيقات التي تعالجها Edge في الفترة الزمنية المحدّدة.

استخدِم السمات لتجميع أعداد الزيارات بطرق مفيدة جدًا بالنسبة إليك.

بنية واجهة برمجة التطبيقات: sum(message_count)

الأبعاد

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

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

اسم التقارير المخصّصة الاسم المطلوب استخدامه في واجهة برمجة تطبيقات الإدارة الوصف
كيانات Apigee
رمز الدخول access_token رمز دخول OAuth للمستخدم النهائي للتطبيق.
منتج واجهة برمجة التطبيقات api_product

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

في حال عدم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجع أيضًا ما الذي تعنيه قيمة كيان التحليلات "(not set)" أعني؟.

مفتاح ذاكرة التخزين المؤقت ax_cache_key

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

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

اسم ذاكرة التخزين المؤقت ax_cache_name

اسم ذاكرة التخزين المؤقت التي تحتوي على المفاتيح/القيم التي تستخدمها سياسة ذاكرة التخزين المؤقت للاستجابة مسبوقة بـ orgName__envName__. على سبيل المثال، إذا كانت المؤسسة هي "foo"، الـ بيئة التشغيل هي "test" واسم ذاكرة التخزين المؤقت هو "mycache"، يكون ax_cache_name foo__test__myCache.

في أداة التتبُّع، عند اختيار سياسة ذاكرة التخزين المؤقت للردود، يمكنك رؤية هذه القيمة في متغيّر التدفق responsecache.cachename.

مصدر ذاكرة التخزين المؤقت ax_cache_source

مستوى ذاكرة التخزين المؤقت (قاعدة البيانات "L1" في الذاكرة أو "L2") الذي تم إنشاء استرداده. تعرض هذه السمة أيضًا "CACHE_MISS" وقت تسليم الرد من الهدف بدلاً من ذاكرة التخزين المؤقت (وتم تحديث ذاكرة التخزين المؤقت للاستجابة بالاستجابة المستهدفة) أو عندما يكون مفتاح ذاكرة التخزين المؤقت في الطلب غير صالح. تقتصر مفاتيح ذاكرة التخزين المؤقت على حجم 2 كيلوبايت

في أداة التتبُّع، عند اختيار سياسة ذاكرة التخزين المؤقت للردود، يمكنك رؤية هذه القيمة في متغيّر التدفق responsecache.cachesource.

للحصول على مزيد من المعلومات حول مستويات ذاكرة التخزين المؤقت، يُرجى الاطّلاع على العناصر الداخلية لذاكرة التخزين المؤقت.

معرِّف العميل 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

رمز الخطأ للخطأ. مثل: messaging.adaptors.http.flow.GatewayTimeout

اسم التدفق عند وجود خطأ 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، بدون فاصل أسطر.

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

الخادم الوكيل خادم وكيل اسم الجهاز (وليس الاسم المعروض) للخادم الوكيل لواجهة برمجة التطبيقات.
المسار الأساسي للخادم الوكيل proxy_basepath

BasePath الذي تم ضبطه على الخادم الوكيل لواجهة برمجة التطبيقات ProxyEndpoint لا يشتمل المسار الأساسي على النطاق والمنفذ لعنوان URL للخادم الوكيل لواجهة برمجة التطبيقات. على سبيل المثال، إذا كان عنوان URL الأساسي لخادم وكيل واجهة برمجة التطبيقات هو https://apigeedocs-test.apigee.net/releasenotes/، المسار الأساسي هو /releasenotes.

يتم أيضًا تخزين القيمة في متغيّر التدفق proxy.basepath.

لاحقة مسار الخادم الوكيل proxy_pathsuffix

مسار المورد الذي تمت إضافته إلى المسار الأساسي للخادم الوكيل لواجهة برمجة التطبيقات. على سبيل المثال، إذا كانت واجهة برمجة التطبيقات الوكيلة عنوان URL الأساسي هو https://apigeedocs-test.apigee.net/hello/، ويتم إجراء طلب https://apigeedocs-test.apigee.net/hello/json، اللاحقة هي /json

وفي حال عدم استخدام أي لاحقة، تكون القيمة فارغة.

يتم أيضًا تخزين القيمة في متغيّر التدفق proxy.pathsuffix.

مراجعة الخادم الوكيل apiproxy_revision رقم النسخة السابقة للخادم الوكيل لواجهة برمجة التطبيقات الذي عالج طلبات البيانات من واجهة برمجة التطبيقات. هذا ليس بالضرورة آخر مراجعة لخادم وكيل واجهة برمجة التطبيقات. إذا كان خادم وكيل واجهة برمجة التطبيقات يحتوي على 10 مراجعات، فإن قد يتم نشر المراجعة حاليًا. أيضًا، قد يكون لواجهة برمجة التطبيقات مراجعات متعددة تم نشرها طالما أن النُسخ تحتوي على مسارات أساسية مختلفة، كما هو موضَّح في نشر الخوادم الوكيلة في واجهة المستخدم.
عنوان IP للعميل الذي تم حله ax_resolved_client_ip

يحتوي على عنوان IP المصدر للعميل. قيمة ax_resolved_client_ip يتم احتسابه من القيم في ax_true_client_ip سمتان (x_forwarded_for_ip)

لاحظ أنه عند استخدام منتجات التوجيه مثل Akamai لتسجيل عناوين IP الحقيقية للعملاء، يتم تمرير عنوان IP للعميل إلى Edge في عنوان HTTP True-Client-IP، وهو ثم يُستخدم لضبط سمة ax_true_client_ip.

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

  1. إذا لم يكن ax_true_client_ip فارغًا ولا يحتوي على عنوان IP محلي، ثم اضبط ax_resolved_client_ip على ax_true_client_ip.
  2. بخلاف ذلك، اضبط ax_resolved_client_ip على أول عنوان IP غير محلي في x_forwarded_for_ip
  3. إذا احتوى كل من ax_true_client_ip وx_forwarded_for_ip على عناوين IP محلية فقط، ثم اضبط ax_resolved_client_ip على أول عنوان IP محلي في x_forwarded_for_ip.
  4. إذا كانت قيمة كل من ax_true_client_ip وx_forwarded_for_ip فارغة، ضبط ax_resolved_client_ip على (not set)
  5. إذا كان ax_true_client_ip هو عنوان IP محلي وx_forwarded_for_ip قيمة خالية، تم ضبط ax_resolved_client_ip على (not set).
رمز حالة الردّ 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 لعميل الاتصال، والذي تم تخزينه في proxy.client.ip متغيّر التدفق. وغالبًا ما يكون هذا هو عنوان X-Forwarded-For للمكالمات الواردة. وهو عنوان IP الذي تم استلامه على Edge من آخر عملية تأكيد اتصال لبروتوكول TCP الخارجي. يمكن أن تكون عميل الاتصال أو جهاز موازنة الحمل. عندما تكون هناك عناوين IP متعددة في X-Forwarded-For، هذا هو عنوان IP الأخير المدرج.

عنوان IP للعميل المشار إليه ax_true_client_ip

عند استخدام منتجات التوجيه مثل Akamai لتسجيل عناوين IP الحقيقية للعملاء، يتم تمرير عناوين IP للعميل إلى Edge في عنوان HTTP True-Client-IP. هذا النمط التالي عناوين IP الحقيقية للعميل من ذلك العنوان.

لتحديد عنوان IP الأصلي للعميل، يمكن الوصول إليه من خلال ax_resolved_client_ip. فإن شبكة Edge تستخدم ax_true_client_ip سمتان (x_forwarded_for_ip)

مسار الطلب request_path

مسار المورد (لا يشمل النطاق) إلى الخدمة المستهدفة، باستثناء طلب البحث المعلَمات.

على سبيل المثال، نموذج استهداف Apigee http://mocktarget.apigee.net يتضمن العديد من الموارد، بما في ذلك /user، التي تعرض رسالة ترحيب. بغض النظر عن طريقة استدعاء خادم وكيل واجهة برمجة التطبيقات http://mocktarget.apigee.net/user، قيمة request_path هي /user.

عنوان URI للطلب request_uri

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

على سبيل المثال، نموذج استهداف Apigee http://mocktarget.apigee.net يتضمّن عدّة مصادر، بما في ذلك مورد و/user?user={name} طلب بحث لإرجاع رسالة ترحيب مخصصة إلى الاسم المقدم. بغض النظر عن كيفية استخدام واجهة برمجة التطبيقات يستدعي الخادم الوكيل http://mocktarget.apigee.net/user?user=Dude، فإن request_uri هو /user?user=Dude

طلب فعل request_verb يشير هذا المصطلح إلى فعل طلب HTTP في طلبات واجهة برمجة التطبيقات، مثل GET وPOST وPUT وDELETE.
وكيل المستخدم useragent

اسم وكيل المستخدم أو وكيل البرامج المستخدَم لإجراء طلب بيانات من واجهة برمجة التطبيقات. أمثلة:

  • جهاز Pixel XL يجري مكالمة من خلال Chrome: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36
  • جهاز iPad يجري مكالمة من خلال Chrome: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1
  • طلب cURL من الوحدة الطرفية: curl/7.51.0
مجموعة وكيل المستخدم ax_ua_agent_family عائلة وكيل المستخدم، مثل "Chrome Mobile" أو "cURL".
نوع وكيل المستخدم ax_ua_agent_type نوع وكيل المستخدم، مثل "المتصفح" و"مستعرض الهاتف المحمول" و"المكتبة" وهكذا
إصدار وكيل المستخدم ax_ua_agent_version

إصدار وكيل المستخدم

من المفيد استخدام هذا كـ "توغّل" ثانٍ مع مجموعة وكيل المستخدم (ax_ua_agent_family) للحصول على إصدار مجموعة الوكيل.

الصادر/المستهدف
المسار الأساسي المستهدف target_basepath

مسار المورد (لا يشمل النطاق) إلى الخدمة المستهدفة، باستثناء طلب البحث المحدد في <TargetEndpoint> للخادم الوكيل.

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

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

في هذا المثال، تكون قيمة target_basepath هي /user.

إذا كان الاستهداف هو هذا:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

فسيكون target_basepath فارغًا.

في أداة التتبُّع، عند حدد أيقونة AX في نهاية مخطط التدفق، target.basepath ربط متغيّر التدفق target_basepath.

المضيف المستهدف 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 هي http://mocktarget.apigee.net/user?user=Dude

تجدر الإشارة إلى أنّه يمكن أيضًا إلغاء عنوان URL أثناء معالجة الخادم الوكيل لواجهة برمجة التطبيقات باستخدام السمة متغيّر التدفق target.url

في الخادم الوكيل بالتسلسل وعند استخدام النص البرمجي (Node.js)، يكون target_url في الخادم الوكيل للاستدعاء فارغًا.

تمت إعادة توجيه X للحصول على x_forwarded_for_ip

قائمة عناوين IP في العنوان X-Forwarded-For.

لتحديد عنوان IP الأصلي للعميل، يمكن الوصول إليه من خلال ax_resolved_client_ip. فإن شبكة Edge تستخدم ax_true_client_ip سمتان (x_forwarded_for_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" لتقييم تعبيرات التصفية المحتملة المختلفة. الفلتر يتضمن البيانات التي تفي بشرط واحد على الأقل.