خط‌مشی StatisticsCollector

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

چه

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

درباره خط‌مشی «جمع‌آورنده آمار»

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

برای دسترسی به داده‌های آماری جمع‌آوری‌شده توسط خط‌مشی، از Edge API یا Edge UI مدیریت استفاده می‌کنید. برای مثال، می‌توانید از «واسط کاربر مدیریت Edge» برای ایجاد گزارش سفارشی استفاده کنید که داده‌های جمع‌آوری‌شده را در قالب‌های مختلف نشان می‌دهد.

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

خط‌مشی را کجا قرار دهیم

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

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

مرجع خطا

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

خطاهای زمان اجرا

هیچ‌کدام.

خطاهای استقرار

متغیرهای خطا

هیچ‌کدام.

طرح

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

موضوعات مرتبط

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

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