วิเคราะห์เนื้อหาข้อความ API โดยใช้การวิเคราะห์ที่กําหนดเอง

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

การวิเคราะห์ Edge API จะรวบรวมและวิเคราะห์ข้อมูลสถิติที่หลากหลายจากคำขอและการตอบกลับ API ทุกรายการ ระบบจะรวบรวมข้อมูลนี้โดยอัตโนมัติ จากนั้นจะแสดงใน Edge UI หรือโดยการใช้ API เมตริก ดูข้อมูลเพิ่มเติมเกี่ยวกับสถิติเหล่านี้ได้ที่metricsและมิติข้อมูล

นอกจากนี้ คุณอาจต้องการรวบรวมข้อมูลการวิเคราะห์ที่กำหนดเองสำหรับพร็อกซี API, แอป, ผลิตภัณฑ์ หรือนักพัฒนาซอฟต์แวร์โดยเฉพาะ ตัวอย่างเช่น คุณอาจต้องการรวบรวมข้อมูลจากพารามิเตอร์การค้นหา ส่วนหัวของคำขอ เนื้อหาของคำขอและคำตอบ หรือตัวแปรที่คุณกำหนดใน API

หัวข้อนี้จะอธิบายวิธีใช้นโยบาย StatisticsCollector เพื่อดึงข้อมูลวิเคราะห์ที่กำหนดเองจากคำขอ/การตอบกลับ API แล้วป้อนข้อมูลนั้นไปยังการวิเคราะห์ Edge API จากนั้นจะแสดงวิธีดูข้อมูลการวิเคราะห์ในรายงานใน Edge UI หรือโดยการใช้ Edge API

เกี่ยวกับ Google Book API

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

ตัวอย่างเช่น ส่งคำขอไปยังปลายทาง /volumes เพื่อค้นหาตามชื่อหนังสือ ส่งพารามิเตอร์การค้นหาเดียวไปยัง Books API ที่มีชื่อหนังสือ ดังนี้

curl https://www.googleapis.com/books/v1/volumes?q=davinci%20code

การเรียกจะแสดงผลอาร์เรย์ JSON ของรายการที่พบที่ตรงกับเกณฑ์การค้นหา ด้านล่างนี้เป็นองค์ประกอบอาร์เรย์แรกในการตอบสนอง (โปรดทราบว่าเราละเว้นเนื้อหาบางส่วนเพื่อให้ดูง่ายขึ้น)

