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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về 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á, REST hành động, URL mục tiêu, URL mục tiêu và độ dài thông báo. Dữ liệu này có thể đến từ biến luồng do Apigee hoặc các biến tuỳ chỉnh mà bạn xác định.

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

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 thống kê 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 do Apigee hoặc biến tuỳ chỉnh xác định trước 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ê mà chính sách thu thập, bạn hãy sử dụng Edge API hoặc Edge giao diện người dùng quản lý. 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 hiển thị dữ liệu đã thu thập ở nhiều định dạng khác nhau.

Để xem hướng dẫn đầy đủ về cách sử dụng chính sách Trình thu thập thống kê, hãy xem Phân tích API bằng cách sử dụ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 thống kê vào quy trình yêu cầu hoặc phản hồi của API proxy. Tuy nhiên, nếu bạn đặt nhiều chính sách Trình thu thập thống kê vào một proxy, thì chính sách cuối cùng một lệnh để thực thi xác định dữ liệu được ghi vào máy chủ phân tích và dữ liệu được ghi bởi bất kỳ các chính sách trước đây của Trình thu thập dữ liệu thống kê 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 proxy API là khi bạn có một tệp trong quy trình yêu cầu hoặc phản hồi và một tệp khác trong trình xử lý lỗi. Nếu xảy ra 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 đã thu thập. Bạn có thể sử dụng Trình thu thập thống kê đó để ghi lại thông tin về lỗi hoặc để hãy ghi lại mọi thông tin khác mà bạn cho là cần thiết. Người thu thập thống kê bị lỗi trình xử lý xác định dữ liệu được thu thập bất kể Trình thu thập thống kê hay không trong yêu cầu/phản hồi đã được thực thi.

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

Tham chiếu phần tử

Tham chiếu phần tử mô tả các phần tử và thuộc tính của Trình thu thập 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>

<StatisticsCollector> thuộc tính

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

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

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

<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). Giản đồ chính sách để tham khảo đều có 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 API nội dung tin nhắn 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 các API chỉ số để đo lường hiệu suất của chương trình API