Phân tích nội dung thông báo API bằng công cụ phân tích tuỳ chỉnh

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Edge API Analytics thu thập và phân tích nhiều thông tin thống kê từ mọi yêu cầu API và phản hồi. Thông tin này được thu thập tự động và sau đó có thể hiển thị trong giao diện người dùng Edge hoặc bằng cách sử dụng API chỉ số. Hãy xem chỉ số và phương diện để biết thêm thông tin về các số liệu thống kê này.

Bạn cũng có thể muốn thu thập dữ liệu phân tích tuỳ chỉnh dành riêng cho các proxy API, Ứng dụng, sản phẩm hoặc nhà phát triển của mình. Ví dụ: bạn có thể muốn thu thập dữ liệu từ các tham số truy vấn, tiêu đề yêu cầu, nội dung yêu cầu và phản hồi hoặc các biến mà bạn xác định trong API.

Chủ đề này minh hoạ cách sử dụng chính sách StatisticsCollector để trích xuất dữ liệu phân tích tuỳ chỉnh từ yêu cầu API/phản hồi API và cung cấp dữ liệu đó cho Edge API Analytics. Sau đó, hướng dẫn này sẽ cho biết cách xem dữ liệu phân tích trong báo cáo trong giao diện người dùng Edge hoặc bằng cách sử dụng Edge API.

Giới thiệu về Google Book API

Chủ đề này mô tả cách thu thập dữ liệu số liệu phân tích tuỳ chỉnh từ các yêu cầu của proxy API đến Google Sách API. Google Sách API cho phép bạn tìm kiếm sách theo tiêu đề, chủ đề, tác giả và các đặc điểm khác.

Ví dụ: đưa ra yêu cầu đến điểm cuối /volumes để thực hiện tìm kiếm theo tên sách. Truyền một tham số truy vấn duy nhất đến Books API chứa tên sách:

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

Lệnh gọi này trả về một mảng JSON gồm các mục tìm thấy phù hợp với tiêu chí tìm kiếm. Dưới đây là phần tử mảng đầu tiên trong phản hồi (xin lưu ý rằng một số nội dung đã bị bỏ qua để đơn giản hoá):

{
 "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"
    },
...
   }
  }

Lưu ý rằng một số phần của câu trả lời đã được đánh dấu:

  • Số lượng kết quả tìm kiếm
  • Điểm xếp hạng trung bình của sách
  • Số lượng điểm xếp hạng
  • Phạm vi cung cấp của phiên bản PDF của sách

Các phần sau đây mô tả cách thu thập số liệu thống kê cho những phần này của phản hồi và cả cho tham số truy vấn q chứa tiêu chí tìm kiếm.

Tạo một proxy API cho Google Book API

Trước khi có thể thu thập số liệu thống kê cho Google Book API, bạn phải tạo một proxy Edge API gọi API này. Sau đó, bạn sẽ gọi proxy API đó để gửi yêu cầu đến Google Book API.

Bước 2: Tạo một proxy API của hướng dẫn tạo proxy API mô tả cách tạo một proxy gọi API https://mocktarget.apigee.net. Xin lưu ý rằng proxy được mô tả trong hướng dẫn đó không yêu cầu khoá API để gọi.

Hãy sử dụng quy trình tương tự để tạo một proxy API cho điểm cuối /volumes của Google Book API. Trong Bước 5 của quy trình, khi bạn tạo proxy API, hãy đặt các thuộc tính sau để tham chiếu đến Google Sách API:

  • Tên proxy: "mybooksearch"
  • Đường dẫn cơ sở của proxy: "/mybooksearch"
  • API hiện có: "https://www.googleapis.com/books/v1/volumes"

Sau khi tạo và triển khai proxy, bạn có thể gọi proxy này bằng cách sử dụng lệnh curl ở dạng:

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

trong đó org_name và env_name chỉ định tổ chức và môi trường mà bạn đã triển khai proxy. Ví dụ: 

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

Thu thập dữ liệu phân tích tuỳ chỉnh

