นโยบาย StatisticsCollector

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

อะไร

ช่วยให้คุณรวบรวมสถิติของข้อมูลในข้อความ เช่น รหัสผลิตภัณฑ์ ราคา การดำเนินการ 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

เมื่อทำงาน นโยบาย Statistics Collector จะบันทึกค่าปัจจุบันของตัวแปรอย่างน้อย 1 รายการ ตัวแปรเหล่านี้อาจเป็นตัวแปรโฟลว์ที่ Apigee กำหนดไว้ล่วงหน้าหรือตัวแปรที่กำหนดเองที่คุณกำหนด ระบบจะเขียนข้อมูลนี้ไปยังเซิร์ฟเวอร์การวิเคราะห์ของ Edge

หากต้องการเข้าถึงข้อมูลสถิติที่นโยบายรวบรวมไว้ ให้ใช้ Edge API หรืออินเทอร์เฟซผู้ใช้การจัดการของ Edge เช่น คุณสามารถใช้อินเทอร์เฟซผู้ใช้การจัดการของ Edge เพื่อสร้างรายงานที่กำหนดเองที่ แสดงข้อมูลที่รวบรวมไว้ในรูปแบบต่างๆ

ดูบทแนะนำฉบับสมบูรณ์โดยใช้นโยบาย Statistics Collector ได้ที่วิเคราะห์เนื้อหาข้อความ API โดยใช้การวิเคราะห์ที่กำหนดเอง

ตำแหน่งที่จะวางนโยบาย

คุณสามารถวางนโยบาย Statistics Collector ไว้ในโฟลว์คำขอหรือการตอบกลับของพร็อกซี API อย่างไรก็ตาม หากคุณวางนโยบาย Statistics Collector หลายรายการไว้ในพร็อกซี นโยบายที่ทำงานเป็นรายการสุดท้าย จะเป็นตัวกำหนดข้อมูลที่จะเขียนไปยังเซิร์ฟเวอร์การวิเคราะห์ และข้อมูลที่นโยบาย Statistics Collector ก่อนหน้านี้เขียนไว้จะสูญหาย

สถานการณ์หนึ่งที่คุณอาจมีนโยบาย Statistics Collector หลายรายการในพร็อกซี API คือ เมื่อคุณมีนโยบายหนึ่งในโฟลว์คำขอหรือการตอบกลับ และอีกนโยบายหนึ่งในตัวจัดการข้อผิดพลาด หากเกิดข้อผิดพลาด ในพร็อกซี API นโยบาย 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 เพื่อติดป้ายกำกับนโยบายใน เครื่องมือแก้ไขพร็อกซี UI การจัดการด้วยชื่อที่เป็นภาษาธรรมชาติต่างกัน

<DisplayName>Policy Display Name</DisplayName>

องค์ประกอบ <Statistics>/<Statistic>

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

ข้อมูลอ้างอิงข้อผิดพลาด

ส่วนนี้จะอธิบายข้อความแสดงข้อผิดพลาดและตัวแปรของขั้นตอนที่ตั้งค่าไว้เมื่อนโยบายนี้ทริกเกอร์ข้อผิดพลาด ข้อมูลนี้สำคัญต่อการพัฒนากฎข้อบกพร่องสําหรับพร็อกซี ดูข้อมูลเพิ่มเติมได้ที่สิ่งที่คุณต้องทราบเกี่ยวกับข้อผิดพลาดด้านนโยบายและการจัดการข้อบกพร่อง

ข้อผิดพลาดเกี่ยวกับรันไทม์

ไม่มี

ข้อผิดพลาดในการทำให้ใช้งานได้

ตัวแปรข้อบกพร่อง

ไม่มี

สคีมา

ประเภทนโยบายแต่ละประเภทกำหนดโดยสคีมา XML (.xsd) คุณสามารถดูสคีมานโยบาย ได้ใน GitHub

หัวข้อที่เกี่ยวข้อง

ดูข้อมูลเพิ่มเติมได้ที่

• วิเคราะห์เนื้อหาข้อความ API โดยใช้การวิเคราะห์ที่กำหนดเอง
• จัดการรายงานที่กำหนดเอง
• ใช้ API เมตริกเพื่อวัดประสิทธิภาพของโปรแกรม API