Trang này được dịch bởi Cloud Translation API.

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.
Chuyển đến tài liệu về 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 và phản hồi của API. 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 metrics 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 proxy API, Ứng dụng, sản phẩm hoặc nhà phát triển. Ví dụ: bạn nê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 các API của mình.

Chủ đề này minh hoạ cách sử dụng chính sách Thống kê thu thập để trích xuất dữ liệu phân tích tuỳ chỉnh từ một yêu cầu/phản hồi API và cấp dữ liệu đó cho Analytics API Edge. Sau đó, tài liệu này sẽ hướng dẫn bạn cách xem dữ liệu phân tích trong một báo cáo trên 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 phân tích tuỳ chỉnh từ các yêu cầu proxy API về API Google Sách. Google Books API cho phép bạn tìm kiếm sách theo tên sách, chủ đề, tác giả và các đặc điểm khác.

Ví dụ: gửi yêu cầu đến điểm cuối /volumes để 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 sẽ trả về một mảng JSON gồm các mục đượ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 (lưu ý 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ố vùng trong câu trả lời đã được làm nổi bật:

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

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

Tạo 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 API Edge gọi API đó. Sau đó, bạn gọi proxy API đó để gửi yêu cầu tới Google Book API.

Bước 2: Tạo proxy API trong hướng dẫn tạo proxy API mô tả cách tạo 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 nó.

Hãy dùng chính quy trình đó để 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 API Google Sách:

Tên proxy: "mybooksearch"
Đường dẫn cơ sở proxy: "/mybooksearch"
API hiện tại: "https://www.googleapis.com/books/v1/volume"

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 có 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ừ yêu cầu API là quy trình 2 bước:

Trích xuất dữ liệu quan tâm và ghi vào biến.

Tất cả dữ liệu được chuyể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 flow của Edge được xác định trước, chẳng hạn như giá trị của các tham số truy vấn được chuyển đến proxy API. Xem bài viết Tổng quan về biến luồng để biết thêm thông tin về biến luồng được xác định trước.

Sử dụng chính sách Extract Variables (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.
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 thống kê để ghi dữ liệu từ một biến vào Edge API Analytics. Dữ liệu này 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.

Sau khi thu thập dữ liệu thống kê, bạn có thể sử dụng API hoặc giao diện người dùng 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 tuỳ chỉnh cho biết điểm xếp hạng trung bình cho 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 chuyển đến API.

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

Dữ liệu Analytics phải được trích xuất và lưu trữ vào một biến, biến luồng được xác định trước bởi Edge hoặc biến tuỳ chỉnh mà bạn xác định, trước khi có thể chuyển dữ liệu đó đến API Analytics. Để ghi dữ liệu vào một biến, bạn hãy 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 các 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 API Google Sách, 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ử 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à biến tiền tố và totalitems, ratingscount, avgrating và pdf là các tên biến.

Lưu ý: Các quy định hạn chế về cách đặt tên

Các quy định hạn chế khi đặt tên sau đây áp dụng cho biến phân tích tuỳ chỉnh:

Tên có thể bao gồm các ký tự sau: a-z, 0-9, _ (dấu gạch dưới)
Tên không được chứa dấu cách.
Trường hợp bị bỏ qua.
Bạn không thể sử dụng tên của bất kỳ chỉ số, phương diện hoặc bộ lọc phân tích nào được xác định trước được liệt kê trên Tài liệu tham khảo về chỉ số, phương diện và bộ lọc Analytics.
Ngoài những nội dung nêu trên, bạn không được phép sử dụng các từ khoá được liệt kê trên trang sau đây:
https://www.postgresql.org/docs/8.1/static/sql-keywords-appendix.html

Chính sách Trích xuất biến dưới đây 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 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ố của 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 xây dựng proxy API trong XML, hãy thêm chính sách này 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 thống kê để ghi dữ liệu từ một biến vào Edge API Analytics. Chính sách của Tập hợ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à biến tuỳ chỉnh được tạo theo chính sách Trích xuất biến.
dataType chỉ định kiểu dữ liệu của dữ liệu được ghi dưới dạng chuỗi, số nguyên, số thực có độ chính xác đơn, dài, kép hoặc boolean.

Đối với dữ liệu kiểu chuỗi, bạn cầ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 loại dữ liệu số (số nguyên/số thực/số dài/kép), bạn cầ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 có thể tuỳ ý cung cấp một giá trị mặc định cho biến tuỳ chỉnh. Biến này sẽ được gửi đến API Analytics nếu không phân giải được các biến đó hoặc biến không 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. Bạn cũng thu thập giá trị của tham số truy vấn được chuyể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 nó 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 trong XML, hãy thêm một tệp trong /apiproxy/policies có tên là AnalyzeBookResults.xml, chứa 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 chính sách vào quy trình phản hồi ProxyEndpoint

Để mọi thứ hoạt động bình thường, bạn phải đính kèm các chính sách vào quy trình proxy API ở vị trí thích hợp. Trong trường hợp sử dụng này, 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 tới ứng dụng yêu cầu. Do đó, hãy đính kèm các chính sách này vào PreFlow phản hồi ProxyEndpoint.

Trước tiên, cấu hình ProxyEndpoint mẫu bên dưới 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 là 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>

Cảnh báo: Bạn có thể đặt chính sách Trình thu thập số liệu thống kê vào quy trình yêu cầu hoặc phản hồi của proxy API. Tuy nhiên, nếu bạn đặt nhiều chính sách của Trình thu thập số liệu thống kê vào một proxy, thì chính sách thực thi gần đây nhất sẽ xác định dữ liệu được ghi vào máy chủ phân tích và dữ liệu do mọi chính sách Thu thập số liệu thống kê trước đó sẽ bị mất. Có một trường hợp bạn có thể có nhiều chính sách Trình thu thập thống kê trong proxy API, đó là khi bạn có một chính sách trong quy trình yêu cầu hoặc phản hồi và một chính sách khác trong trình xử lý lỗi. Nếu có lỗi xảy ra trong proxy API, thì Trình thu thập số liệu thống kê trong trình xử lý lỗi sẽ xác định dữ liệu được thu thập. Hãy xem chính sách về Bộ thu thập thống kê để biết thêm thông tin.

Triển khai proxy API

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

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

Sau khi bạn triển khai proxy API, hãy gọi proxy để điền dữ liệu vào 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 đây, mỗi lệnh sử dụng một tên sách khác nhau:

AdMob:

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 (Cô gái mất tích):

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

Trò chơi vương quyền:

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 cho phép bạn xem dữ liệu ở dạng biểu đồ đồ hoạ.
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 lệnh gọi REST đến API Edge. 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 trong các cổng thông tin hoặc ứng dụng tuỳ chỉnh.

Lưu ý:

Sẽ mất khoảng 30 phút để một phương diện tuỳ chỉnh mới được thêm vào cơ sở dữ liệu sau khi chính sách Trình thu thập thống kê được gọi lần đầu tiên cho từng môi trường. Ví dụ: nếu một proxy của Trình thu thập số liệu thống kê được gọi trong môi trường test , thì dữ liệu cho thứ nguyên tùy chỉnh đó sẽ bắt đầu có trong môi trường test 30 phút sau đó và thứ nguyên tùy chỉnh sẽ xuất hiện trong danh sách thả xuống Phương diện của báo cáo tùy chỉnh.

Sau đó, nếu proxy Trình thu thập số liệu thống kê đó được gọi từ môi trường prod, thì sẽ mất khoảng 30 phút trước khi dữ liệu cho thứ nguyên tùy chỉnh đó bắt đầu có trong môi trường prod. Từ đó trở đi, dữ liệu sẽ xuất hiện sau cùng khoảng thời gian với các phương diện khác.

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 tìm hiểu chi tiết về số liệu thống kê cụ thể của API để xem dữ liệu chính xác mà bạn muốn xem. Bạn có thể tạo báo cáo tuỳ chỉnh bằng cách sử dụng bất kỳ metrics và phương diện nào được tích hợp trong Edge. Ngoài ra, bạn có thể sử dụng mọi dữ liệu phân tích mà bạn đã trích xuất bằng chính sách Trình thu thập dữ liệu thống kê.

Khi tạo chính sách Công cụ thu thập số liệu thống kê, bạn cần chỉ định loại 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 khảo dữ liệu thống kê dưới dạng phương diện trong báo cáo tuỳ chỉnh. Đối với các loại dữ liệu số (số nguyên/số thực/số dài/đôi), 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ố. 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:

Truy cập vào trang Báo cáo tuỳ chỉnh, như được 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.
Phiên bản cũ (Đám mây riêng tư)

Lưu ý: Giao diện người dùng Classic Edge chỉ có trên Edge dành cho đám mây riêng tư.

Cách truy cập vào trang Báo cáo tuỳ chỉnh bằng giao diện người dùng Classic Edge:
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.
Trong trang Báo cáo tuỳ chỉnh, hãy nhấp vào +Báo cáo tuỳ chỉnh.
Chỉ định Tên báo cáo, chẳng hạn như mybookreport.
Chọn một Chỉ số tích hợp sẵn, chẳng hạn như Lưu lượng truy cập và Hàm tổng hợp như Sum.

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 cách sử dụng chính sách Thống kê thu thập. Ví dụ: hãy chọn ratingcount (số lượt xếp hạng) và Hàm tổng hợp là Sum.
Chọn một Phương diện tích hợp sẵn, chẳng hạn như API Proxy hoặc bất kỳ số liệu thống kê dạng chuỗi hay số liệu thống kê nào mà bạn đã tạo bằng cách sử dụng chính sách Thống kê thu thập.

Ví dụ: chọn tên sách. Bây giờ, báo cáo của bạn sẽ hiển thị tổng số lượt xếp hạng theo tên sách:
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.
Để 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 sẽ hiển thị dữ liệu trong một giờ qua.
Để đặ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.
Chọn 7 ngày qua. Báo cáo cập nhật để hiển thị tổng điểm xếp hạng cho mỗi tên sách:

Lấy số liệu thống kê bằng Edge API

Sử dụng API chỉ số cạnh để thống kê dữ liệu phân tích tuỳ chỉnh của bạn. Trong yêu cầu mẫu dưới đây:

Tài nguyên của URL sau khi /stats chỉ định phương diện mong muốn. Trong ví dụ này, bạn sẽ lấy dữ liệu cho phương diện booktitle.
Tham số truy vấn select để chỉ định metrics 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 của 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 phản hồi trong biểu mẫu:

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

Kết quả cũng có thể được lọc bằng cách chỉ định 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 "Gone Girl" và "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

Tạo biến phân tích 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 về Thu thập dữ liệu phân tích tuỳ chỉnh. Phần này giải thích cách 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 đồng thời để cấp các biến tuỳ chỉnh cho Edge API Analytics. Như bạn sẽ thấy, giao diện người dùng cũ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 dùng 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 tạo các chính sách và đính kèm các chính sách đó vào proxy API cho bạn. Những chính sách này trích xuất các biến quan tâm từ các yêu cầu hoặc phản hồi và chuyển các biến đã trích xuất sang Edge API Analytics.

Trình tạo giải pháp sẽ tạo các chính sách mới về Trích xuất biến và Trình thu thập số liệu thống kê, đồng thời đặt tên riêng biệt cho chúng. Solution Builder (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. Để thay đổi, hãy chỉnh sửa các chính sách đã tạo ngay trong trình chỉnh sửa chính sách.

Chuyển đến trang Tổng quan cho proxy của bạn trong giao diện người dùng Edge.
Nhấp vào Phát triển.
Trên trang Phát triển, hãy chọn Bộ sưu tập Analytics tuỳ chỉnh từ 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.
Trong hộp thoại Trình tạo giải pháp, trước tiên, bạn cần định cấu hình hai chính sách: Trích xuất biến và 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 đó.
Chỉ định dữ liệu bạn muốn trích xuất:
- Loại vị trí: Chọn loại dữ liệu mà 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 mà 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.
Chỉ định một tên (và loại) biến mà chính sách của Trình thu thập số liệu thống kê sẽ sử dụng để xác định dữ liệu được trích xuất. Xem các hạn chế đặt tên trong chủ đề này.

Tên mà 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 tuỳ chỉnh.
Hãy chọn vị trí trong quy trình proxy API mà bạn muốn đính kèm các chính sách đã tạo Trích xuất biến và Trình thu thập số liệu thống kê. Để được hướng dẫn, hãy xem phần "Đính kèm chính sách vào quy trình phản hồi ProxyEndpoint". Để mọi thứ hoạt động bình thường, bạn phải đính kèm các chính sách vào Luồng proxy API ở vị trí thích hợp. Bạn cần đính kèm các chính sách ở giai đoạn trong luồng mà các biến bạn đang bẫy đang nằm trong phạm vi (được điền sẵn).
Nhấp vào +Trình thu thập để thêm các biến tuỳ chỉnh khác.
Khi bạn hoàn tất, hãy nhấp vào Build Solution (Giải pháp xây dựng).
Lưu và triển khai proxy.

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

LƯU Ý

Sẽ mất khoảng 30 phút để thêm một phương diện tuỳ chỉnh mới vào cơ sở dữ liệu sau khi chính sách Trình thu thập số liệu thống kê được gọi lần đầu tiên, cho từng môi trường. Ví dụ: nếu một proxy Thu thập số liệu thống kê được gọi trong môi trường test, thì dữ liệu cho thứ nguyên tùy chỉnh đó sẽ bắt đầu có trong môi trường test 30 phút sau đó và thứ nguyên tùy chỉnh sẽ xuất hiện trong danh sách thả xuống Phương diện của báo cáo tùy chỉnh.

Nếu proxy Thu thập số liệu thống kê đó được gọi từ môi trường prod thì sẽ mất khoảng 30 phút trước khi dữ liệu cho thứ nguyên tùy chỉnh đó bắt đầu có sẵn trong môi trường prod. Từ đó trở đi, dữ liệu sẽ được cung cấp sau cùng một khoảng thời gian với các tham số khác.