Thu thập dữ liệu phân tích từ một yêu cầu API là quy trình gồm 2 bước:

  1. Trích xuất dữ liệu cần thiết và ghi dữ liệu đó vào một biến.

    Tất cả dữ liệu được truyền đến Edge API Analytics đều đến từ các giá trị được lưu trữ trong các biến. Một số dữ liệu được tự động lưu trữ trong các biến luồng Edge được xác định trước, chẳng hạn như giá trị của các tham số truy vấn được truyền đến proxy API. Hãy xem phần Tổng quan về các biến trong luồng để biết thêm thông tin về các biến trong luồng được xác định trước.

    Sử dụng chính sách Trích xuất biến để trích xuất nội dung tuỳ chỉnh từ một yêu cầu hoặc phản hồi và ghi dữ liệu đó vào một biến.

  2. Ghi dữ liệu từ một biến vào Edge API Analytics.

    Sử dụng chính sách Trình thu thập số liệu thống kê để ghi dữ liệu từ một biến vào Edge API Analytics. Dữ liệu có thể đến từ các biến luồng Edge được xác định trước hoặc các biến do chính sách Trích xuất biến tạo ra.

Sau khi thu thập dữ liệu thống kê, bạn có thể sử dụng giao diện người dùng hoặc API quản lý Edge để truy xuất và lọc số liệu thống kê. Ví dụ: bạn có thể tạo một Báo cáo tùy chỉnh cho biết điểm xếp hạng trung bình của từng tên sách, trong đó tên sách tương ứng với giá trị của tham số truy vấn được truyền đến API.

Sử dụng chính sách Trích xuất biến để trích xuất dữ liệu phân tích

Bạn phải trích xuất và lưu trữ dữ liệu Analytics vào một biến (biến luồng do Edge xác định trước hoặc biến tuỳ chỉnh mà bạn xác định) thì mới có thể truyền dữ liệu đó đến API Analytics. Để ghi dữ liệu vào một biến, bạn sử dụng chính sách Trích xuất biến.

Chính sách Trích xuất biến có thể phân tích cú pháp tải trọng thông báo bằng biểu thức JSONPath hoặc XPath. Để trích xuất thông tin từ kết quả tìm kiếm JSON của Google Books API, hãy sử dụng biểu thức JSONPath. Ví dụ: để trích xuất giá trị của averageRating từ mục đầu tiên trong mảng kết quả JSON, biểu thức JSONPath là:

$.items[0].volumeInfo.averageRating

Sau khi JSONPath được đánh giá, chính sách Trích xuất biến sẽ ghi giá trị đã trích xuất vào một biến.

Trong ví dụ này, bạn sẽ sử dụng chính sách Trích xuất biến để tạo 4 biến:

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

Đối với các biến này, responsejson là tiền tố biến và totalitems, ratingscount, avgrating và pdf là tên biến.

Chính sách Trích xuất biến bên dưới cho biết cách trích xuất dữ liệu từ phản hồi JSON và ghi dữ liệu đó vào các biến tuỳ chỉnh. Mỗi phần tử <Variable> sử dụng thuộc tính name để chỉ định tên của các biến tuỳ chỉnh và biểu thức JSONPath được liên kết. Phần tử <VariablePrefix> chỉ định tiền tố biến.

Thêm chính sách này vào proxy API trong giao diện người dùng Edge. Nếu bạn đang tạo proxy API bằng XML, hãy thêm chính sách vào một tệp trong /apiproxy/policies có tên là 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>

Sử dụng chính sách Trình thu thập số liệu thống kê để ghi dữ liệu vào Dịch vụ Analytics

Sử dụng chính sách Trình thu thập số liệu thống kê để ghi dữ liệu từ một biến vào Edge API Analytics. Chính sách về Trình thu thập số liệu thống kê có dạng như sau:

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

trong đó:

  • statName chỉ định tên bạn dùng để tham chiếu dữ liệu thống kê trong một báo cáo tuỳ chỉnh.
  • varName chỉ định tên của biến chứa dữ liệu phân tích cần thu thập. Biến này có thể được tích hợp vào Edge hoặc có thể là một biến tuỳ chỉnh do chính sách Trích xuất biến tạo ra.

  • dataType chỉ định loại dữ liệu của dữ liệu được ghi là chuỗi, số nguyên, số thực, số dài, số thực có độ chính xác kép hoặc boolean.

    Đối với dữ liệu thuộc loại chuỗi, bạn tham chiếu dữ liệu thống kê dưới dạng một phương diện trong báo cáo tuỳ chỉnh. Đối với các kiểu dữ liệu dạng số (số nguyên/số thực/số dài/số có độ chính xác kép), bạn tham chiếu dữ liệu thống kê dưới dạng phương diện hoặc chỉ số trong báo cáo tuỳ chỉnh.

  • defValue (không bắt buộc) cung cấp giá trị mặc định cho một biến tuỳ chỉnh. Giá trị này sẽ được gửi đến API Analytics nếu không thể phân giải các biến hoặc biến không được xác định.