{
 "kind": "books#volumes",
 "totalItems": 1799,
 "items": [
  {
   "kind": "books#volume",
   "id": "ohZ1wcYifLsC",
   "etag": "4rzIsMdBMYM",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/ohZ1wcYifLsC",
   "volumeInfo": {
    "title": "The Da Vinci Code",
    "subtitle": "Featuring Robert Langdon",
    "authors": [
     "Dan Brown"
    ],
    "publisher": "Anchor",
    "publishedDate": "2003-03-18",
    "description": "MORE THAN 80 MILLION COPIES SOLD ....",
    "industryIdentifiers": [
     {
      "type": "ISBN_10",
      "identifier": "0385504217"
     },
     {
      "type": "ISBN_13",
      "identifier": "9780385504218"
     }
    ],
    "readingModes": {
     "text": true,
     "image": true
    },
    "pageCount": 400,
    "printType": "BOOK",
    "categories": [
     "Fiction"
    ],
    "averageRating": 4.0,
    "ratingsCount": 710,
    "maturityRating": "NOT_MATURE",
    "allowAnonLogging": true,
    "contentVersion": "0.18.13.0.preview.3",
    "panelizationSummary": {
     "containsEpubBubbles": false,
     "containsImageBubbles": false
    },
...
   "accessInfo": {
    "country": "US",
    "viewability": "PARTIAL",
    "embeddable": true,
    "publicDomain": false,
    "textToSpeechPermission": "ALLOWED_FOR_ACCESSIBILITY",
    "epub": {
     "isAvailable": true,
     "acsTokenLink": "link"
    },
    "pdf": {
     "isAvailable": true,
     "acsTokenLink": "link"
    },
...
   }
  }

จะเห็นว่ามีการไฮไลต์คําตอบหลายส่วน ดังนี้

  • จำนวนผลการค้นหา
  • คะแนนเฉลี่ยของหนังสือ
  • จำนวนการให้คะแนน
  • ความพร้อมให้บริการของหนังสือในรูปแบบ PDF

ส่วนต่อไปนี้อธิบายวิธีรวบรวมสถิติสำหรับพื้นที่เหล่านี้ของคำตอบ และสำหรับพารามิเตอร์การค้นหา q ที่มีเกณฑ์การค้นหา

สร้างพร็อกซี API สำหรับ Google Book API

ก่อนที่จะรวบรวมสถิติสำหรับ Google Book API ได้ คุณต้องสร้างพร็อกซี Edge API ที่เรียกใช้พร็อกซี จากนั้นคุณจะเรียกใช้พร็อกซี API ดังกล่าวเพื่อส่งคำขอไปยัง Google Book API

ขั้นตอนที่ 2: สร้างพร็อกซี API ของบทแนะนำสำหรับการสร้างพร็อกซี API อธิบายวิธีสร้างพร็อกซีที่เรียกใช้ API https://mocktarget.apigee.net โปรดทราบว่าพร็อกซีที่อธิบายไว้ในบทแนะนำนั้นไม่ต้องใช้คีย์ API ในการเรียกใช้

ใช้ขั้นตอนเดียวกันนี้เพื่อสร้างพร็อกซี API สำหรับปลายทาง /volumes ของ Google Book API ในขั้นตอนที่ 5 ของกระบวนการ เมื่อสร้างพร็อกซี API ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้เพื่ออ้างอิง Google Books API

  • ชื่อพร็อกซี: "mybooksearch"
  • เส้นทางฐานพร็อกซี: "/mybooksearch"
  • API ที่มีอยู่: "https://www.googleapis.com/books/v1/Volumes"

หลังจากที่คุณสร้างและทำให้พร็อกซีใช้งานได้แล้ว คุณควรเรียกใช้พร็อกซีได้โดยใช้คำสั่ง curl ในแบบฟอร์ม:

curl http://org_name-env_name.apigee.net/mybooksearch?q=davinci%20code

โดยที่ org_name และ env_name ระบุองค์กรและสภาพแวดล้อมที่คุณทำให้พร็อกซีใช้งานได้ ตัวอย่างเช่น 

curl http://myorg-test.apigee.net/mybooksearch?q=davinci%20code

รวบรวมข้อมูลการวิเคราะห์ที่กำหนดเอง

การเก็บรวบรวมข้อมูลวิเคราะห์จากคำขอ API มี 2 ขั้นตอน ดังนี้

  1. ดึงข้อมูลที่สนใจแล้วเขียนลงในตัวแปร

    ข้อมูลทั้งหมดที่ส่งไปยังการวิเคราะห์ Edge API จะมาจากค่าที่จัดเก็บไว้ในตัวแปร ระบบจะจัดเก็บข้อมูลบางอย่างโดยอัตโนมัติในตัวแปรโฟลว์ Edge ที่กำหนดไว้ล่วงหน้า เช่น ค่าของพารามิเตอร์การค้นหาที่ส่งไปยังพร็อกซี API ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวแปรโฟลว์ที่กำหนดไว้ล่วงหน้าได้ในภาพรวมของตัวแปรโฟลว์

    ใช้นโยบายดึงข้อมูลตัวแปรเพื่อดึงเนื้อหาที่กำหนดเองจากคำขอหรือการตอบกลับ แล้วเขียนข้อมูลดังกล่าวลงในตัวแปร

  2. เขียนข้อมูลจากตัวแปรไปยังการวิเคราะห์ Edge API

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

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

ใช้นโยบาย "แยกตัวแปร" เพื่อดึงข้อมูลการวิเคราะห์

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

นโยบายการดึงข้อมูลตัวแปรจะแยกวิเคราะห์เพย์โหลดของข้อความด้วยนิพจน์ JSONPath หรือ XPath หากต้องการดึงข้อมูลจากผลการค้นหา JSON ของ Google Book API ให้ใช้นิพจน์ JSONPath เช่น หากต้องการดึงค่าของ averageRating จากรายการแรกในอาร์เรย์ผลลัพธ์ JSON นิพจน์ JSONPath จะอยู่ในรูปแบบต่อไปนี้

$.items[0].volumeInfo.averageRating

หลังจากประเมิน JSONPath แล้ว นโยบายการดึงข้อมูลตัวแปรจะเขียนค่าที่ดึงข้อมูลไปยังตัวแปร

ในตัวอย่างนี้ คุณใช้นโยบายดึงข้อมูลตัวแปรเพื่อสร้างตัวแปร 4 รายการดังนี้

  • responsejson.totalitems
  • responsejson.ratingscount
  • responsejson.avgrating
  • responsejson.pdf

สำหรับตัวแปรเหล่านี้ responsejson คือตัวแปรคำนำหน้า และ totalitems, ratingscount, avgrating และ pdf คือชื่อตัวแปร

นโยบายการดึงข้อมูลตัวแปรด้านล่างแสดงวิธีดึงข้อมูลจากการตอบสนองของ JSON และเขียนลงในตัวแปรที่กำหนดเอง องค์ประกอบ <Variable> แต่ละรายการใช้แอตทริบิวต์ name ที่ระบุชื่อของตัวแปรที่กำหนดเองและนิพจน์ JSONPath ที่เกี่ยวข้อง องค์ประกอบ <VariablePrefix> ระบุว่าคำนำหน้าตัวแปร

เพิ่มนโยบายนี้ลงในพร็อกซี API ใน Edge UI หากคุณกำลังสร้างพร็อกซี API ใน XML ให้เพิ่มนโยบายลงในไฟล์ภายใต้/apiproxy/policies ชื่อ ExtractVars.xml ดังนี้

<ExtractVariables name="ExtractVars">
    <Source>response</Source>
    <JSONPayload>
        <Variable name="totalitems">
            <JSONPath>$.totalItems</JSONPath>
        </Variable>
        <Variable name="ratingscount">
            <JSONPath>$.items[0].volumeInfo.ratingsCount</JSONPath>
        </Variable>
        <Variable name="avgrating">
            <JSONPath>$.items[0].volumeInfo.averageRating</JSONPath>
        </Variable>
        <Variable name="pdf">
            <JSONPath>$.items[0].accessInfo.pdf.isAvailable</JSONPath>
        </Variable>
    </JSONPayload>
    <VariablePrefix>responsejson</VariablePrefix>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

ใช้นโยบายเครื่องมือรวบรวมสถิติเพื่อเขียนข้อมูลไปยังบริการ Analytics

ใช้นโยบายเครื่องมือรวบรวมข้อมูลสถิติเพื่อเขียนข้อมูลจากตัวแปรไปยังข้อมูลวิเคราะห์ของ Edge API นโยบายการเก็บรวบรวมสถิติมีรูปแบบต่อไปนี้

<StatisticsCollector>
<DisplayName>Statistics Collector-1</DisplayName>
    <Statistics>
        <Statistic name="statName" ref="varName" type="dataType">defVal</Statistic>
       …
    </Statistics>
</StatisticsCollector>

ที่ไหน

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

  • dataType จะระบุประเภทข้อมูลของข้อมูลที่บันทึกไว้เป็นสตริง จำนวนเต็ม แบบลอย ยาว แบบคู่ หรือบูลีน

    สำหรับข้อมูลประเภทสตริง คุณจะอ้างอิงข้อมูลทางสถิติเป็นมิติข้อมูลในรายงานที่กำหนดเอง สำหรับประเภทข้อมูลตัวเลข (จำนวนเต็ม/ทศนิยม/ทศนิยม) คุณจะอ้างอิงข้อมูลสถิติเป็นมิติข้อมูลหรือเมตริกในรายงานที่กำหนดเองก็ได้

  • defValue (ไม่บังคับ) ระบุค่าเริ่มต้นสำหรับตัวแปรที่กำหนดเอง ซึ่งจะส่งไปยัง API Analytics หากตัวแปรแก้ไขไม่ได้หรือไม่ได้ระบุตัวแปร

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

request.queryparam.queryParamName

สำหรับพารามิเตอร์ข้อความค้นหาชื่อ "q" ให้อ้างอิงเป็น:

request.queryparam.q

เพิ่มนโยบายนี้ลงในพร็อกซี API ใน Edge UI หรือหากคุณสร้างพร็อกซี API ใน XML ให้เพิ่มไฟล์ในส่วน /apiproxy/policies ชื่อ AnalyzeBookResults.xml, ที่มีเนื้อหาต่อไปนี้

<StatisticsCollector name="AnalyzeBookResults">
 <Statistics>
        <Statistic name="totalitems" ref="responsejson.totalitems" type="integer">0</Statistic>
        <Statistic name="ratingscount" ref="responsejson.ratingscount" type="integer">0</Statistic>
        <Statistic name="avgrating" ref="responsejson.avgrating" type="float">0.0</Statistic>
        <Statistic name="pdf" ref="responsejson.pdf" type="boolean">true</Statistic>
        <Statistic name="booktitle" ref="request.queryparam.q" type="string">none</Statistic>
 </Statistics>
</StatisticsCollector>

แนบนโยบายกับขั้นตอนการตอบกลับ ProxyEndpoint

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

ตัวอย่างการกำหนดค่า ProxyEndpoint ด้านล่างจะเรียกใช้นโยบาย ExtractVars เพื่อแยกวิเคราะห์ข้อความตอบกลับก่อน จากนั้นนโยบายที่ชื่อว่า AnalyzeBookResults จะส่งต่อค่าเหล่านั้นไปยัง API Analytics

<ProxyEndpoint name="default">
    ><PreFlow name="PreFlow">
        <Request/>
        <Response>
            <Step>
                <Name>Extract-Vars</Name>
            </Step>
            <Step>
                <Name>AnalyzeBookResults</Name>
            </Step>
        </Response>
    </PreFlow>
 <HTTPProxyConnection>
  <!-- Base path used to route inbound requests to this API proxy -->
  <BasePath>/mybooksearch</BasePath>
  <!-- The named virtual host that defines the base URL for requests to this proxy -->
  <VirtualHost>default</VirtualHost>
 </HTTPProxyConnection>
 <RouteRule name="default">
 <!-- Connects the proxy to the target defined under /targets -->
  <TargetEndpoint>default</TargetEndpoint>
 </RouteRule>
</ProxyEndpoint>

ทำให้พร็อกซี API ใช้งานได้

หลังจากทำการเปลี่ยนแปลงเหล่านี้แล้ว คุณต้องทำให้พร็อกซี API ที่กำหนดค่าไว้ใช้งานได้

สร้างข้อมูลวิเคราะห์

หลังจากใช้พร็อกซี API แล้ว ให้เรียกใช้พร็อกซีเพื่อเติมข้อมูลใน API Analytics ซึ่งทำได้โดยการเรียกใช้คำสั่งต่อไปนี้ ซึ่งแต่ละคำสั่งใช้ชื่อหนังสือที่ต่างกัน

โมบี้ดิ๊ก:

curl https://org_name-env_name.apigee.net/mybooksearch?q=mobey%20dick

รหัสดาวินชี:

curl https://org_name-env_name.apigee.net/mybooksearch?q=davinci%20code

Gone Girl:

curl https://org_name-env_name.apigee.net/mybooksearch?q=gone%20girl

Game of Thrones:

curl https://org_name-env_name.apigee.net/mybooksearch?q=game%20of%20thrones

ดูข้อมูล Analytics

Edge มี 2 วิธีในการดูข้อมูลวิเคราะห์ที่กำหนดเอง ดังนี้

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

สร้างรายงานสถิติโดยใช้ Edge UI

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

เมื่อคุณสร้างนโยบายเครื่องมือเก็บข้อมูลสถิติ คุณจะต้องระบุประเภทของข้อมูลที่เก็บรวบรวมไป สำหรับประเภทข้อมูลสตริง ให้อ้างอิงข้อมูลทางสถิติเป็นมิติข้อมูลในรายงานที่กำหนดเอง สำหรับประเภทข้อมูลเชิงตัวเลข (จำนวนเต็ม/ทศนิยม/ทศนิยม) ให้อ้างอิงวันที่ทางสถิติในรายงานที่กำหนดเองเป็นมิติข้อมูลหรือเป็นเมตริก โปรดดูข้อมูลเพิ่มเติมในจัดการรายงานที่กำหนดเอง

การสร้างรายงานที่กำหนดเองโดยใช้ Edge UI

  1. เข้าถึงหน้ารายงานที่กำหนดเองตามที่อธิบายด้านล่าง

    Edge

    วิธีเข้าถึงหน้ารายงานที่กำหนดเองโดยใช้ Edge UI

    1. ลงชื่อเข้าใช้ apigee.com/edge
    2. เลือก วิเคราะห์ > รายงานที่กำหนดเอง > รายงาน ในแถบนำทางด้านซ้าย

    Classic Edge (Private Cloud)

    วิธีเข้าถึงหน้ารายงานที่กำหนดเองโดยใช้ UI แบบคลาสสิกของ Edge

    1. ลงชื่อเข้าใช้ http://ms-ip:9000 โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ

    2. เลือก Analtyics > รายงานในแถบนำทางด้านบน

  2. ในหน้ารายงานที่กำหนดเอง คลิก +รายงานที่กำหนดเอง
  3. ระบุชื่อรายงาน เช่น mybookreport

  4. เลือกเมตริกในตัว เช่น การเข้าชมและฟังก์ชันการรวม เช่น ผลรวม

    หรือเลือกสถิติข้อมูลที่เป็นตัวเลขที่คุณสร้างขึ้นด้วยการใช้นโยบายเครื่องมือรวบรวมข้อมูลสถิติ เช่น เลือก ratingscount และฟังก์ชันรวมของ Sum

  5. เลือกมิติข้อมูลในตัว เช่น พร็อกซี API หรือสตริงหรือสถิติตัวเลขใดก็ตามที่คุณสร้างขึ้นโดยใช้นโยบาย StatisticsCollector

    เช่น เลือก booktitle ตอนนี้รายงานจะแสดงผลรวมของ ratingscount ตาม booktitle ดังนี้

    รายงานหนังสือที่กำหนดเอง
  6. เลือกบันทึก รายงานจะปรากฏในรายการของรายงานที่กำหนดเองทั้งหมด

  7. หากต้องการเรียกใช้รายงาน ให้เลือกชื่อรายงาน โดยค่าเริ่มต้น รายงานจะแสดงข้อมูลของชั่วโมงที่ผ่านมา

  8. หากต้องการกำหนดช่วงเวลา ให้เลือกการแสดงวันที่ที่มุมบนขวาเพื่อเปิดป๊อปอัปตัวเลือกวันที่

  9. เลือก 7 วันล่าสุด รายงานจะอัปเดตเพื่อแสดงผลรวมของการจัดประเภทต่อชื่อหนังสือ ดังนี้

    แผนภูมิรายงานหนังสือ

ดูสถิติโดยใช้ Edge API

ใช้ EdgeMetric API เพื่อสร้างสถิติของข้อมูลวิเคราะห์ที่กำหนดเอง ในคำขอตัวอย่างด้านล่าง

  • ทรัพยากรของ URL หลัง /stats จะระบุมิติข้อมูลที่ต้องการ ในตัวอย่างนี้ คุณได้ข้อมูลสำหรับมิติข้อมูล booktitle
  • พารามิเตอร์การค้นหา select เพื่อระบุmetricsที่จะดึงข้อมูล คำขอนี้จะแสดงผลข้อมูลวิเคราะห์โดยอิงตามผลรวมของ ratingscount

  • พารามิเตอร์ timeRange จะระบุช่วงเวลาสำหรับข้อมูลที่แสดงผล ช่วงเวลาจะอยู่ในรูปแบบต่อไปนี้

    MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM

การเรียก API เต็มรูปแบบคือ

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00" /
-u email:password

คุณควรเห็นการตอบกลับในแบบฟอร์ม:

{
  "environments": [
    {
      "dimensions": [
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "5352.0"
              ]
            }
          ],
          "name": "gone girl"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "4260.0"
              ]
            }
          ],
          "name": "davinci code"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "1836.0"
              ]
            }
          ],
          "name": "game of thrones"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "1812.0"
              ]
            }
          ],
          "name": "mobey dick"
        }
      ],
      "name": "prod"
    }
  ],
  "metaData": {
    "errors": [],
    "notices": [
      "query served by:9b372dd0-ed30-4502-8753-73a6b09cc028",
      "Table used: uap-prod-gcp-us-west1.edge.edge_api_raxgroup021_fact",
      "Source:Big Query"
    ]
  }
}

