StatisticsCollector 정책

기본 예시

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

이 예시에서는 product.id와 product.price라는 2가지 맞춤 변수에 대한 통계 정보를 수집합니다. 모든 요청에서 통계 수집기 정책은 이 두 변수의 값을 분석 서버에 씁니다.

또한 이 예에서는 각 변수에 대해 선택적 기본값을 설정합니다. 여기서 product.id의 기본값은 999999이고 기본 product.price는 0입니다. 변수가 정의되지 않은 상태에서 기본값을 지정하지 않으면 변수에 대한 데이터가 기록되지 않습니다. 기본값을 지정하면 변수가 정의되지 않을 때 기본값이 기록됩니다.

통계 데이터를 수집한 후 Edge 관리 UI 또는 API를 사용하여 통계를 검색할 수 있습니다. 통계를 가져올 때 이러한 변수에 대해 수집된 데이터를 각각 productID 및 price로 참조합니다.

통계 액세스

이 예시에서는 Edge management API를 사용하여 productID라는 컬렉션의 통계 데이터를 확인합니다. 이 요청은 매일 각 제품 ID에 제출된 메시지 수의 합계를 기반으로 제품 ID에 대한 커스텀 보고서를 작성합니다. {org_name} 변수를 조직 이름으로, email:password을 Apigee Edge 계정의 이메일 및 비밀번호로 대체합니다.

데이터가 수집된 시간 간격을 포함하도록 timeRange 매개변수를 설정합니다. 현재 날짜로부터 6개월 이상 지난 데이터는 기본적으로 액세스할 수 없습니다. 6개월 넘게 지난 데이터에 액세스하려면 Apigee Edge 지원팀에 문의하세요.

$ 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

응답의 name 필드에는 제품 ID가 포함되며 값은 일일 요청 수를 보여줍니다.

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

통계 수집기 정책에 따라 수집된 데이터는 변수에 저장해야 합니다. 이러한 변수는 Apigee에서 사전 정의할 수도 있고 사용자가 정의하는 커스텀 변수가 될 수도 있습니다.

이 예시에서는 변수 추출 정책을 사용하여 날씨 정보가 포함된 XML 페이로드에서 데이터를 추출합니다. 정책은 다음과 같은 역할을 합니다.

• 도시 이름을 추출하여 weather.location이라는 변수에 씁니다.
• 현재 조건을 추출하여 weather.condition이라는 변수에 씁니다.

그런 다음 아래와 같이 통계 수집기 정책을 사용하여 변수에 대한 정보를 수집할 수 있습니다.

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

통계 수집기 정책의 XML 페이로드에서 데이터를 추출하는 방법을 보여주는 전체 가이드는 커스텀 분석을 사용하여 API 메시지 콘텐츠 분석을 참조하세요.