Trong ví dụ bên dưới, bạn sử dụng chính sách Trình thu thập số liệu thống kê để thu thập dữ liệu cho các biến do chính sách Trích xuất biến tạo ra. Bạn cũng thu thập giá trị của tham số truy vấn được truyền đến mỗi lệnh gọi API. Tham chiếu các tham số truy vấn bằng cách sử dụng biến luồng được xác định trước:

request.queryparam.queryParamName

Đối với tham số truy vấn có tên "q", hãy tham chiếu tham số đó dưới dạng:

request.queryparam.q

Thêm chính sách này vào proxy API trong giao diện người dùng Edge hoặc nếu bạn đang tạo proxy API ở định dạng XML, hãy thêm một tệp trong /apiproxy/policies có tên là AnalyzeBookResults.xml, với nội dung sau:

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

Đính kèm các chính sách vào luồng phản hồi ProxyEndpoint

Để mọi thứ hoạt động đúng cách, các chính sách phải được đính kèm vào luồng proxy API ở vị trí thích hợp. Trong trường hợp sử dụng này, các chính sách phải thực thi sau khi nhận được phản hồi từ Google Book API và trước khi phản hồi được gửi đến ứng dụng yêu cầu. Do đó, hãy đính kèm các chính sách vào ProxyEndpoint response PreFlow.

Cấu hình ProxyEndpoint mẫu bên dưới trước tiên sẽ thực thi chính sách có tên là ExtractVars để phân tích cú pháp thông báo phản hồi. Sau đó, chính sách có tên AnalyzeBookResults sẽ chuyển tiếp các giá trị đó đến 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>

Triển khai proxy API

Sau khi thực hiện những thay đổi này, bạn cần triển khai proxy API mà bạn đã định cấu hình.

Điền sẵn dữ liệu phân tích

Sau khi bạn triển khai proxy API, hãy gọi proxy để điền sẵn dữ liệu trong API Analytics. Bạn có thể thực hiện việc này bằng cách chạy các lệnh sau, mỗi lệnh sử dụng một tên sách khác nhau:

Mobey Dick:

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

Mật mã Da Vinci:

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

Xem dữ liệu phân tích

Edge cung cấp hai cách để xem dữ liệu phân tích tuỳ chỉnh:

  • Giao diện người dùng Edge hỗ trợ các báo cáo tuỳ chỉnh giúp bạn xem dữ liệu dưới dạng biểu đồ.
  • API chỉ số cho phép bạn truy xuất dữ liệu phân tích bằng cách thực hiện các lệnh gọi REST đến Edge API. Bạn có thể sử dụng API này để tạo hình ảnh trực quan của riêng mình dưới dạng các tiện ích tuỳ chỉnh mà bạn có thể nhúng vào các cổng thông tin hoặc ứng dụng tuỳ chỉnh.

Tạo báo cáo thống kê bằng giao diện người dùng Edge

Báo cáo tuỳ chỉnh cho phép bạn đi sâu vào số liệu thống kê API cụ thể để xem chính xác dữ liệu mà bạn muốn. Bạn có thể tạo báo cáo tuỳ chỉnh bằng cách sử dụng bất kỳ chỉ số và phương diện nào được tích hợp trong Edge. Ngoài ra, bạn có thể sử dụng bất kỳ dữ liệu phân tích nào mà bạn đã trích xuất bằng cách sử dụng chính sách StatisticsCollector.

Khi tạo chính sách Trình thu thập số liệu thống kê, bạn sẽ chỉ định kiểu dữ liệu của dữ liệu được thu thập. Đối với loại dữ liệu chuỗi, hãy tham chiếu dữ liệu thống kê dưới dạng một phương diện trong báo cáo tuỳ chỉnh. Đối với các kiểu dữ liệu dạng số (số nguyên/số thực/số dài/số có độ chính xác kép), hãy tham chiếu ngày thống kê trong báo cáo tuỳ chỉnh dưới dạng phương diện hoặc chỉ số. Hãy xem bài viết Quản lý báo cáo tuỳ chỉnh để biết thêm thông tin.

