Thống kê thu thập thống kê

Ví dụ cơ bản

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

Trong ví dụ này, bạn thu thập thông tin thống kê về hai biến tùy chỉnh: product.id và product.price. Trong mỗi yêu cầu, chính sách Trình thu thập số liệu thống kê sẽ ghi giá trị của hai biến này vào máy chủ phân tích.

Ví dụ này cũng đặt giá trị mặc định không bắt buộc cho mỗi biến, trong đó giá trị mặc định của product.id là 999999 và product.price mặc định là 0. Nếu một biến là không xác định và bạn không chỉ định giá trị mặc định, thì sẽ không có dữ liệu nào được ghi lại cho biến đó. Nếu bạn chỉ định một giá trị mặc định, thì giá trị mặc định sẽ được ghi lại khi biến không xác định.

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 số liệu thống kê. Khi truy xuất số liệu thống kê, bạn tham chiếu dữ liệu đã thu thập cho các biến này dưới dạng productID và price tương ứng.

Truy cập số liệu thống kê

Trong ví dụ này, bạn sử dụng Edge Management API để xem dữ liệu thống kê cho bộ sưu tập có tên là productID. Yêu cầu này tạo một báo cáo tuỳ chỉnh cho mã sản phẩm dựa trên tổng số tin nhắn đã gửi cho mỗi mã sản phẩm trong mỗi ngày. Thay thế tên tổ chức của bạn bằng biến {org_name} rồi thay thế email và mật khẩu bằng tài khoản của bạn trên Apigee Edge bằng email:password.

Đặt tham số timeRange để bao gồm khoảng thời gian khi dữ liệu được thu thập. Theo mặc định, không thể truy cập vào dữ liệu cũ hơn 6 tháng kể từ ngày hiện tại. Nếu bạn muốn truy cập dữ liệu cũ hơn 6 tháng, hãy liên hệ với Bộ phận hỗ trợ Apigee.

$ 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

Trong phản hồi, trường name chứa mã sản phẩm và giá trị cho biết số lượng yêu cầu cho mỗi ngày:

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

Trích xuất dữ liệu để thu thập

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

Chính sách của Trình thu thập số liệu thống kê yêu cầu lưu trữ dữ liệu đã thu thập trong các biến. Bạn có thể xác định trước các biến này bằng Apigee hoặc biến tuỳ chỉnh do bạn xác định.

Trong ví dụ này, bạn sử dụng chính sách Extract Variables (Trích xuất biến) để trích xuất dữ liệu từ tải trọng XML chứa thông tin thời tiết. Chính sách này:

• Trích xuất tên của thành phố và ghi tên đó vào một biến có tên là weather.location
• Trích xuất các điều kiện hiện tại và ghi vào một biến có tên là weather.condition

Sau đó, bạn có thể sử dụng chính sách Trình thu thập số liệu thống kê để thu thập thông tin về các biến, như minh hoạ dưới đây:

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="weatherLocation" ref="weather.location" type="string"></Statistic>
    <Statistic name="weatherCondition" ref="weather.condition" type="string"></Statistic>
  </Statistics>
</StatisticsCollector>

Để xem hướng dẫn đầy đủ về cách trích xuất dữ liệu từ một gói dữ liệu XML cho chính sách Trình thu thập số liệu thống kê, hãy xem phần Phân tích nội dung thông báo của API phân tích bằng cách sử dụng công cụ phân tích tuỳ chỉnh.