מדיניות בנושא סטטיסטיקות איסוף

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

מה

מאפשר לאסוף נתונים סטטיסטיים של נתונים בהודעה, כמו מזהה מוצר, מחיר, REST פעולה, כתובת URL של לקוח ויעד ואורך ההודעה. הנתונים יכולים להגיע ממשתני זרימה מוגדר מראש על ידי Apigee או משתנים מותאמים אישית שאתם מגדירים.

נתוני הנתונים הסטטיסטיים מועברים לשרת ניתוח הנתונים, שמנתח את הנתונים הסטטיסטיים יוצר דוחות. אפשר לצפות בדוחות באמצעות ממשק המשתמש של Edge management או 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 כדי ליצור דוח בהתאמה אישית מציג את הנתונים שנאספו במגוון פורמטים.

למדריך המלא בנושא השימוש במדיניות של Statistics Collector (איסוף נתונים סטטיסטיים), ראו Analyze API" תוכן של הודעות באמצעות ניתוח נתונים בהתאמה אישית.

איפה להציב את המדיניות

אפשר להגדיר מדיניות לאיסוף נתונים סטטיסטיים בתהליך הבקשה או התגובה של API שרת proxy. עם זאת, אם מציבים בשרת proxy מספר כללי מדיניות של Statistics Collector, אחד ליישום קובע את הנתונים שנכתבו לשרת הניתוח ואת הנתונים שנכתבו על ידי כל המדיניות הקודמת של 'אוסף הנתונים הסטטיסטיים' אבד.

תרחיש אחד שבו עשויים להיות לכם כמה כללי מדיניות לאיסוף נתונים סטטיסטיים בשרת proxy ל-API הוא כשיש לכם קוד אחד בתהליך הבקשה או התגובה, וקובץ אחד נוסף ב-handler של תקלות. אם מדובר בתקלה מתבצע ב-proxy ל-API, ואז אוסף הנתונים הסטטיסטיים ב-handler של התקלות קובע את הנתונים שנאספו. ניתן להשתמש באוסף הנתונים הסטטיסטיים כדי לתעד מידע על התקלה, או כדי לתעד כל מידע אחר שלדעתכם צריך. אוסף הנתונים הסטטיסטיים באשמת ה-handler קובע אילו נתונים נאספו ללא קשר אם אוסף הנתונים הסטטיסטיים בבקשה/בתשובה שכבר בוצעה.

למידע נוסף, ראו טיפול פגמים.

הפניה לרכיב

בהפניה לרכיב מתארים את הרכיבים והתכונות של אוסף הנתונים הסטטיסטיים המדיניות בנושא

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

The following table describes attributes that are common to all policy parent elements:

<DisplayName> element

Use in addition to the name attribute to label the policy in the management UI proxy editor with a different, natural-language name.

<DisplayName>Policy Display Name</DisplayName>

&lt;Statistics&gt;/&lt;Statistic&gt; רכיב

<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