EdgeMetric API มีหลายตัวเลือก เช่น จัดเรียงผลลัพธ์ตามลำดับจากน้อยไปมากหรือมากไปน้อยได้ ในตัวอย่างต่อไปนี้ คุณใช้ลำดับจากน้อยไปมาก

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00&sort=ASC" /
-u email:password

นอกจากนี้ยังกรองผลลัพธ์ได้ด้วยการระบุค่าของมิติข้อมูลที่สนใจ ในตัวอย่างด้านล่าง รายงานถูกกรองตามผลลัพธ์ของ "Gone Girl" และ "The Da Vinci Code"

$ curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00&filter=(booktitle%20in%20'gone%20girl'%2C%20'davinci%20code')" /
-u email:password

การสร้างตัวแปรการวิเคราะห์ที่กำหนดเองด้วย Solution Builder

เครื่องมือสร้างโซลูชันให้คุณสร้างตัวแปรการวิเคราะห์ที่กำหนดเองผ่านกล่องโต้ตอบ UI การจัดการที่ใช้งานง่าย

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

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

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

  1. ไปที่หน้าภาพรวมของพร็อกซีใน Edge UI
  2. คลิกพัฒนา
  3. ในหน้าพัฒนา ให้เลือกคอลเล็กชัน Analytics ที่กำหนดเองจากเมนูเครื่องมือ กล่องโต้ตอบ Solution Builder จะปรากฏขึ้น
  4. ในกล่องโต้ตอบเครื่องมือสร้างโซลูชัน คุณต้องกำหนดค่านโยบาย 2 รายการก่อน ได้แก่ การแยกตัวแปรและตัวรวบรวมสถิติ จากนั้นกำหนดค่าตำแหน่งที่จะแนบนโยบายดังกล่าว
  5. ระบุข้อมูลที่ต้องการแยก ดังนี้
    • ประเภทตำแหน่ง: เลือกประเภทข้อมูลที่คุณต้องการเก็บรวบรวมและตำแหน่งในการรวบรวมข้อมูล คุณสามารถเลือกข้อมูลจากฝั่งคำขอหรือการตอบกลับได้ เช่น คําขอ: พารามิเตอร์การค้นหา หรือการตอบกลับ: XML Body
    • แหล่งที่มาของตำแหน่ง: ระบุข้อมูลที่คุณต้องการรวบรวม เช่น ชื่อของพารามิเตอร์การค้นหาหรือ XPath สำหรับข้อมูล XML ในเนื้อหาการตอบกลับ
  6. ระบุชื่อตัวแปร (และประเภท) ที่นโยบายเครื่องมือรวบรวมสถิติจะใช้เพื่อระบุข้อมูลที่ดึงมา ดูข้อจำกัดในการตั้งชื่อในหัวข้อนี้

    ชื่อที่คุณใช้จะปรากฏในเมนูแบบเลื่อนลงสำหรับมิติข้อมูลหรือเมตริกใน UI เครื่องมือสร้างรายงานที่กำหนดเอง
  7. เลือกตำแหน่งในขั้นตอนพร็อกซี API ที่คุณต้องการแนบนโยบายที่สร้างขึ้น เครื่องมือแยกตัวแปรและตัวรวบรวมสถิติ ดูคำแนะนำได้ที่ "แนบนโยบายกับขั้นตอนการตอบกลับ ProxyEndpoint" ต้องแนบนโยบายกับโฟลว์พร็อกซี API ในตำแหน่งที่เหมาะสมเพื่อให้ทุกอย่างทำงานได้ถูกต้อง คุณต้องแนบนโยบายในขั้นตอนของโฟลว์ที่ตัวแปรที่คุณวางอยู่ในขอบเขต (ป้อนข้อมูล)
  8. คลิก +เครื่องมือรวบรวม เพื่อเพิ่มตัวแปรที่กําหนดเอง

  9. เมื่อเสร็จแล้ว ให้คลิกสร้างโซลูชัน

  10. บันทึกและทำให้พร็อกซีใช้งานได้

คุณสามารถสร้างรายงานที่กําหนดเองสําหรับข้อมูลตามที่อธิบายไว้ข้างต้นได้แล้ว