Tạo báo cáo tuỳ chỉnh bằng giao diện người dùng Edge:

  1. Truy cập vào trang Báo cáo tuỳ chỉnh, như mô tả bên dưới.

    Edge

    Cách truy cập vào trang Báo cáo tuỳ chỉnh bằng giao diện người dùng Edge:

    1. Đăng nhập vào apigee.com/edge.
    2. Chọn Phân tích > Báo cáo tuỳ chỉnh > Báo cáo trong thanh điều hướng bên trái.

    Classic Edge (Private Cloud)

    Cách truy cập vào trang Báo cáo tuỳ chỉnh bằng giao diện người dùng Edge cổ điển:

    1. Đăng nhập vào http://ms-ip:9000, trong đó ms-ip là địa chỉ IP hoặc tên DNS của nút Máy chủ quản lý.

    2. Chọn Phân tích > Báo cáo trong thanh điều hướng trên cùng.

  2. Trên trang Báo cáo tuỳ chỉnh, hãy nhấp vào +Báo cáo tuỳ chỉnh.
  3. Chỉ định một Tên báo cáo, chẳng hạn như mybookreport.

  4. Chọn một Chỉ số tích hợp, chẳng hạn như Lưu lượng truy cập và một Hàm tổng hợp, chẳng hạn như Tổng.

    Hoặc chọn một trong các số liệu thống kê dữ liệu dạng số mà bạn đã tạo bằng chính sách StatisticsCollector. Ví dụ: chọn ratingscount và Hàm tổng hợp là Sum.

  5. Chọn một Phương diện tích hợp, chẳng hạn như API Proxy hoặc bất kỳ số liệu thống kê dạng chuỗi hoặc dạng số nào mà bạn đã tạo bằng chính sách StatisticsCollector.

    Ví dụ: chọn booktitle. Bây giờ, báo cáo của bạn sẽ hiển thị tổng số ratingscount theo booktitle:

    bài thu hoạch đọc sách tuỳ chỉnh
  6. Chọn Lưu. Báo cáo này sẽ xuất hiện trong danh sách tất cả báo cáo tuỳ chỉnh.

  7. Để chạy báo cáo, hãy chọn tên báo cáo. Theo mặc định, báo cáo này hiển thị dữ liệu trong giờ gần nhất.

  8. Để đặt phạm vi thời gian, hãy chọn chế độ hiển thị ngày ở góc trên bên phải để mở cửa sổ bật lên Bộ chọn ngày.

  9. Chọn 7 ngày qua. Báo cáo sẽ cập nhật để cho biết tổng số lượt xếp hạng cho mỗi tên sách:

    Biểu đồ bài thu hoạch đọc sách

Nhận số liệu thống kê bằng Edge API

Sử dụng Edge Metrics API để xem số liệu thống kê về dữ liệu phân tích tuỳ chỉnh. Trong yêu cầu ví dụ bên dưới:

  • Tài nguyên đến URL sau /stats chỉ định phương diện mong muốn. Trong ví dụ này, bạn sẽ nhận được dữ liệu cho phương diện booktitle.
  • Tham số truy vấn select để chỉ định chỉ số cần truy xuất. Yêu cầu này trả về số liệu phân tích dựa trên tổng số ratingscount.

  • Tham số timeRange chỉ định khoảng thời gian cho dữ liệu được trả về. Phạm vi thời gian có định dạng:

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

Lệnh gọi API đầy đủ là:

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

Bạn sẽ thấy một phản hồi ở dạng:

{
  "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"
    ]
  }
}

API chỉ số Edge có nhiều lựa chọn. Ví dụ: bạn có thể sắp xếp kết quả theo thứ tự tăng dần hoặc giảm dần. Trong ví dụ sau, bạn sử dụng thứ tự tăng dần:

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

Bạn cũng có thể lọc kết quả bằng cách chỉ định các giá trị của phương diện mà bạn quan tâm. Trong ví dụ bên dưới, báo cáo được lọc theo kết quả cho "Cô gái mất tích" và "Mật mã Da Vinci":

$ 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

Tạo biến Analytics tuỳ chỉnh bằng Trình tạo giải pháp

Trình tạo giải pháp cho phép bạn tạo các biến phân tích tuỳ chỉnh thông qua hộp thoại giao diện người dùng quản lý dễ sử dụng.

