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

مثال أساسي

<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 لسياسة أداة الحصول على الإحصاءات، يُرجى الاطّلاع على مقالة تحليل محتوى رسالة واجهة برمجة التطبيقات باستخدام الإحصاءات المخصّصة.