يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
يمثّل هذا الموضوع مرجعًا للمقاييس والسمات والفلاتر في "إحصاءات Google". لمزيد من السياق حول استخدام هذه الأدوات، يُرجى الاطّلاع على نظرة عامة على إحصاءات واجهات برمجة التطبيقات.
يعرض هذا الموضوع أسماء المقاييس والسمات كما تظهر في واجهة المستخدم وبما أنّك تحتاج إلى استخدامها في طلبات البيانات من واجهة برمجة التطبيقات.
- سترى أسماء واجهة المستخدم عند إنشاء تقارير مخصّصة.
- استخدِم الأسماء الخاصة بواجهة برمجة التطبيقات عند الحصول على مقاييس أو إنشاء تعريف تقرير أو تعديل تعريف تقرير.
المقاييس
في ما يلي مقاييس واجهة برمجة التطبيقات التي يمكنك استردادها في التقارير المخصّصة وطلبات إدارة واجهة برمجة التطبيقات.
اسم التقارير المخصّصة | الاسم الذي تريد استخدامه في واجهة برمجة التطبيقات للإدارة | الدوال | الوصف |
---|---|---|---|
متوسط المعاملات في الثانية | نقطة مئوية | لا ينطبق |
متوسط عدد المعاملات، ما يعني طلبات الخادم الوكيل لواجهة برمجة التطبيقات، في الثانية. تجدر الإشارة إلى أنّه إذا كان لديك عدد قليل نسبيًا من المعاملات خلال الفترة الزمنية، قد يظهر متوسط عدد المعاملات في الثانية باعتباره صفرًا في التقارير المخصّصة لواجهة المستخدم إذا كان الرقم أصغر من منزلتين عشريتين. بنية واجهة برمجة التطبيقات: |
نتيجة ذاكرة التخزين المؤقت | cache_hit | المجموع |
عدد طلبات البيانات من واجهة برمجة التطبيقات الناجحة التي تستخدم ذاكرة التخزين المؤقت للاستجابة بدلاً من الاستجابة من الخدمة المستهدَفة. بنية واجهة برمجة التطبيقات: |
عدد عناصر ذاكرة التخزين المؤقت L1 | ax_cache_l1_count | متوسط، الحد الأدنى، الحد الأقصى |
يتم عرض عدد العناصر في ذاكرة التخزين المؤقت L1 (في الذاكرة) لكل معاملة خلال فترة زمنية معيّنة. على سبيل المثال، إذا اخترت بنية واجهة برمجة التطبيقات: |
أخطاء السياسة | policy_error | المجموع |
إجمالي عدد الأخطاء المتعلقة بالسياسة خلال الفترة الزمنية المحددة. تحدث أخطاء السياسة عادةً حسب التصميم. على سبيل المثال، تعرض سياسة "التحقق من مفتاح واجهة برمجة التطبيقات" رسالة خطأ عند تمرير مفتاح غير صالح لواجهة برمجة التطبيقات في الطلب، وتؤدي سياسة "منع الارتفاع" إلى ظهور خطأ إذا تجاوز عدد طلبات البيانات من واجهة برمجة التطبيقات الحدّ المسموح به في السياسة. إذًا، يُعد هذا المقياس مفيدًا للعثور على نقاط المشاكل المحتمَلة في واجهات برمجة التطبيقات. على سبيل المثال، قد تساعدك مقاييس policy_error، مجمّعة حسب سمة developer_app، في اكتشاف أنّ صلاحية مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميّز قد انتهت في تطبيق معيّن، أو قد يتبيّن لك أنّ خادمًا وكيلاً معيّنًا لواجهة برمجة التطبيقات يعرض الكثير من أخطاء التثبيط، ما يجعلك تكتشف أنّ الحدّ الأقصى المسموح به لإيقاف استخدام الخادم الوكيل لا يراعي زيادةً في عدد الزيارات خلال موسم الأعياد. يتم تسجيل خطأ متعلق بالسياسة في "إحصاءات Google" فقط إذا أدى الخطأ إلى حدوث خلل في الخادم الوكيل لواجهة برمجة التطبيقات.
على سبيل المثال، إذا تم ضبط سمة وتُعدّ سمة "اسم السياسة عند حدوث خطأ" (ax_execution_error_policy_name) مفيدةً في تجميع أخطاء السياسة حسب اسم السياسة. لا يتم اعتبار الفشل المستهدف (مثل الخطأ 404 أو 503) بمثابة إخفاق في السياسة. يتم احتساب هذه الأخطاء على أنّها حالات تعذُّر في الخادم الوكيل لواجهة برمجة التطبيقات (is_error). بنية واجهة برمجة التطبيقات: |
أخطاء الخادم الوكيل | is_error | المجموع |
إجمالي عدد المرات التي تعذّر فيها استخدام الخوادم الوكيلة لواجهة برمجة التطبيقات خلال الفترة الزمنية المحدّدة. ويمكن أن يحدث خلل الخادم الوكيل عند تعذُّر تنفيذ سياسة أو عند حدوث خطأ في وقت التشغيل، مثل الخطأ 404 أو 503 في الخدمة الهدف. تُعد سمة الخادم الوكيل (apiproxy) مفيدة لتجميع حالات الإخفاق في الخادم الوكيل لواجهة برمجة التطبيقات حسب الخادم الوكيل. بنية واجهة برمجة التطبيقات: |
وقت استجابة معالجة الطلبات | request_processing_latency | متوسط، الحد الأدنى، الحد الأقصى |
مقدار الوقت (المتوسط أو الحد الأدنى أو الأقصى) بالمللي ثانية الذي يستغرقه متصفّح Edge لمعالجة الطلبات الواردة. ويبدأ الوقت عندما يصل الطلب إلى Edge وينتهي عندما يعيد Edge الطلب إلى الخدمة المستهدَفة. باستخدام سمات مختلفة، يمكنك فحص أوقات الاستجابة لمعالجة الطلبات حسب الخادم الوكيل لواجهة برمجة التطبيقات أو تطبيق المطوِّر والمنطقة، وما إلى ذلك. بنية واجهة برمجة التطبيقات: |
حجم الطلب | request_size | مجموع، متوسط، الحد الأدنى، الحد الأقصى |
حجم حمولة الطلب الذي يتلقّاه Edge، بالبايت. بنية واجهة برمجة التطبيقات: |
تم تنفيذ ذاكرة التخزين المؤقت للاستجابة | ax_cache_executed | المجموع |
إجمالي عدد المرات التي تم فيها تنفيذ سياسة ذاكرة التخزين المؤقت للاستجابة خلال الفترة الزمنية المحدّدة. بما أنّ سياسة "ذاكرة التخزين المؤقت للاستجابة" مرفقة في مكانَين في خادم وكيل لواجهة برمجة التطبيقات (مرة في الطلب ومرة في الاستجابة)، يتم عادةً تنفيذ هذه السياسة مرتين في طلب بيانات من واجهة برمجة التطبيقات. يتم احتساب كل من ذاكرة التخزين المؤقت "get" وذاكرة التخزين المؤقت "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"(غير محدّد)؟. |
تطبيق المطوّر | developer_app |
هو تطبيق المطوّر المسجّل في Edge لإجراء طلبات البيانات من واجهة برمجة التطبيقات. للحصول على هذا البُعد، يجب ربط التطبيقات بمنتج واحد أو أكثر من منتجات واجهة برمجة التطبيقات التي تحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم طلبها، ويجب أن تتحقق الخوادم الوكيلة من مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز الذي تم إرساله مع طلب البيانات من واجهة برمجة التطبيقات. ويحدِّد المفتاح أو الرمز المميّز التطبيق الخاص بمطوّر البرامج. ولمزيد من المعلومات، راجِع المقالة النقاط الأولى أولاً: كيفية إنشاء بيانات إحصاءات كاملة. إذا لم يتم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجِع أيضًا ما معنى قيمة كيان "إحصاءات Google"(غير محدّد)؟. |
البريد الإلكتروني الخاص بمطوّر البرامج | developer_email |
البريد الإلكتروني للمطوّرين المسجَّلين في Edge والذين أجرى تطبيقهم طلبات البيانات من واجهة برمجة التطبيقات. للحصول على هذا البُعد، يجب أن يكون لدى المطوّرين تطبيقات مرتبطة بمنتج واحد أو أكثر من منتجات واجهة برمجة التطبيقات التي تحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم طلبها، ويجب أن تتحقق الخوادم الوكيلة بحثًا عن مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز الذي تم إرساله مع طلب البيانات من واجهة برمجة التطبيقات. ويحدِّد المفتاح أو الرمز المميّز التطبيق الخاص بمطوِّر البرامج. ولمزيد من المعلومات، يُرجى الاطّلاع على النقاط الأولى أولاً: كيفية إنشاء بيانات إحصاءات كاملة. إذا لم يتم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجِع أيضًا ما معنى قيمة كيان "إحصاءات Google"(غير محدّد)؟. |
الرقم التعريفي للمطوّر | مطوّر |
رقم تعريف المطوّر الفريد الذي أنشأه Edge في شكل org_name@@@unique_id. للحصول على هذا السمة، يجب أن يكون لدى المطوّرين تطبيقات مرتبطة بمنتج واحد أو أكثر من منتجات واجهة برمجة التطبيقات التي تحتوي على الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم طلبها، ويجب أن تتحقق الخوادم الوكيلة من مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز الذي تم إرساله مع طلبات البيانات من واجهة برمجة التطبيقات. ويحدِّد المفتاح أو الرمز المميَّز المطوِّر. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على النقاط الأولى أولاً: كيفية إنشاء بيانات تحليلية كاملة. إذا لم يتم استيفاء المعايير السابقة، ستظهر لك القيمة "(not set)". راجِع أيضًا ما معنى قيمة كيان "إحصاءات Google"(غير محدّد)؟. |
البيئة | بيئة | يشير ذلك المصطلح إلى بيئة Edge التي يتم فيها نشر الخوادم الوكيلة لواجهة برمجة التطبيقات. على سبيل المثال، "test" أو "prod". |
رمز الخطأ عند وجود الخطأ | ax_edge_execution_fault_code |
رمز الخطأ للخطأ. مثلاً:
|
اسم التدفق عند وجود الخطأ | ax_execution_fault _flow_name |
مسار العملية flow المُسمَّى في خادم وكيل لواجهة برمجة التطبيقات والذي تسبب في حدوث خطأ. على سبيل المثال، "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_error_flow_state، بدون فواصل أسطر. |
رقم تعريف مسار البوابة | gateway_flow_id | وأثناء انتقال طلبات البيانات من واجهة برمجة التطبيقات عبر Edge، يحصل كل اتصال على معرّف تدفق البوابة الخاص به. مثال: rrt329ea-12575-114653952-1. يُعدّ رقم تعريف تدفق البوابة مفيدًا للتمييز بين المقاييس في الحالات التي تكون فيها قيمة TPS عالية، وتكون السمات الأخرى مثل المؤسسة والبيئة والطابع الزمني متطابقة على مستوى جميع الطلبات. |
مؤسسة | مؤسسة | مؤسسة Edge التي يتم فيها نشر الخوادم الوكيلة لواجهة برمجة التطبيقات. |
اسم السياسة عند حدوث خطأ | ax_execution_fault _policy_name |
اسم السياسة التي أدّت إلى حدوث خطأ وتسببت في تعذُّر طلب البيانات من واجهة برمجة التطبيقات. يُرجى العلم أنّ الاسم الكامل الذي سيتم استخدامه في واجهة برمجة التطبيقات للإدارة هو ax_execution_error_policy_name، بدون فواصل أسطر. إذا عرضت سياسة خطأ ولكن تم ضبط سمة الجذر للسياسة |
الخادم الوكيل | apiproxy | اسم الجهاز (وليس الاسم المعروض) لخادم وكيل لواجهة برمجة التطبيقات. |
المسار الأساسي للخادم الوكيل | 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 |
إصدار نظام تشغيل الجهاز الذي يجري المكالمة من المفيد استخدام هذا كسمة ثانية "للتوغُّل" مع نظام التشغيل Family (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. |
وكيل المستخدم | وكيل المستخدم |
اسم وكيل المستخدم أو وكيل البرنامج المستخدَم لإجراء طلب البيانات من واجهة برمجة التطبيقات أمثلة:
|
عائلة وكيل المستخدم | 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 وما إلى ذلك. تعني القيمة "فارغ" أنّ الطلب لم يصل إلى الخدمة المستهدَفة مطلقًا. ويحدث هذا عندما يتم عرض الاستجابة من خلال سياسة ذاكرة التخزين المؤقت للاستجابة أو عندما يتعذّر معالجة الطلب. ويختلف هذا الأمر عن سمة رمز حالة الاستجابة (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. تكون قيمة الوقت بالتوقيت العالمي المنسق. |
المنطقة الزمنية | 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 |
يتيح لك استخدام منطق "و" لتضمين أكثر من تعبير فلتر واحد. يتضمّن الفلتر بيانات تستوفي جميع الشروط. |
or |
يتيح لك استخدام منطق "أو" لتقييم تعبيرات فلاتر مختلفة محتملة. يتضمّن الفلتر بيانات تستوفي شرطًا واحدًا على الأقل. |