analytics Collector नीति

बुनियादी उदाहरण

<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. हर अनुरोध पर, आंकड़ों कलेक्टर की नीति, Analytics के सर्वर पर इन दो वैरिएबल की वैल्यू लिखती है.

यह उदाहरण हर वैरिएबल के लिए एक वैकल्पिक डिफ़ॉल्ट वैल्यू भी सेट करता है, जहां product.id की डिफ़ॉल्ट वैल्यू 999999 है और डिफ़ॉल्ट product.price 0 है. अगर कोई वैरिएबल तय नहीं है और आपने उसके लिए डिफ़ॉल्ट वैल्यू नहीं तय की है, तो वैरिएबल के लिए कोई डेटा रिकॉर्ड नहीं किया जाएगा. अगर एक डिफ़ॉल्ट वैल्यू तय की जाती है, तो वैरिएबल के तय न होने पर डिफ़ॉल्ट वैल्यू रिकॉर्ड हो जाती है.

आंकड़ों का डेटा इकट्ठा करने के बाद, उसे वापस पाने के लिए, Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) या एपीआई का इस्तेमाल किया जा सकता है. आंकड़े हासिल करते समय, इन वैरिएबल के लिए इकट्ठा किए गए डेटा को productID और price के तौर पर दिखाया जाता है.

आंकड़ों तक पहुंचना

इस उदाहरण में, productID नाम के कलेक्शन का आंकड़ों का डेटा देखने के लिए, Edge मैनेजमेंट एपीआई का इस्तेमाल किया गया है. यह अनुरोध, हर दिन के लिए हर प्रॉडक्ट आईडी के लिए सबमिट किए गए मैसेज की कुल संख्या के आधार पर, प्रॉडक्ट आईडी के लिए एक कस्टम रिपोर्ट बनाता है. अपने संगठन के नाम की जगह {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 या आपके तय किए गए कस्टम वैरिएबल के ज़रिए पहले से तय किए जा सकते हैं.

इस उदाहरण में, एक्सट्रैक्ट वैरिएबल नीति का इस्तेमाल ऐसे एक्सएमएल पेलोड से डेटा एक्सट्रैक्ट करने के लिए किया जा रहा है जिसमें मौसम की जानकारी शामिल है. इस नीति की मदद से:

• शहर का नाम एक्सट्रैक्ट करता है और उसे 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>

स्टैटिस्टिक्स कलेक्टर नीति के तहत, एक्सएमएल पेलोड से डेटा निकालने का तरीका बताने वाले ट्यूटोरियल के लिए, कस्टम ऐनलिटिक्स का इस्तेमाल करके एपीआई मैसेज के कॉन्टेंट का विश्लेषण करना देखें.