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

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

Nội dung

Cho phép bạn thu thập số liệu thống kê cho dữ liệu trong một thông báo, chẳng hạn như mã sản phẩm, giá, thao tác REST, URL của máy khách và mục tiêu, cũng như độ dài thông báo. Dữ liệu có thể đến từ các biến luồng do Apigee xác định trước hoặc các biến tuỳ chỉnh mà bạn xác định.

Dữ liệu thống kê được truyền đến máy chủ phân tích. Máy chủ này sẽ phân tích số liệu thống kê và tạo báo cáo. Bạn có thể xem các báo cáo này bằng cách sử dụng giao diện người dùng quản lý Edge hoặc Edge API.

Mẫu

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

Giới thiệu về chính sách Trình thu thập số liệu thống kê

Khi được thực thi, chính sách Trình thu thập số liệu thống kê sẽ ghi lại giá trị hiện tại của một hoặc nhiều biến. Các biến này có thể là biến luồng được Apigee xác định trước hoặc biến tuỳ chỉnh mà bạn xác định. Dữ liệu này được ghi vào máy chủ phân tích Edge.

Để truy cập vào dữ liệu thống kê do chính sách này thu thập, bạn có thể sử dụng Edge API hoặc giao diện người dùng quản lý Edge. Ví dụ: bạn có thể sử dụng giao diện người dùng quản lý Edge để tạo một báo cáo tuỳ chỉnh cho thấy dữ liệu đã thu thập ở nhiều định dạng.

Để xem hướng dẫn đầy đủ về cách sử dụng chính sách Trình thu thập số liệu thống kê, hãy xem bài viết Phân tích nội dung thông báo API bằng số liệu phân tích tuỳ chỉnh.

Vị trí đặt chính sách

Bạn có thể đặt chính sách Trình thu thập số liệu thống kê trong luồng yêu cầu hoặc phản hồi của một proxy API. Tuy nhiên, nếu bạn đặt nhiều chính sách Trình thu thập số liệu thống kê trong một proxy, thì chính sách cuối cùng được thực thi 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 Trình thu thập số liệu thống kê trước đó ghi sẽ bị mất.

Một trường hợp mà bạn có thể có nhiều chính sách Trình thu thập số liệu thống kê trong một proxy API là khi bạn có một chính sách trong luồng 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 xảy ra lỗi 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. Bạn có thể sử dụng Trình thu thập số liệu thống kê đó để ghi lại thông tin về lỗi hoặc ghi lại bất kỳ thông tin nào khác mà bạn cho là cần thiết. 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 bất kể Trình thu thập số liệu thống kê trong yêu cầu/phản hồi đã được thực thi hay chưa.

Để biết thêm thông tin, hãy xem phần Xử lý lỗi.

Tài liệu tham khảo về phần tử

Tài liệu tham khảo về phần tử mô tả các phần tử và thuộc tính của chính sách Trình thu thập số liệu thống kê.

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

Thuộc tính <StatisticsCollector>

<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Stats-1">

Bảng sau đây mô tả những thuộc tính chung cho tất cả phần tử mẹ của chính sách:

&lt;DisplayName&gt; phần tử

Hãy sử dụng cùng với thuộc tính name để gắn nhãn chính sách trong phần trình chỉnh sửa proxy giao diện người dùng quản lý có tên ngôn ngữ tự nhiên khác.

<DisplayName>Policy Display Name</DisplayName>

Phần tử <Statistics>/<Statistic>

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

Tham chiếu lỗi

Phần này mô tả thông báo lỗi và biến luồng được đặt khi chính sách này kích hoạt lỗi. Bạn cần biết thông tin này nếu đang phát triển quy tắc lỗi cho một proxy. Để tìm hiểu thêm, hãy xem bài viết Những điều cần biết về lỗi liên quan đến chính sách và Xử lý lỗi.

Lỗi thời gian chạy

Không có.

Lỗi triển khai

Biến lỗi

Không có.

Lược đồ

Mỗi loại chính sách được xác định bằng một giản đồ XML (.xsd). Để tham khảo, bạn có thể xem giản đồ chính sách trên GitHub.

Chủ đề có liên quan

Để biết thêm thông tin, hãy xem các bài viết sau:

• Phân tích nội dung thông báo API bằng số liệu phân tích tuỳ chỉnh
• Quản lý báo cáo tuỳ chỉnh
• Sử dụng API chỉ số để đo lường hiệu suất của chương trình API