이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.
Apigee Edge 문서 보기
분석 측정항목, 측정기준, 필터에 대한 참조를 주제로 다룹니다. 자세한 내용은 API 분석 개요를 참조하세요.
이 주제에서는 UI에 표시되고 API 호출에 사용해야 하는 측정항목 및 측정기준의 이름을 보여줍니다.
- UI 이름은 맞춤 보고서를 만들고 관리할 때 표시됩니다.
- 측정항목 가져오기, 보고서 생성 정의 또는 보고서 업데이트 정의 시 API별 이름을 사용합니다.
측정항목
다음은 커스텀 보고서와 Apigee API 호출에서 검색할 수 있는 API 측정항목입니다.
| 측정항목 | Apigee API에서 사용할 이름 | 함수 | 설명 |
|---|---|---|---|
| 초당 평균 트랜잭션 수입니다. | tps |
없음 |
초당 API 프록시 요청을 의미하는 평균 트랜잭션 수입니다. 특정 기간 동안 상대적으로 낮은 트랜잭션 수를 가지고 있다면 초당 평균 트랜잭션 수는 숫자가 소수점 두 자리보다 작다면 UI 맞춤 보고서에서 0으로 나타납니다. API 구문: |
| 캐시 적중 | cache_hit |
합계 |
대상 서비스의 응답 대신 API 구문: |
| L1 캐시 요소 수입니다. | ax_cache_l1_count |
avg, min, max |
일정 기간 동안 트랜잭션당 L1(메모리 내) 캐시의 요소 수입니다. 예를 들어 하루의 특정 기간 동안 API 구문: |
| 정책 오류 | policy_error |
합계 |
지정된 기간 동안의 총 정책 오류 수입니다. 정책 오류는 일반적으로 설계에 따라 발생하는 계획적인 오류입니다. 예를 들어 요청에 잘못된 API 키가 전달되면 정책 오류는 이 오류로 인해 API 프록시가 실패하는 경우에만 분석에 로깅됩니다.
예를 들어 정책의 오류의 정책 이름( 대상 오류(예시: API 구문: |
| 프록시 오류 | is_error |
합계 |
지정된 기간 동안 API 프록시가 실패한 총 횟수입니다. 프록시 실패는 정책이 실패하거나 대상 서비스에서 프록시( API 구문: |
| 요청 처리 지연 시간 | request_processing_latency |
avg, min, max |
Apigee에서 수신 요청을 처리하는 데 걸리는 밀리초 단위의 (평균, 최소 또는 최대) 시간입니다. 이 시간은 요청이 Apigee에 도달할 때부터 시작되며 Apigee에서 요청을 대상 서비스로 전달하면 종료됩니다. 다른 측정기준을 사용하여 API 프록시, 개발자 앱, 리전 등을 기준으로 요청 처리 지연 시간을 검사할 수 있습니다. API 구문: |
| 요청 크기 | request_size |
sum, avg, min, max |
Apigee에서 수신한 요청 페이로드 크기(바이트)입니다. API 구문: |
| 실행된 응답 캐시 | ax_cache_executed |
합계 |
일정 기간 동안
그러나 정책의 디버그 도구에서 실행된 API 호출의 API 구문: |
| 응답 처리 지연 시간 | response_processing_latency |
avg, min, max |
Apigee에서 API 응답을 처리하는 데 걸리는 밀리초 단위의 (평균, 최소 또는 최대) 시간입니다. API 프록시가 대상 서비스 응답을 받으면 시간이 시작되고 Apigee가 응답을 원래 발신자에게 전달하면 시간이 종료됩니다. 다른 측정기준을 사용하여 API 프록시, 리전 등을 기준으로 응답 처리 지연 시간을 검사할 수 있습니다. API 구문: |
| 응답 크기 | response_size |
sum, avg, min, max |
클라이언트에 반환된 응답 페이로드의 크기(바이트)입니다. API 구문: |
| 대상 오류 | target_error |
합계 |
대상 서비스의 총 API 구문: |
| 대상 응답 시간 | target_response_time |
sum, avg, min, max |
대상 서버가 호출에 응답할 수 있는 시간(합계, 평균, 최소 또는 최대)(밀리초)입니다. 이 측정항목은 대상 서버의 성능을 나타냅니다. Apigee가 요청을 대상 서비스로 전달하면 시작되고 Apigee에서 응답을 받으면 종료됩니다. API 호출이 캐시에서 응답을 반환하면(예: API 구문: |
| 총 응답 시간 | total_response_time |
sum, avg, min, max |
Apigee가 클라이언트에게 응답을 받을 때부터 Apigee가 클라이언트에게 응답을 다시 보낼 때까지 걸리는 밀리초 단위의 (합계, 평균, 최소 또는 최대) 시간입니다. 이 시간에는 네트워크 오버헤드(예를 들어 부하 분산기와 라우터가 작업을 하는 데 걸리는 시간), 요청 처리 지연 시간, 응답 처리 지연 시간, 대상 응답 시간(응답이 캐시 대신 대상 서비스에서 제공되는 경우)이 포함됩니다. 다른 측정기준을 사용하여 API 프록시, 개발자 앱, 리전 등을 기준으로 처리 지연 시간을 검사할 수 있습니다. API 구문: |
| 트래픽 | message_count |
합계 |
특정 기간 동안 Apigee에서 처리한 총 API 호출 수입니다. 측정기준을 사용하여 가장 의미있는 방식으로 트래픽 수를 그룹화합니다. API 구문: |
| 수익 창출 | |||
| 요금 | fees |
sum, avg, min, max |
설정 수수료, 반복 수수료, 선불 잔액 충전을 나타내는 금액입니다. API 구문: |
| 개발자 수익 공유 | x_apigee_mintng_dev_share |
sum, avg, min, max |
트랜잭션 수익의 개발자 공유입니다. Apigee는 요금제에서 수익 공유를 사용 설정한 경우에만 개발자의 공유분을 계산합니다. 개발자의 공유분은 다음 수식을 사용하여 계산됩니다. x_apigee_mintng_dev_share = revShareGrossPrice * (share percentage)
공유 백분율의 값은 요금제에서 가져옵니다. API 구문: |
| 수익 창출 가격 | x_apigee_mintng_price |
sum, avg, min, max |
트랜잭션의 총 수익입니다.
트랜잭션의 수익은 DataCapture 정책에서 캡처된 API 구문: |
| API 가격 배수 | x_apigee_mintng_price_multiplier |
sum, avg, min, max |
트랜잭션당 비용을 곱하는 계수(배수)입니다. 트랜잭션당 비용은 요금제의 사용량 기반 요금 가격 책정에 지정됩니다. API 구문: |
| 수익 창출률 | x_apigee_mintng_rate |
sum, avg, min, max |
트랜잭션에 청구되는 요율입니다. 트랜잭션에 청구되는 요율은 다음 수식을 사용하여 계산됩니다. x_apigee_mintng_rate = (consumption-based pricing rate) * perUnitPriceMultiplier value
소비 기반 가격 책정 요율의 값은 요금제에서 가져오고, API 구문: |
측정기준
측정기준을 사용하여 측정항목을 의미있는 그룹화로 확인할 수 있습니다. 예를 들어 각 개발자 앱 또는 API 프록시에서 총 트래픽 수를 확인할 때 총 트래픽 수가 훨씬 강력해집니다.
다음은 Apigee에서 즉시 사용할 수 있는 측정기준입니다.
| 측정기준 | Apigee API에서 사용할 이름 | 설명 |
|---|---|---|
| 액세스 토큰 | access_token |
앱 최종 사용자의 OAuth 액세스 토큰입니다. |
| API 제품 | api_product |
|
| 캐시 키 | ax_cache_key |
액세스한 디버그 도구의 캐시에서 읽고 쓰는 |
| 캐시 이름 | ax_cache_name |
디버그 도구에서 |
| 캐시 소스 | ax_cache_source |
디버그 도구에서 캐시 수준에 대한 자세한 내용은 캐시 내부를 참조하세요. |
| 클라이언트 ID | client_id |
요청에 API 키로 전달되거나 OAuth 토큰에 포함된 API 호출을 하는 개발자 앱의 고객 키(API 키)입니다. 이 측정기준을 가져오려면 호출을 수신하는 프록시가 유효한 API 키 또는 OAuth 토큰을 확인하도록 구성해야 합니다. 개발자 앱은 앱이 Apigee에 등록될 때 OAuth 토큰을 생성하는 데 사용할 수 있는 API 키를 가져옵니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요. 위 기준을 충족하지 못하면 |
| 개발자 앱 | developer_app |
API 호출을 수행하는 Apigee에 등록된 개발자 앱 이 측정기준을 가져오려면 앱이 호출되는 API 프록시를 포함하는 하나 이상의 API 제품과 연결되어야 하며, 프록시는 API 호출과 함께 전송되는 API 키 또는 OAuth 토큰을 확인해야 합니다. 키 또는 토큰은 개발자 앱을 식별합니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요. 위 기준을 충족하지 못하면 |
| 개발자 이메일 | developer_email |
|
| 개발자 ID | developer |
Apigee에서 생성하는 고유한 개발자 ID로서 이 측정기준을 가져오려면 개발자는 호출되는 API 프록시를 포함하는 하나 이상의 API 제품과 연결된 앱을 가지고 있어야 하며, 프록시는 API 호출과 함께 전송되는 API 키 또는 OAuth 토큰을 확인해야 합니다. 키 또는 토큰으로 개발자를 식별합니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요. 위 기준을 충족하지 못하면 |
| 환경 | environment |
API 프록시가 배포되는 Apigee 환경입니다. 예를 들면 test 또는 prod입니다. |
| 오류 시 오류 코드 | ax_edge_execution_fault_code |
오류의 오류 코드입니다. 예를 들면 다음과 같습니다.
|
| 오류의 흐름 이름 | ax_execution_fault |
오류를 일으킨 API 프록시에서 이름이 지정된 흐름입니다. 예를 들면 Apigee API에서 사용할 전체 이름은 줄바꿈 없이 오류가 발생하지 않으면 |
| 흐름 리소스 | flow_resource |
Apigee 전용입니다. 궁금한 점이 있으면 애널리틱스에서 '리소스 흐름' 측정기준 사용 방법을 참조하세요. |
| 오류의 흐름 상태 | ax_execution_fault |
Apigee API에서 사용할 전체 이름은 줄바꿈 없이 |
| 게이트웨이 흐름 ID | gateway_flow_id |
API 호출이 Apigee를 통해 이동하는 경우 각 호출에는 자체 게이트웨이 흐름 ID가 있습니다. 예시: rrt329ea-12575-114653952-1. 게이트웨이 흐름 ID는 조직, 환경, 타임스탬프와 같은 다른 측정 기준이 모든 호출에서 동일한 높은 TPS가 상황에서 측정항목을 구분하는 데 유용합니다. |
| 조직 | organization |
API 프록시가 배포되는 Apigee 조직입니다. |
| 오류의 정책 이름 | ax_execution_fault |
오류를 발생시켜 API 호출이 실패하도록 한 정책의 이름입니다. Apigee API에서 사용할 전체 이름은 줄바꿈 없이 정책에서 오류가 발생하지만 정책 루트 속성 |
| 프록시 | apiproxy |
API 프록시의 머신 이름(표시 이름 아님)입니다. |
| 프록시 기본 경로 | proxy_basepath |
API 프록시 ProxyEndpoint에 구성된 기본 경로입니다. 기본 경로에는 API 프록시 URL의 도메인 및 포트 부분이 포함되지 않습니다. 예를 들어 API 프록시의 기본 URL이 이 값은 |
| 프록시 배포 유형 | proxy_deployment_type |
배포된 프록시의 API 프록시 유형입니다. 프록시 유형을 지정하면 해당 프록시 유형으로 결과가 제한됩니다. 이 측정기준은 프록시 유형을 사용하는 사용한 만큼만 지불 및 2024년 구독 사용자에게만 적용됩니다. 가능한 값은 |
| 프록시 경로 서픽스 | proxy_pathsuffix |
API 프록시 기본 경로에 추가된 리소스 경로입니다. 예를 들어 API 프록시의 기본 URL이
이 값은 |
| 프록시 버전 | apiproxy_revision |
API 호출을 처리한 API 프록시의 버전 번호입니다. 그렇다고 해서 API 프록시의 최신 버전을 의미하지는 않습니다. API 프록시에 10개의 버전이 있는 경우 8번째 버전은 현재 배포될 수 있습니다. 또한 프록시 배포에 설명된 대로 버전마다 기본 경로가 서로 다른 한 API에 여러 버전이 배포될 수 있습니다. |
| 확인된 클라이언트 IP | ax_resolved_client_ip |
발신 클라이언트 IP 주소입니다. Akamai와 같은 라우팅 제품을 사용하여 클라이언트의 실제 IP 주소를 캡처하면 클라이언트 IP가 HTTP 헤더
|
| 응답 상태 코드 | response_status_code |
Apigee에서 클라이언트로 전달된 200, 404, 503 등의 HTTP 응답 상태 코드입니다. Apigee에서는 대상의 응답 상태 코드를 AssignMessage 정책 및 RaiseFault 정책과 같은 정책으로 덮어쓸 수 있습니다. 이로 인해 이 측정기준이 대상 응답 코드(target_response_code)와 다를 수 있습니다. |
| 가상 호스트 | virtual_host |
API 호출이 실행된 가상 호스트의 이름입니다. 자세한 내용은 환경 및 환경 그룹 정보를 참조하세요. |
| 인바운드/클라이언트 | ||
| 클라이언트 IP 주소 | client_ip |
원본 클라이언트(proxy_client_ip) 또는 부하 분산기와 같이 라우터에 도달하는 시스템의 IP 주소입니다. X-Forwarded-For 헤더에 여러 IP가 있으면 이는 나열된 마지막 IP입니다. |
| 기기 카테고리 | ax_ua_device_category |
Tablet 또는 Smartphone 등 API 호출을 수행한 기기의 유형입니다. |
| OS 제품군 | ax_ua_os_family |
Android 또는 iOS 등 호출을 수행하는 기기의 운영체제 제품군입니다. |
| OS 버전 | ax_ua_os_version |
호출을 수행하는 기기의 운영체제 버전입니다. 이를 OS 제품군(ax_ua_os_family)이 포함된 두 번째 드릴다운 측정기준으로 사용하면 운영체제 버전을 확인하는 데 유용합니다. |
| 프록시 클라이언트 IP | proxy_client_ip |
|
| 추천 클라이언트 IP | ax_true_client_ip |
Akamai와 같은 라우팅 제품을 사용하여 클라이언트의 실제 IP 주소를 캡처하면 클라이언트 IP가 HTTP 헤더
|
| 요청 경로 | request_path |
쿼리 매개변수를 제외하고 대상 서비스에 대한 리소스 경로(도메인 제외)입니다. 예를 들어 Apigee 샘플 대상 |
| URI 요청 | request_uri |
쿼리 매개변수를 포함한 대상 서비스에 대한 리소스 경로(도메인 제외)입니다. 예를 들어 Apigee 샘플 대상 |
| 요청 동사 | request_verb |
GET, POST, PUT, DELETE와 같은 API 요청의 HTTP 요청 동사입니다. |
| 사용자 에이전트 | useragent |
API 호출을 수행하는 데 사용되는 사용자 에이전트 또는 소프트웨어 에이전트의 이름입니다. 예:
|
| 사용자 에이전트 제품군 | ax_ua_agent_family |
Chrome Mobile 또는 curl 등의 사용자 에이전트 제품군입니다. |
| 사용자 에이전트 유형 | ax_ua_agent_type |
Browser, Mobile Browser, Library 등의 사용자 에이전트 유형입니다. |
| 사용자 에이전트 버전 | ax_ua_agent_version |
useragent의 버전입니다. 사용자 에이전트 제품군(ax_ua_agent_family)에서 두 번째 드릴다운 측정기준으로 사용하면 에이전트 제품군의 버전을 가져오는 데 유용합니다. |
| 아웃바운드/대상 | ||
| Target | target |
요청을 처리한 대상 엔드포인트입니다. default). |
| 대상 기본 경로 | target_basepath |
프록시의 예를 들어 API 프록시가 다음 대상을 호출한다고 가정해 보겠습니다. <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> 이 예시에서 target_basepath는 대상이 다음과 같은 경우: <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net</URL> </HTTPTargetConnection> target_basepath가 null이 됩니다. 디버그 도구에서 흐름 다이어그램의 끝에 있는 AX 아이콘을 선택하면 |
| gRPC 서비스 이름 | x_apigee_grpc_service_name |
대상 서비스가 gRPC인 경우에만 적용됩니다. gRPC 서비스 이름입니다. gRPC 프록시에 대한 자세한 내용은 gRPC API 프록시 만들기를 참조하세요. |
| gRPC 상태 | x_apigee_grpc_status |
대상 서비스가 gRPC인 경우에만 적용됩니다. gRPC 요청 상태입니다. gRPC 프록시에 대한 자세한 내용은 gRPC API 프록시 만들기를 참조하세요. |
| 대상 호스트 | target_host |
대상 서비스의 호스트입니다. 예를 들어 API 프록시가 http://mocktarget.apigee.net/help를 호출하면 target_host는 mocktarget.apigee.net입니다. |
| 대상 IP 주소 | target_ip |
API 프록시에 응답을 반환하는 대상 서비스의 IP 주소입니다. |
| 대상 응답 코드 | target_response_code |
이는 응답 상태 코드(response_status_code) 측정기준과는 다릅니다. |
| gRPC RPC 이름 | x_apigee_grpc_rpc_name |
대상 서비스가 gRPC인 경우에만 적용됩니다. RPC 이름입니다. gRPC 프록시에 대한 자세한 내용은 gRPC API 프록시 만들기를 참조하세요. |
| 대상 URL | target_url |
API 프록시의 TargetEndpoint에 정의된 대상 서비스의 전체 URL입니다. <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> 이 예시에서 target_url은
프록시 체이닝에서 호출 프록시의 target_url은 null입니다. |
| X-Forwarded-For IP | x_forwarded_for_ip |
|
| X-Forwarded-For Proto | x_forwarded_proto |
클라이언트가 라우터에 연결하는 데 사용한 프로토콜입니다. 유효한 값은 |
| 시간 | ||
| 요일 | ax_day_of_week |
API 호출이 수행된 요일의 세 글자 약어입니다. 예시: Mon, Tue, Wed |
| 월 | ax_month_of_year |
API 호출이 수행된 월(숫자)입니다. 예를 들어 3월의 경우 03입니다. |
| 시간 | ax_hour_of_day |
24시간제를 기준으로 API 호출이 수행된 두 자릿수 시간입니다. 예를 들어 API 호출은 오후 10시에서 11시 사이에 이루어지며 ax_hour_of_day는 22입니다. 시간 값은 UTC 기준입니다. |
| 시간대 | ax_geo_timezone |
America/New_York 및 Europe/Dublin 등 API 호출이 수행된 시간대의 일반적인 이름입니다. |
| 월별 주차 | ax_week_of_month |
특정 달의 주차 숫자 값입니다. 예를 들어 특정 달의 세 번째 주에 수행된 API 호출의 경우 ax_week_of_month는 3입니다. |
| Location | ||
| 시 | ax_geo_city |
API 호출이 수행된 도시입니다. |
| 대륙 | ax_geo_continent |
API 호출이 수행된 대륙의 두 글자 코드입니다. 예를 들어 북미의 경우
NA입니다. |
| 국가 | ax_geo_country |
API 호출이 수행된 국가의 두 자리 코드입니다. 예를 들어 미국은
US입니다. |
| 지역 | ax_geo_region |
STATE-COUNTRY와 같이 하이픈으로 연결된 지리적 영역의 코드입니다. 예를 들어 워싱턴-미국의 경우 WA-US입니다. |
| 리전 | ax_dn_region |
us-east-1과 같이 API 프록시가 배포되는 Apigee 데이터 센터의 이름입니다. |
| 수익 창출 | ||
| 생성됨 | created |
현재 Apigee 조직에서 사용할 수 있지만 Apigee Hybrid 조직에서는 사용할 수 없습니다. 앱 개발자 및 API 제품에 대한 수수료 관련 일정이 추가된 Unix 타임스탬프입니다. |
| 수수료 유형 | fees_type |
수수료 유형입니다. 설정 수수료, 반복 수수료, 선불 잔액 충전일 수 있습니다. 이 값은 Fees 측정항목을 선택한 경우에만 채워집니다. |
| 수익 통화 | x_apigee_mintng_currency |
|
| 요금제 ID | x_apigee_mintng_rate_plan_id |
현재 Apigee 조직에서 사용할 수 있으며 Apigee Hybrid 조직에서는 사용할 수 없습니다. 앱 개발자의 수익 창출 요금제입니다. |
| 트랜잭션 성공 | x_apigee_mintng_tx_success |
트랜잭션의 수익 창출 상태는 DataCapture 정책에 캡처된 transactionSuccess 수익 창출 변수의 값으로 설정됩니다. |
필터
필터를 사용하면 특정 특성이 있는 측정항목으로 결과를 제한할 수 있습니다. 다음은 몇 가지 샘플 필터입니다. 필터를 정의할 때 측정항목 및 측정기준 API 스타일의 이름을 사용합니다.
이름 목록 또는 음악이 있는 API 프록시에 대한 측정항목을 반환합니다.
filter=(apiproxy in 'books','music')
이름이 m으로 시작하는 API 프록시 측정항목을 반환합니다.
filter=(apiproxy like 'm%')
이름이 m으로 시작하지 않는 API 프록시 측정항목을 반환합니다.
filter=(apiproxy not like 'm%')
400에서 599 사이의 응답 상태 코드가 있는 API 호출의 측정항목을 반환합니다.
filter=(response_status_code ge 400 and response_status_code le 599)
응답 상태 코드가 200이고 대상 응답 코드가 404인 API 호출의 측정항목을 반환합니다.
filter=(response_status_code eq 200 and target_response_code eq 404)
응답 상태 코드가 500인 API 호출의 측정항목을 반환합니다.
filter=(response_status_code eq 500)
오류가 발생하지 않은 API 호출의 측정항목을 반환합니다.
filter=(is_error eq 0)
null 응답이 발생하지 않은 API 호출의 측정항목을 반환합니다.
filter=(response_status_code isnot null)
다음은 보고서 필터를 빌드하는 데 사용할 수 있는 연산자입니다.
| 연산자 | 설명 |
|---|---|
in |
목록에 포함 |
notin |
목록에서 제외 |
is |
response_status_code is null를 사용해서 상태 코드가 null인 응답을 필터링합니다. |
isnot |
response_status_code isnot null를 사용해서 상태 코드가 null이 아닌 응답을 필터링합니다. |
eq |
같음, == |
ne |
같지 않음, != |
gt |
초과, > |
lt |
미만, < |
ge |
이상, >= |
le |
이하, <= |
like |
문자열 패턴이 제공된 패턴과 일치하면 true를 반환합니다. |
not like |
문자열 패턴이 제공된 패턴과 일치하면 false를 반환합니다. |
similar to |
패턴이 지정된 문자열과 일치하는지 여부에 따라 true 또는 false를 반환합니다. 정규 표현식의 SQL 표준 정의를 사용하여 패턴을 해석한다는 점을 제외하면 like과 유사합니다. |
not similar to |
패턴이 지정된 문자열과 일치하는지 여부에 따라 false 또는 true를 반환합니다. 정규 표현식의 SQL 표준 정의를 사용하여 패턴을 해석한다는 점을 제외하면 not like와 유사합니다. |
and |
AND 논리를 사용하여 두 개 이상의 필터 표현식을 포함할 수 있습니다. 필터에는 모든 조건을 충족하는 데이터가 포함됩니다. |
or |
OR 논리를 사용하여 가능한 여러 필터 표현식을 평가할 수 있습니다. 필터에는 조건 중 하나 이상을 충족하는 데이터가 포함됩니다. |