<ph type="x-smartling-placeholder"></ph>
현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보
API 플랫폼 기본 경로:
<ph type="x-smartling-placeholder">https://api.enterprise.apigee.com/v1/o/{org_name}</ph>
API 리소스 경로: /environments/{env_name}/stats/{dimension_name}
설명: GET 메서드를 사용하여 측정기준의 측정항목을 가져옵니다.
| 동사: | 받기 |
| 인증: | 기본 인증 |
| 미디어 유형: |
application/json
|
개요: 보고서는
/stats API에서 GET 요청을 사용하여 생성됩니다.
리소스에 다음 코드를 함께 제공합니다.
- 보고서의 측정기준을 정의하는 URI 매개변수입니다(선택사항). Apigee는 이러한 측정기준에 대해 측정항목 집합을 사전 집계합니다. 측정기준이 없는 경우 (URI 매개변수가 비어 있는 경우) 모든 API에 대한 보고서가 생성됩니다. 항상 존재합니다.
- 측정항목, 기간, 시간 간격, 보고서의 필터/드릴다운 측면
dimension_name: API가 해당하는 항목을 정의하는 URI 매개변수입니다.
플랫폼 측정항목을 가져와야 합니다. Apigee는 다음에서 사용할 수 있는 측정기준 집합을 정의합니다.
있습니다. 지원되는 측정기준은 다음과 같습니다.
/stats/apis: API 플랫폼의 조직의 API 프록시/stats/apiproducts: 조직에 정의된 API 제품/stats/apps: API에 요청하는 개발자 앱의 이름/stats/client_ip: API에서 API에 요청하는 앱의 IP 주소입니다. 플랫폼/stats/developer_email: Google Cloud Platform을 사용해/stats/developer_app: 요청을 실행하는 개발자 앱의 이름 내 API/stats/devs: Google Cloud Platform을 사용해/stats/access_token: 앱 최종 사용자의 OAuth 액세스 토큰
필터는 커스텀 리소스에 적용할 수 있습니다. 커스텀 리소스는 다음과 같습니다.
| 기호 | 작업 |
|---|---|
in |
(목록 포함) |
notin |
(목록 제외) |
eq |
= |
ne |
!= 또는 |
gt |
> |
lt |
|
ge |
>= |
le |
| 설명 | 쿼리 구조 필터링 |
|---|---|
| 이름이 api1 또는 api2인 API 프록시 통계 | filter=(apiproxy in 'api1','api2') |
| api1 및 api2를 제외한 모든 API 프록시 통계 | filter=(apiproxy notin 'ap1','api2') |
| 오류가 없는 통계 | filter=(iserror eq 0) |
| 오류 메시지가 없거나 API 프록시 이름이 api1 또는 api2인 통계입니다. | filter=(iserror eq 1) or (apiproxy in 'api1','api2') |
| (응답 코드가 201 또는 301) 및 (오류가 있음) 또는 (API 프록시)인 통계 이름은 api1 또는 api2임) | filter=(responsecode le 201 or responsecode eq 301) and (iserror eq 1) or
(apiproxy in 'api1','api2') |
샘플 요청:
$ curl -X GET -H "Accept:application/json" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env_name}/stats/{dimension_name}?"select={metric_name}&timeRange=1/1/2013%2000:00~1/2/2013%2000:00&timeUnit=hour&sortby={metric_name}&sort=DESC&filter=(apiproxy%20in%20'weather','news')" \
-u myname:mypass
| 이름 | 설명 | 기본값 | 필수 여부 |
|---|---|---|---|
| select | 보고서에 대해 집계할 측정항목을 지정합니다. 지원되는 측정항목은 message_count, error_count, total_response_time, max_response_time, min_response_time, 데이터 교환 크기, 종료점_응답_시간 | 해당 사항 없음 | 예 |
| timeRange | 원하는 간격의 시작 및 종료 시간입니다. 날짜 형식은 MM/DD/YYYY HH:MM입니다. 예: 1/1/2013%2000:00~1/2/2013%2000:00. 최대 기간은 6개월입니다. | 해당 사항 없음 | 예 |
| timeUnit | 초, 분, 시간, 일, 주, 월, 분기, 연도, 10년, 세기, 천년 | 해당 사항 없음 | 예 |
| sortby | 둘 이상의 select 값이 지정되면 'sortby' 인코더-디코더 아키텍처를 결과 정렬에 사용되는 선택: message_count, error_count, total_response_time, max_response_time, min_response_time, data_exchange_size, end_point_response_time | 해당 사항 없음 | 아니요 |
| 정렬 | 지원되는 정렬 범위는 DESC 또는 ASC입니다. | 해당 사항 없음 | 아니요 |
| topk | 'top k' 가져오기 예를 들어 상위 5개 결과를 반환 'topk=5'로 설정합니다. | 해당 사항 없음 | 아니요 |
| filter | 특정 측정기준 값에 대한 상세보기 사용 설정 | 해당 사항 없음 | 아니요 |
| 제한 | API에서 반환하는 항목 수의 한도를 설정합니다. | 해당 사항 없음 | 아니요 |
| 오프셋 | 결과를 페이지로 나누려면 제한이 있는 오프셋을 사용하세요. 예를 들어 11~20, 제한을 '10'으로 설정 오프셋을 '10'으로 설정합니다. | 해당 사항 없음 | 아니요 |
{
"environments" : [ {
"dimensions" : [ {
"metrics" : [
{
"name" : "message_count",
"values" : [ {
"timestamp" : 1335241800000,
"value" : "1.0"
} ]
} ,
{
"name" : "error_count",
"values" : [ {
"timestamp" : 1335241800000,
"value" : "0.0"
} ]
}
],
"name" : "api1"
},
{
"metrics" : [
{
"name" : "message_count",
"values" : [ {
"timestamp" : 1335241800000,
"value" : "1.0"
} ]
},
{
"name" : "error_count",
"values" : [ {
"timestamp" : 1335241800000,
"value" : "0.0"
} ]
}
],
"name" : "api2"
}
],
"name" : "test"
}
],
"metaData" : {
}
}| 이름 | 설명 |
|---|---|
| 메타데이터 | 보고서와 관련된 메타데이터 |
| environments | 통계가 수집되는 조직의 환경 (와일드 카드 지원) * 교차 환경 통계 수집용) |
| 측정항목 | 지정된 측정기준에 대해 반환된 값입니다. |
| 측정기준 | 측정을 위해 정의된 측정기준: 이 예에서는 api_name입니다. |
| 측정항목 | 보고서 측정항목 |