Bạn nên đọc phần trước Thu thập dữ liệu phân tích tuỳ chỉnh. Phần này giải thích cách các chính sách Trích xuất biến và Trình thu thập số liệu thống kê hoạt động song song để cung cấp các biến tuỳ chỉnh cho Edge API Analytics. Như bạn thấy, giao diện người dùng tuân theo cùng một mẫu này, nhưng cung cấp một cách thuận tiện để bạn định cấu hình mọi thứ hoàn toàn thông qua giao diện người dùng. Nếu muốn, hãy thử ví dụ về API Google Sách bằng cách sử dụng giao diện người dùng thay vì chỉnh sửa và đính kèm chính sách theo cách thủ công.

Hộp thoại Solution Builder (Trình tạo giải pháp) cho phép bạn định cấu hình các biến phân tích ngay trong giao diện người dùng. Công cụ này sẽ tạo các chính sách và đính kèm chúng vào proxy API cho bạn. Các chính sách này trích xuất các biến số quan trọng từ các yêu cầu hoặc phản hồi và truyền các biến số đã trích xuất đến Edge API Analytics.

Trình tạo giải pháp sẽ tạo các chính sách Trích xuất biến và Trình thu thập số liệu thống kê mới, đồng thời đặt tên riêng cho các chính sách đó. Trình tạo giải pháp không cho phép bạn quay lại và thay đổi các chính sách này sau khi chúng được tạo trong một bản sửa đổi proxy nhất định. Để thực hiện thay đổi, hãy chỉnh sửa trực tiếp các chính sách được tạo trong trình chỉnh sửa chính sách.

  1. Chuyển đến trang Tổng quan cho proxy của bạn trong giao diện người dùng Edge.
  2. Nhấp vào Phát triển.
  3. Trên trang Phát triển, hãy chọn Thu thập số liệu phân tích tuỳ chỉnh trong trình đơn Công cụ. Hộp thoại Solution Builder (Trình tạo giải pháp) sẽ xuất hiện.
  4. Trong hộp thoại Solution Builder (Trình tạo giải pháp), trước tiên, bạn định cấu hình hai chính sách: Extract Variables (Trích xuất biến) và Statistics Collector (Trình thu thập số liệu thống kê). Sau đó, bạn định cấu hình vị trí để đính kèm các chính sách đó.
  5. Chỉ định dữ liệu bạn muốn trích xuất:
    • Loại vị trí: Chọn loại dữ liệu bạn muốn thu thập và nơi thu thập dữ liệu đó. Bạn có thể chọn dữ liệu từ phía yêu cầu hoặc phản hồi. Ví dụ: Yêu cầu: Tham số truy vấn hoặc Phản hồi: Nội dung XML.
    • Nguồn vị trí: Xác định dữ liệu bạn muốn thu thập. Ví dụ: tên của tham số truy vấn hoặc XPath cho dữ liệu XML trong nội dung phản hồi.
  6. Chỉ định một tên (và loại) biến mà chính sách Trình thu thập số liệu thống kê sẽ dùng để xác định dữ liệu đã trích xuất. Hãy xem các hạn chế về tên trong chủ đề này.

    Tên bạn sử dụng sẽ xuất hiện trong trình đơn thả xuống cho Phương diện hoặc Chỉ số trong giao diện người dùng của Trình tạo báo cáo tùy chỉnh.
  7. Chọn vị trí trong luồng proxy API mà bạn muốn đính kèm các chính sách đã tạo Extract Variables và Statistics Collector. Để biết hướng dẫn, hãy xem phần "Đính kèm các chính sách vào Luồng phản hồi ProxyEndpoint". Để mọi thứ hoạt động đúng cách, các chính sách phải được đính kèm vào Luồng của proxy API ở vị trí thích hợp. Bạn cần đính kèm các chính sách ở một giai đoạn trong quy trình mà các biến bạn đang chặn nằm trong phạm vi (được điền sẵn).
  8. Nhấp vào +Trình thu thập để thêm các biến tuỳ chỉnh khác.

  9. Khi bạn hoàn tất, hãy nhấp vào Tạo giải pháp.

  10. Lưu và triển khai proxy.

Giờ đây, bạn có thể tạo báo cáo tuỳ chỉnh cho dữ liệu như mô tả ở trên.