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

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

المزايا

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

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

نماذج

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

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

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

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

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

مواضع عرض السياسة

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة المناولة الأخطاء.

مرجع العنصر

يصف مرجع العنصر عناصر وسمات مجمِّع الإحصاءات .

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

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

<DisplayName> عنصر

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

<DisplayName>Policy Display Name</DisplayName>

<Statistics>/<Statistic> عنصر

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

مرجع الخطأ

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

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

بلا عُري

أخطاء النشر

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

بلا عُري

المخطط

يتم تحديد كل نوع سياسة من خلال مخطّط XML (.xsd). يمكنك الرجوع إلى مخططات السياسات المتوفرة على جيت هب.

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

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

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