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

דוגמה בסיסית

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

בדוגמה הזו אתם אוספים מידע סטטיסטי על שני משתנים מותאמים אישית: product.id ו-product.price. בכל בקשה, המדיניות של אוסף הנתונים הסטטיסטיים כותבת את הערך של שני המשתנים האלה השרת.

הדוגמה הזו גם מגדירה ערך ברירת מחדל אופציונלי לכל משתנה, כאשר ברירת המחדל הערך של product.id הוא 999999 וערך ברירת המחדל product.price הוא 0. אם המשתנה לא מוגדר ולא מציינים ערך ברירת מחדל, נרשם עבור המשתנה. אם תציינו ערך ברירת מחדל, ערך ברירת המחדל הוא מתועד כשהמשתנה לא מוגדר.

אחרי שיצטברו נתונים סטטיסטיים, ניתן יהיה להשתמש ב-API או בממשק המשתמש של Edge management כדי לאחזר את הנתונים הסטטיסטיים. בעת אחזור נתונים סטטיסטיים, אתה מפנה לנתונים שנאספו עבור את המשתנים האלה כ-productID ו-price, בהתאמה.

גישה לנתונים סטטיסטיים

בדוגמה הזו, משתמשים ב-Edge management API כדי להציג את הנתונים הסטטיסטיים עבור בשם productID. הבקשה הזו יוצרת דוח מותאם אישית עבור מזהי המוצרים על סמך סך כל ההודעות שנשלחו לכל מזהה מוצר יום. מחליפים את שם הארגון במשתנה {org_name}. להחליף את כתובת האימייל והסיסמה של החשבון ב-Apigee Edge עבור email:password.

צריך להגדיר את הפרמטר timeRange כך שיכלול את מרווח הזמן שבו הנתונים היו שנאספו. כברירת מחדל, לא ניתן לגשת לנתונים מלפני יותר משישה חודשים מהתאריך הנוכחי. אם המיקום אם רוצים לגשת לנתונים מלפני יותר משישה חודשים, צריך לפנות לתמיכה של Apigee Edge.

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

לפי המדיניות של אוסף הנתונים הסטטיסטיים, הנתונים שנאספים חייבים להיות מאוחסנים במשתנים. את המשתנים האלה אפשר להגדיר מראש על ידי Apigee או משתנים מותאמים אישית שאתם מגדירים.

בדוגמה הזו משתמשים במדיניות 'חילוץ משתנים' כדי לחלץ נתונים ממטען ייעודי (payload) של XML. שמכיל מידע על מזג האוויר. המדיניות הזו:

• משלים את שם העיר וכותב אותו במשתנה בשם weather.location
• חילוץ התנאים הנוכחיים וכתיבתם למשתנה בשם weather.condition

לאחר מכן תוכלו להשתמש במדיניות של אוסף הנתונים הסטטיסטיים כדי לאסוף מידע על במשתנים הבאים:

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

למדריך מלא שמראה איך לחלץ נתונים ממטען ייעודי (payload) של XML המדיניות בנושא אוסף הנתונים הסטטיסטיים זמינה במאמר ניתוח API תוכן של הודעות באמצעות ניתוח נתונים בהתאמה אישית.