سياسة مُحصِّل الإحصاءات

مثال أساسي

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="productID" ref="product.id" type="string">999999</Statistic>
    <Statistic name="price" ref="product.price" type="string">0</Statistic>
  </Statistics>
</StatisticsCollector>

في هذا المثال، تجمع معلومات إحصائية حول متغيّرَين مخصّصَين: product.id وproduct.price. وفي كل طلب، تكتب سياسة جهة جمع الإحصاءات قيمة هذين المتغيّرين في خادم الإحصاءات.

يحدّد هذا المثال أيضًا قيمة تلقائية اختيارية لكل متغيّر، حيث تكون القيمة التلقائية للسمة product.id هي 999999 والقيمة التلقائية للسمة product.price هي 0. إذا كان المتغيّر غير محدّد ولم تحدّد قيمة تلقائية، لن يتم تسجيل أي بيانات للمتغيّر. إذا حددت قيمة تلقائية، سيتم تسجيل القيمة التلقائية عندما يكون المتغيّر غير محدّد.

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

الوصول إلى الإحصاءات

في هذا المثال، يتم استخدام واجهة برمجة تطبيقات إدارة Edge لعرض البيانات الإحصائية للمجموعة التي تُسمى productID. ينشئ هذا الطلب تقريرًا مخصصًا لمعرّفات المنتجات استنادًا إلى مجموع أعداد الرسائل المُرسَلة لكل معرّف منتج في كل يوم. استبدِل اسم مؤسستك بالمتغيّر {org_name} واستبدل عنوان البريد الإلكتروني وكلمة المرور لحسابك على Apigee Edge بـ email:password.

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

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/environments/test/stats/productID?"select=sum(message_count)&timeRange=1/19/2015%2000:00~6/21/2015%2000:00&timeUnit=day"
-u email:password

في الردّ، يحتوي حقل name على معرّف المنتج وتعرض القيمة عدد الطلبات لكل يوم:

{
  "environments" : [ {
    "dimensions" : [ {
      "metrics" : [ {
        "name" : "sum(message_count)",
        "values" : [ {
          "timestamp" : 1353369600000,
          "value" : "4.0"
        } ]
      } ],
      "name" : "52"
    }, {
      "metrics" : [ {
        "name" : "sum(message_count)",
        "values" : [ {
          "timestamp" : 1353369600000,
          "value" : "19.0"
        } ]
      } ],
      "name" : "14"
    }, ...
  } ],
  "metaData" : {
    "samplingRate" : "100"
  }
}

استخراج البيانات للجمع

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="GetWeatherData">
    <VariablePrefix>weather</VariablePrefix>
    <XMLPayload>
       <Namespaces>
          <Namespace prefix="yweather">http://xml.weather.yahoo.com/ns/rss/1.0</Namespace>
       </Namespaces>
       <Variable name="location" type="string">
          <XPath>/rss/channel/yweather:location/@city</XPath>
       </Variable>
       <Variable name="condition" type="string">
          <XPath>/rss/channel/item/yweather:condition/@text</XPath>
       </Variable>
    </XMLPayload>
</ExtractVariables>

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

في هذا المثال، يتم استخدام سياسة "استخراج المتغيّرات" لاستخراج البيانات من حمولة XML التي تتضمّن معلومات الطقس. تساعد هذه السياسة في تحقيق ما يلي:

• استخراج اسم المدينة وكتابتها إلى متغير يسمى weather.location
• لاستخراج الظروف الحالية وكتابتها إلى متغير يسمى weather.condition

يمكنك بعد ذلك استخدام سياسة جهة جمع الإحصاءات لجمع معلومات عن المتغيّرات، كما هو موضّح أدناه:

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="weatherLocation" ref="weather.location" type="string"></Statistic>
    <Statistic name="weatherCondition" ref="weather.condition" type="string"></Statistic>
  </Statistics>
</StatisticsCollector>

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