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

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

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

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

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

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

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

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

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

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

تكون سمة "اسم السياسة عند حدوث خطأ" (ax_execution_fault_policy_name) مفيدة لتجميع أخطاء السياسات حسب اسم السياسة.

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

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

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

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

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

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

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

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

حجم حمولة الطلب التي تلقّاها Edge، بالبايت

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

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

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

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

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

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

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

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

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

حجم حمولة الردّ التي يتم عرضها للعميل، بالبايت

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

إجمالي عدد الردود التي تتضمّن رمز الحالة 5xx من الخدمة المستهدَفة. هذه أخطاء في الخدمة المستهدَفة لا تتسبّب فيها Apigee.

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

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

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

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

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

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

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

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

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

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

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

في حال عدم استيفاء المعايير المذكورة أعلاه، ستظهر لك القيمة "(not set)". اطّلِع أيضًا على ماذا تعني قيمة كيان إحصائي "(not set)"؟

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

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

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

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

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

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

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

مفتاح العميل (مفتاح واجهة برمجة التطبيقات) لتطبيق المطوّر الذي يرسل طلبات البيانات من واجهة برمجة التطبيقات، سواء تم تمريره في الطلب كمفاتيح لواجهة برمجة التطبيقات أو تضمينه في رموز OAuth المميزة

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

في حال عدم استيفاء المعايير المذكورة أعلاه، ستظهر لك القيمة "(not set)". اطّلِع أيضًا على ماذا تعني قيمة كيان إحصائي "(not set)"؟

تطبيق المطوّر المسجَّل في Edge الذي يرسل طلبات إلى واجهة برمجة التطبيقات

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

في حال عدم استيفاء المعايير المذكورة أعلاه، ستظهر لك القيمة "(not set)". اطّلِع أيضًا على ماذا تعني قيمة كيان إحصائي "(not set)"؟

البريد الإلكتروني للمطوّرين المسجّلين في Edge الذين أرسل تطبيقهم طلبات البيانات من واجهة برمجة التطبيقات

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

في حال عدم استيفاء المعايير المذكورة أعلاه، ستظهر لك القيمة "(not set)". اطّلِع أيضًا على ماذا تعني قيمة كيان إحصائي "(not set)"؟

المعرّف الفريد للمطوّر الذي تم إنشاؤه على Edge، ويكون بالتنسيق org_name@@@unique_id.

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

في حال عدم استيفاء المعايير المذكورة أعلاه، ستظهر لك القيمة "(not set)". اطّلِع أيضًا على ماذا تعني قيمة كيان إحصائي "(not set)"؟

رمز الخطأ على سبيل المثال: messaging.adaptors.http.flow.GatewayTimeout

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

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

في حال عدم حدوث أي أخطاء، ستظهر لك القيمة "(not set)".

اسم حالات تدفّق خادم وكيل واجهة برمجة التطبيقات التي أدّت إلى ظهور أخطاء، مثل "PROXY_REQ_FLOW" أو "TARGET_RESP_FLOW"

يُرجى العِلم أنّ الاسم الكامل الذي يجب استخدامه في Management API هو ax_execution_fault_flow_state، بدون فاصل أسطر.

اسم السياسة التي أدّت إلى ظهور خطأ وتسبّبت في تعذُّر تنفيذ طلب البيانات من واجهة برمجة التطبيقات.

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

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

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

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

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

إذا لم يتم استخدام pathsuffix، تكون القيمة فارغة.

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

تحتوي هذه السمة على عنوان 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 هي null، اضبط قيمة ax_resolved_client_ip على (not set).

إصدار نظام تشغيل الجهاز الذي يجري المكالمة

من المفيد استخدام هذا الخيار كسمة "تفصيلية" ثانية مع "اسم عائلة نظام التشغيل" (ax_ua_os_family) للاطّلاع على إصدارات أنظمة التشغيل.

عنوان IP للعميل الذي يجري الاتصال، ويتم تخزينه في proxy.client.ip متغير التدفق. يكون هذا العنوان غالبًا هو عنوان X-Forwarded-For للمكالمة الواردة، وهو عنوان IP الذي تلقّاه Edge من آخر مصافحة TCP خارجية. يمكن أن يكون ذلك العميل الذي يجري الاتصال أو جهاز موازنة الحمل. عندما تتوفّر عناوين IP متعددة في العنوان X-Forwarded-For، يكون هذا هو آخر عنوان IP مُدرَج.

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

لتحديد عنوان IP الأصلي للعميل، والذي يمكن الوصول إليه من خلال السمة ax_resolved_client_ip، تستخدم Edge السمتَين ax_true_client_ip وx_forwarded_for_ip.

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

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

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

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

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

• هاتف 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) للحصول على إصدار فئة الوكيل.

مسار المورد (بدون تضمين النطاق) إلى الخدمة المستهدَفة، باستثناء مَعلمات طلب البحث، والذي تم تحديده في <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.

رمز حالة استجابة HTTP الذي تعرضه الخدمة المستهدَفة لخادم وكيل واجهة برمجة التطبيقات، مثل 200 و404 و503 وما إلى ذلك.

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

يختلف ذلك عن السمة رمز حالة الرد (response_status_code).

عنوان URL الكامل للخدمة المستهدَفة المحدّدة في TargetEndpoint لخادم وكيل API

<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 في الخادم الوكيل الذي يتم استدعاؤه فارغًا.

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

لتحديد عنوان IP الأصلي للعميل، والذي يمكن الوصول إليه من خلال السمة ax_resolved_client_ip، تستخدم Edge السمتَين ax_true_client_ip وx_forwarded_for_ip.

استنادًا إلى نظام التوقيت على مدار 24 ساعة، يشير هذا الحقل إلى الساعة المكوّنة من رقمَين والتي تم فيها طلب البيانات من واجهة برمجة التطبيقات. على سبيل المثال، إذا تمّ إجراء طلبات بيانات من واجهة برمجة التطبيقات في الساعة بين 10 مساءً و11 مساءً، ستكون قيمة ax_hour_of_day هي 22.

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