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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

מה

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

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

כשמבצעים את המדיניות של Statistics Collector, היא מתעדת את הערך הנוכחי של משתנה אחד או יותר. המשתנים האלה יכולים להיות משתני זרימה שהוגדרו מראש על ידי Apigee או משתנים מותאמים אישית שאתם מגדירים. הנתונים האלה נכתבים בשרת ניתוח הנתונים של Edge.

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

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

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

אפשר להציב מדיניות של Statistics Collector בזרימת הבקשות או התשובות של שרת proxy של API. עם זאת, אם מציבים כמה כללי מדיניות של Statistics Collector בשרת proxy, הכלל האחרון שמופעל קובע את הנתונים שנכתבים בשרת Analytics, והנתונים שנכתבים על ידי כל כללי המדיניות הקודמים של Statistics Collector אובדים.

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

מידע נוסף זמין במאמר בנושא טיפול בשגיאות.

הפניה לרכיב

בהפניה לרכיב מתוארים הרכיבים והמאפיינים של מדיניות Statistics Collector.

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

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

&lt;DisplayName&gt; רכיב

צריך להשתמש בנוסף למאפיין name כדי להוסיף תווית למדיניות עורך proxy של ממשק משתמש לניהול עם שם אחר בשפה טבעית.

<DisplayName>Policy Display Name</DisplayName>

רכיב <Statistics>/<Statistic>

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

הפניה לשגיאה

בקטע הזה מוסבר על הודעות השגיאה ומשתני התהליך שמוגדרים כשהמדיניות הזו מפעילה שגיאה. חשוב לדעת את המידע הזה אם אתם מפתחים כללי תקלה לשרת proxy. מידע נוסף זמין במאמרים מידע שחשוב לדעת על שגיאות מדיניות וטיפול בכשלים.

שגיאות זמן ריצה

ללא.

שגיאות בפריסה

משתני תקלה

ללא.

סכימה

כל סוג מדיניות מוגדר על ידי סכימת XML ‏ (.xsd). סכימות מדיניות זמינות ב-GitHub.

נושאים קשורים

מידע נוסף זמין בדפים הבאים:

• ניתוח תוכן ההודעות ב-API באמצעות ניתוח נתונים בהתאמה אישית
• איך עובדים עם דוחות בהתאמה אישית
• שימוש בממשקי ה-API של המדדים כדי למדוד את הביצועים של תוכנית ה-API