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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

الأدوات المستخدمة

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

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

نماذج

<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>

$ 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

{
  "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>

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

لمحة عن سياسة "أداة جمع الإحصاءات"

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

للوصول إلى البيانات الإحصائية التي تجمعها السياسة، يمكنك استخدام Edge API أو واجهة مستخدم إدارة Edge. على سبيل المثال، يمكنك استخدام واجهة مستخدم إدارة Edge لإنشاء تقرير مخصّص يعرض البيانات التي تم جمعها بتنسيقات متنوعة.

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

مكان وضع السياسة

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

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

لمزيد من المعلومات، اطّلِع على التعامل مع الأخطاء.

مرجع العنصر

يصف مرجع العنصر عناصر وسمات سياسة "أداة جمع الإحصاءات".

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Statistics-Collector-1">
    <DisplayName>Statistics Collector 1</DisplayName>
    <Statistics>
        <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
    </Statistics>
</StatisticsCollector>

سمات <StatisticsCollector>

<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Stats-1">

يصف الجدول التالي السمات المشتركة بين جميع العناصر الرئيسية للسياسة:

&lt;DisplayName&gt; عنصر

استخدِمه مع السمة name لتصنيف السياسة في إدارة خادم وكيل لواجهة المستخدم باسم مختلف بلغة طبيعية.

<DisplayName>Policy Display Name</DisplayName>

العنصر <Statistics>/<Statistic>

<Statistics>
    <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
</Statistics>

مرجع الخطأ

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

أخطاء وقت التشغيل

بلا عُري

أخطاء النشر

متغيّرات الأعطال

بلا عُري

المخطط

يتم تحديد كل نوع من أنواع السياسات من خلال مخطّط XML (.xsd). وللحصول على مرجع، تتوفّر مخطّطات السياسات على GitHub.

مواضيع ذات صلة

يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:

• تحليل محتوى رسائل واجهة برمجة التطبيقات باستخدام إحصاءات مخصّصة
• إدارة التقارير المخصّصة
• استخدام واجهات برمجة التطبيقات الخاصة بالمقاييس لقياس أداء برنامج واجهة برمجة التطبيقات