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

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

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

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

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

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

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

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

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

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

وتُعدّ سمة "اسم السياسة عند حدوث خطأ" (ax_execution_error_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)

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

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

في المقابل، يتم تنفيذ ذاكرة التخزين المؤقت للاستجابة بقيمة 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 الاستجابة.

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

بنية واجهة برمجة التطبيقات: 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") الذي تم استرداد ذاكرة التخزين المؤقت للاستجابة منه. تعرض هذه السمة أيضًا "CACHE_MISS" عند تلقّي الردّ من الهدف بدلاً من ذاكرة التخزين المؤقت (وإعادة تحميل ذاكرة التخزين المؤقت للاستجابة مع الاستجابة المستهدفة)، أو عندما يكون مفتاح ذاكرة التخزين المؤقت في الطلب غير صالح. يقتصر حجم مفاتيح ذاكرة التخزين المؤقت على 2 كيلوبايت.

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

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

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

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

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

هو تطبيق المطوّر المسجّل في Edge لإجراء طلبات البيانات من واجهة برمجة التطبيقات.

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

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

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

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

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

رقم تعريف المطوّر الفريد الذي أنشأه Edge في شكل org_name@@@unique_id.

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

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

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

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

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

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

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

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

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

يُرجى العلم أنّ الاسم الكامل الذي سيتم استخدامه في واجهة برمجة التطبيقات للإدارة هو ax_execution_error_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، تكون امتداد الملف المرجعي /json.

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

ويتم تخزين القيمة أيضًا في متغيّر التدفق 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 فارغًا، اضبط السمة ax_resolved_client_ip على (not set).

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

من المفيد استخدام هذا كسمة ثانية "للتوغُّل" مع نظام التشغيل Family (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 وما إلى ذلك.

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

ويختلف هذا الأمر عن سمة رمز حالة الاستجابة (response_status_code).

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

قائمة عناوين 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.

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