سیاست جمع آوری آمار

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

چه

شما را قادر می‌سازد تا آمار مربوط به داده‌های موجود در یک پیام، مانند شناسه محصول، قیمت، عملکرد REST، آدرس اینترنتی کلاینت و هدف و طول پیام را جمع‌آوری کنید. داده‌ها می‌توانند از متغیرهای جریان از پیش تعریف شده توسط 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 management UI برای ایجاد یک گزارش سفارشی استفاده کنید که داده‌های جمع‌آوری‌شده را در قالب‌های مختلف نشان می‌دهد.

برای آموزش کامل استفاده از خط‌مشی جمع‌آوری آمار، به «تحلیل محتوای پیام API با استفاده از تجزیه و تحلیل‌های سفارشی» مراجعه کنید.

کجا باید سیاست را قرار داد

شما می‌توانید یک سیاست جمع‌آوری آمار را در جریان درخواست یا پاسخ یک پروکسی API قرار دهید. با این حال، اگر چندین سیاست جمع‌آوری آمار را در یک پروکسی قرار دهید، آخرین سیاستی که اجرا می‌شود، داده‌های نوشته شده در سرور تحلیلی را تعیین می‌کند و داده‌های نوشته شده توسط هر سیاست جمع‌آوری آمار قبلی از بین می‌رود.

یکی از سناریوهایی که ممکن است در آن چندین سیاست جمع‌آوری آمار در یک پروکسی API داشته باشید، زمانی است که یکی از آنها را در جریان درخواست یا پاسخ و دیگری را در یک مدیریت‌کننده خطا دارید. اگر خطایی در پروکسی 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>

مرجع خطا

This section describes the error messages and flow variables that are set when this policy triggers an error. This information is important to know if you are developing fault rules for a proxy. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

None.

Deployment errors

Fault variables

None.

طرحواره

هر نوع سیاست توسط یک طرح XML ( .xsd ) تعریف می‌شود. برای مرجع، طرح‌های سیاست در GitHub موجود است.

مباحث مرتبط

برای اطلاعات بیشتر، مراجعه کنید به:

• تجزیه و تحلیل محتوای پیام API با استفاده از تجزیه و تحلیل‌های سفارشی
• مدیریت گزارش‌های سفارشی
• از APIهای معیار برای سنجش عملکرد برنامه API استفاده کنید