analytics Collector नीति

Apigee Edge के दस्तावेज़ देखे जा रहे हैं.
पर जाएं Apigee X दस्तावेज़. info

क्या

इस सुविधा की मदद से, मैसेज में मौजूद डेटा के आंकड़े इकट्ठा किए जा सकते हैं. जैसे, प्रॉडक्ट आईडी, कीमत, REST ऐक्शन, क्लाइंट और टारगेट यूआरएल, और मैसेज की लंबाई. यह डेटा, Apigee की ओर से पहले से तय किए गए फ़्लो वैरिएबल या आपके तय किए गए कस्टम वैरिएबल से मिल सकता है.

आंकड़ों का डेटा, Analytics सर्वर को भेजा जाता है. यह सर्वर, आंकड़ों का विश्लेषण करता है और रिपोर्ट जनरेट करता है. 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 की नीति के बारे में जानकारी

लागू होने पर, Statistics Collector की नीति, एक या उससे ज़्यादा वैरिएबल की मौजूदा वैल्यू रिकॉर्ड करती है. ये वैरिएबल, Apigee की ओर से पहले से तय किए गए फ़्लो वैरिएबल या आपके तय किए गए कस्टम वैरिएबल हो सकते हैं. यह डेटा, Edge के Analytics सर्वर में लिखा जाता है.

नीति के तहत इकट्ठा किए गए आंकड़ों के डेटा को ऐक्सेस करने के लिए, Edge API या Edge के मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करें. उदाहरण के लिए, Edge के मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, कस्टम रिपोर्ट बनाई जा सकती है. इसमें इकट्ठा किया गया डेटा अलग-अलग फ़ॉर्मैट में दिखाया जाता है.

Statistics Collector की नीति का इस्तेमाल करने का तरीका जानने के लिए, एपीआई मैसेज के कॉन्टेंट का विश्लेषण करने के लिए कस्टम Analytics का इस्तेमाल करना लेख पढ़ें.

नीति कहां लागू करें

Statistics Collector की नीति को, एपीआई प्रॉक्सी के अनुरोध या जवाब के फ़्लो में लागू किया जा सकता है. हालांकि, अगर किसी प्रॉक्सी में, Statistics Collector की एक से ज़्यादा नीतियां लागू की जाती हैं, तो सबसे आखिर में लागू होने वाली नीति के हिसाब से, Analytics सर्वर में डेटा लिखा जाता है. साथ ही, Statistics Collector की पिछली नीतियों के तहत लिखा गया डेटा मिट जाता है.

एक ऐसा उदाहरण जहां एपीआई प्रॉक्सी में, Statistics Collector की एक से ज़्यादा नीतियां लागू की जा सकती हैं. जैसे, अनुरोध या जवाब के फ़्लो में एक नीति और गड़बड़ी हैंडलर में दूसरी नीति. अगर एपीआई प्रॉक्सी में कोई गड़बड़ी होती है, तो गड़बड़ी हैंडलर में मौजूद Statistics Collector के हिसाब से, डेटा इकट्ठा किया जाता है. उस Statistics Collector का इस्तेमाल, गड़बड़ी के बारे में जानकारी रिकॉर्ड करने या कोई अन्य जानकारी रिकॉर्ड करने के लिए किया जा सकता है. गड़बड़ी हैंडलर में मौजूद Statistics Collector के हिसाब से, डेटा इकट्ठा किया जाता है. भले ही, अनुरोध/जवाब में मौजूद Statistics Collector पहले ही लागू हो चुका हो या नहीं.

ज़्यादा जानकारी के लिए, गड़बड़ियों को हैंडल करना लेख पढ़ें.

एलिमेंट रेफ़रंस

एलिमेंट रेफ़रंस में, 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 एट्रिब्यूट के साथ-साथ इस्तेमाल करें मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) प्रॉक्सी एडिटर, जिसका नाम अलग और सामान्य भाषा में है.

<DisplayName>Policy Display Name</DisplayName>

<Statistics>/<Statistic> एलिमेंट

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

गड़बड़ी का रेफ़रंस

इस सेक्शन में, गड़बड़ी के मैसेज और फ़्लो वैरिएबल के बारे में बताया गया है. ये मैसेज और वैरिएबल तब सेट होते हैं, जब यह नीति किसी गड़बड़ी को ट्रिगर करती है. अगर आपको किसी प्रोक्सी के लिए गड़बड़ी के नियम बनाने हैं, तो यह जानकारी ज़रूरी है. ज़्यादा जानने के लिए, नीति से जुड़ी गड़बड़ियों के बारे में आपको क्या जानना चाहिए और गड़बड़ियों को ठीक करने के बारे में जानकारी देखें.

रनटाइम से जुड़ी गड़बड़ियां

कोई नहीं.

डिप्लॉयमेंट से जुड़ी गड़बड़ियां

गड़बड़ी के वैरिएबल

कोई नहीं.

स्कीमा

हर नीति के टाइप को, एक्सएमएल स्कीमा (.xsd) से तय किया जाता है. रेफ़रंस के लिए, नीति के स्कीमा GitHub पर उपलब्ध हैं.

मिलते-जुलते विषय

ज़्यादा जानकारी के लिए, देखें:

• एपीआई मैसेज के कॉन्टेंट का विश्लेषण करने के लिए कस्टम Analytics का इस्तेमाल करना
• कस्टम रिपोर्ट मैनेज करना
• एपीआई प्रोग्राम की परफ़ॉर्मेंस को मेज़र करने के लिए, मेट्रिक के एपीआई का इस्तेमाल करना