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

مثال أساسي

<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 عند كل طلب، يتم عرض تكتب سياسة Statistics Collector قيمة هذين المتغيرين في أداة التحليلات الخادم.

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

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

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

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

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

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