애널리틱스 측정항목, 측정기준, 필터 참조

이 페이지는 ApigeeApigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

분석 측정항목, 측정기준, 필터에 대한 참조를 주제로 다룹니다. 자세한 내용은 API 분석 개요를 참조하세요.

이 주제에서는 UI에 표시되고 API 호출에 사용해야 하는 측정항목 및 측정기준의 이름을 보여줍니다.

측정항목

다음은 커스텀 보고서와 Apigee API 호출에서 검색할 수 있는 API 측정항목입니다.

측정항목 Apigee API에서 사용할 이름 함수 설명
초당 평균 트랜잭션 수입니다. tps 없음

초당 API 프록시 요청을 의미하는 평균 트랜잭션 수입니다. 특정 기간 동안 상대적으로 낮은 트랜잭션 수를 가지고 있다면 초당 평균 트랜잭션 수는 숫자가 소수점 두 자리보다 작다면 UI 맞춤 보고서에서 0으로 나타납니다.

API 구문: tps

캐시 적중 cache_hit 합계

대상 서비스의 응답 대신 ResponseCache를 사용하는 성공적인 API 요청 수입니다.

API 구문: sum(cache_hit)

L1 캐시 요소 수입니다. ax_cache_l1_count avg, min, max

일정 기간 동안 트랜잭션당 L1(메모리 내) 캐시의 요소 수입니다. 예를 들어 하루의 특정 기간 동안 max를 선택하고 해당 날짜 동안 특정 트랜잭션에 대해 캐시의 가장 많은 요소 수가 12인 경우 카운트는 12가 됩니다. avg의 경우 쿼리하는 기간에 3개의 트랜잭션이 있고 캐시 카운트가 5, 6, 7인 경우 평균은 6입니다. L1 캐시는 캐시 내부에 설명된 대로 L2 데이터베이스 캐시가 아닌 메모리 내 캐시입니다.

API 구문: avg(ax_cache_l1_count)

정책 오류 policy_error 합계

지정된 기간 동안의 총 정책 오류 수입니다.

정책 오류는 일반적으로 설계에 따라 발생하는 계획적인 오류입니다. 예를 들어 요청에 잘못된 API 키가 전달되면 VerifyApiKey 정책에서 오류가 발생하지만 API 호출 수가 정책에 정의된 한도를 초과하면 SpikeArrest 정책에서 오류가 발생합니다. 따라서 이 측정항목은 API에서 잠재적인 문제가 있는 부분을 찾을 때 유용합니다. 예를 들어 developer_app 측정기준으로 그룹화된 policy_error 측정항목은 특정 앱의 API 키 또는 OAuth 토큰이 만료되었음을 확인하는 데 도움이 될 수 있습니다. 또는 특정 API 프록시에서 SpikeArrest 정책 오류가 많이 발생하면 프록시의 급증 저지 한도에 연말연시 트래픽 증가가 반영되지 않았음 알 수 있습니다.

정책 오류는 이 오류로 인해 API 프록시가 실패하는 경우에만 분석에 로깅됩니다. 예를 들어 정책의 continueOnError 속성이 true로 설정된 경우 API 프록시에서 정책이 실패하더라도 요청을 계속 처리합니다. 이 경우 분석에 정책 오류가 로깅되지 않습니다.

오류의 정책 이름(ax_execution_fault_policy_name) 측정기준은 정책 이름별로 정책 오류를 그룹화하는 데 유용합니다.

대상 오류(예시: 404 또는 503)는 정책 실패로 간주되지 않습니다. API 프록시 실패(is_error)로 간주됩니다.

API 구문: sum(policy_error)

프록시 오류 is_error 합계

지정된 기간 동안 API 프록시가 실패한 총 횟수입니다. 프록시 실패는 정책이 실패하거나 대상 서비스에서 404 또는 503과 같은 런타임 실패가 발생할 때 발생할 수 있습니다.

프록시(apiproxy) 측정기준은 프록시별로 API 프록시 오류를 그룹화하는 데 유용합니다.

API 구문: sum(is_error)

요청 처리 지연 시간 request_processing_latency avg, min, max

Apigee에서 수신 요청을 처리하는 데 걸리는 밀리초 단위의 (평균, 최소 또는 최대) 시간입니다. 이 시간은 요청이 Apigee에 도달할 때부터 시작되며 Apigee에서 요청을 대상 서비스로 전달하면 종료됩니다.

다른 측정기준을 사용하여 API 프록시, 개발자 앱, 리전 등을 기준으로 요청 처리 지연 시간을 검사할 수 있습니다.

API 구문: max(request_processing_latency)

요청 크기 request_size sum, avg, min, max

Apigee에서 수신한 요청 페이로드 크기(바이트)입니다.

API 구문: avg(request_size)

실행된 응답 캐시 ax_cache_executed 합계

일정 기간 동안 ResponseCache 정책이 실행된 총 횟수입니다.

ResponseCache 정책은 API 프록시의 두 위치(요청에서 한 번, 응답에서 한 번)에 첨부되므로 일반적으로 API 호출에서 두 번 실행됩니다. 캐시 GET과 캐시 PUT은 각각 하나의 실행으로 집계됩니다.

그러나 정책의 <SkipCacheLookup> 요소가 요청에서 참으로 평가하면 응답 캐시 실행은 0이고 정책의 <SkipCachePopulation> 요소가 응답에서 참으로 평가하면 0입니다.

디버그 도구에서 실행된 API 호출의 ResponseCache 아이콘을 클릭하고 responsecache.executed 흐름 변수를 확인한 후 캐시 실행이 있었는지 여부를 확인합니다(값 1).

API 구문: sum(ax_cache_executed)

응답 처리 지연 시간 response_processing_latency avg, min, max

Apigee에서 API 응답을 처리하는 데 걸리는 밀리초 단위의 (평균, 최소 또는 최대) 시간입니다. API 프록시가 대상 서비스 응답을 받으면 시간이 시작되고 Apigee가 응답을 원래 발신자에게 전달하면 시간이 종료됩니다.

다른 측정기준을 사용하여 API 프록시, 리전 등을 기준으로 응답 처리 지연 시간을 검사할 수 있습니다.

API 구문: min(response_processing_latency)

응답 크기 response_size sum, avg, min, max

클라이언트에 반환된 응답 페이로드의 크기(바이트)입니다.

API 구문: max(response_size)

대상 오류 target_error 합계

대상 서비스의 총 5xx 응답 수입니다. Apigee로 인해 발생한 것이 아닌 대상 서비스 오류입니다.

API 구문: sum(target_error)

대상 응답 시간 target_response_time sum, avg, min, max

대상 서버가 호출에 응답할 수 있는 시간(합계, 평균, 최소 또는 최대)(밀리초)입니다. 이 측정항목은 대상 서버의 성능을 나타냅니다. Apigee가 요청을 대상 서비스로 전달하면 시작되고 Apigee에서 응답을 받으면 종료됩니다.

API 호출이 캐시에서 응답을 반환하면(예: ResponseCache 정책 사용) 호출이 대상 서비스에 도달하지 않으며 대상 응답 시간 측정항목이 로깅되지 않습니다.

API 구문: avg(target_response_time)

총 응답 시간 total_response_time sum, avg, min, max

Apigee가 클라이언트에게 응답을 받을 때부터 Apigee가 클라이언트에게 응답을 다시 보낼 때까지 걸리는 밀리초 단위의 (합계, 평균, 최소 또는 최대) 시간입니다. 이 시간에는 네트워크 오버헤드(예를 들어 부하 분산기와 라우터가 작업을 하는 데 걸리는 시간), 요청 처리 지연 시간, 응답 처리 지연 시간, 대상 응답 시간(응답이 캐시 대신 대상 서비스에서 제공되는 경우)이 포함됩니다.

다른 측정기준을 사용하여 API 프록시, 개발자 앱, 리전 등을 기준으로 처리 지연 시간을 검사할 수 있습니다.

API 구문: avg(total_response_time)

트래픽 message_count 합계

특정 기간 동안 Apigee에서 처리한 총 API 호출 수입니다.

측정기준을 사용하여 가장 의미있는 방식으로 트래픽 수를 그룹화합니다.

API 구문: sum(message_count)

수익 창출
수수료 fees sum, avg, min, max

설정 수수료, 반복 수수료, 선불 잔액 충전을 나타내는 금액입니다.

API 구문: sum(fees)

개발자 수익 공유 x_apigee_mintng_dev_share sum, avg, min, max

트랜잭션 수익의 개발자 공유입니다. Apigee는 요금제에서 수익 공유를 사용 설정한 경우에만 개발자의 공유분을 계산합니다.

개발자의 공유분은 다음 수식을 사용하여 계산됩니다.

x_apigee_mintng_dev_share = revShareGrossPrice * (share percentage)

공유 백분율의 값은 요금제에서 가져옵니다.

API 구문: sum(x_apigee_mintng_dev_share)

수익 창출 가격 x_apigee_mintng_price sum, avg, min, max

트랜잭션의 총 수익입니다. 트랜잭션의 수익은 DataCapture 정책에서 캡처된 revShareGrossPrice 수익 창출 변수의 값으로 설정됩니다.

API 구문: sum(x_apigee_mintng_price)

API 가격 배수 x_apigee_mintng_price_multiplier sum, avg, min, max

트랜잭션당 비용을 곱하는 계수(배수)입니다. 트랜잭션당 비용은 요금제의 사용량 기반 요금 가격 책정에 지정됩니다.

API 구문: avg(x_apigee_mintng_price_multiplier)

수익 창출률 x_apigee_mintng_rate sum, avg, min, max

트랜잭션에 청구되는 요율입니다. 트랜잭션에 청구되는 요율은 다음 수식을 사용하여 계산됩니다.

x_apigee_mintng_rate = (consumption-based pricing rate) * perUnitPriceMultiplier value

소비 기반 가격 책정 요율의 값은 요금제에서 가져오고, perUnitPriceMultiplier 값은 변수가 DataCapture 정책으로 캡처된 경우에만 곱해집니다.

API 구문: sum(x_apigee_mintng_rate)

측정기준

측정기준을 사용하여 측정항목을 의미있는 그룹화로 확인할 수 있습니다. 예를 들어 각 개발자 앱 또는 API 프록시에서 총 트래픽 수를 확인할 때 총 트래픽 수가 훨씬 강력해집니다.

다음은 Apigee에서 즉시 사용할 수 있는 측정기준입니다.

측정기준 Apigee API에서 사용할 이름 설명
액세스 토큰 access_token 앱 최종 사용자의 OAuth 액세스 토큰입니다.
API 제품 api_product
  • 호출되는 API 프록시가 포함된 API 제품의 이름입니다. 이 측정기준을 가져오려면 호출을 수행하는 개발자 앱이 API 프록시를 포함하는 하나 이상의 API 제품과 연결되어야 하며 호출되는 프록시가 API 호출로 전송된 API 키 또는 OAuth 토큰을 확인해야 합니다. 키나 토큰은 API 제품과 연결되어 있습니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요.

    위 기준을 충족하지 못하면 (not set) 값이 표시됩니다. 분석 항목 값 '(not set)'의 의미도 참조하세요.

  • 수수료 측정항목의 컨텍스트에서 설정 수수료 또는 반복 수수료를 적용해야 하는 요금제에 따라 API 제품이 됩니다. 선불 잔액 충전의 경우 값이 비어 있습니다.

캐시 키 ax_cache_key

액세스한 ResponseCache 값이 포함된 키입니다. 응답 캐시와 관련된 키 구성 방법에 대한 자세한 내용은 ResponseCache 정책을 참조하세요.

디버그 도구의 캐시에서 읽고 쓰는 ResponseCache 정책을 선택하면 responsecache.cachekey흐름 변수에서 이 값을 확인할 수 있습니다.

캐시 이름 ax_cache_name

ResponseCache 정책에서 사용하는 키-값이 포함된 캐시의 이름으로, orgName__envName__이라는 프리픽스가 붙습니다. 예를 들어 조직이 myorgf이고 환경이 test이며 캐시 이름이 myCache라면 ax_cache_namefoo__test__myCache입니다.

디버그 도구에서 ResponseCache 정책을 선택하면 responsecache.cachename 흐름 변수에서 이 값을 확인할 수 있습니다.

캐시 소스: ax_cache_source

ResponseCache가 검색된 캐시 수준(L1 메모리 내 또는 L2 데이터베이스)입니다. 이 측정기준에서는 응답이 캐시 대신 대상에서 전달되었거나(및 응답 캐시가 대상 응답으로 새로고침됨) 요청의 캐시 키가 잘못된 경우 CACHE_MISS를 표시합니다. 캐시 키는 크기가 2KB로 제한됩니다.

디버그 도구에서 ResponseCache 정책을 선택하면 responsecache.cachesource 흐름 변수에서 이 값을 확인할 수 있습니다.

캐시 수준에 대한 자세한 내용은 캐시 내부를 참조하세요.

클라이언트 ID client_id

요청에 API 키로 전달되거나 OAuth 토큰에 포함된 API 호출을 하는 개발자 앱의 고객 키(API 키)입니다.

이 측정기준을 가져오려면 호출을 수신하는 프록시가 유효한 API 키 또는 OAuth 토큰을 확인하도록 구성해야 합니다. 개발자 앱은 앱이 Apigee에 등록될 때 OAuth 토큰을 생성하는 데 사용할 수 있는 API 키를 가져옵니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요.

위 기준을 충족하지 못하면 (not set) 값이 표시됩니다. 분석 항목 값 '(not set)'의 의미도 참조하세요.

개발자 앱 developer_app

API 호출을 수행하는 Apigee에 등록된 개발자 앱

이 측정기준을 가져오려면 앱이 호출되는 API 프록시를 포함하는 하나 이상의 API 제품과 연결되어야 하며, 프록시는 API 호출과 함께 전송되는 API 키 또는 OAuth 토큰을 확인해야 합니다. 키 또는 토큰은 개발자 앱을 식별합니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요.

위 기준을 충족하지 못하면 (not set) 값이 표시됩니다. 분석 항목 값 '(not set)'의 의미도 참조하세요.

개발자 이메일 developer_email
  • 앱이 API 호출을 수행하거나 AppGroup의 경우 AppGroup ID를 수행하는 Apigee 등록 개발자의 이메일입니다.

    이 측정기준을 가져오려면 개발자 또는 AppGroup은 호출되는 API 프록시를 포함하는 하나 이상의 API 제품과 연결된 앱을 가지고 있어야 하며, 프록시는 API 호출과 함께 전송되는 API 키 또는 OAuth 토큰을 확인해야 합니다. 키 또는 토큰은 개발자 앱을 식별합니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요.

    위 기준을 충족하지 못하면 (not set) 값이 표시됩니다. 분석 항목 값 '(not set)'의 의미도 참조하세요.

  • 수수료 측정항목의 컨텍스트에서 설정 수수료, 반복 수수료, 선불 잔액 충전을 책임지는 개발자입니다.
개발자 ID developer

Apigee에서 생성하는 고유한 개발자 ID로서 org_name@@@unique_id 형식을 사용합니다.

이 측정기준을 가져오려면 개발자는 호출되는 API 프록시를 포함하는 하나 이상의 API 제품과 연결된 앱을 가지고 있어야 하며, 프록시는 API 호출과 함께 전송되는 API 키 또는 OAuth 토큰을 확인해야 합니다. 키 또는 토큰으로 개발자를 식별합니다. 자세한 내용은 전체 분석 데이터 생성 방법을 참조하세요.

위 기준을 충족하지 못하면 (not set) 값이 표시됩니다. 분석 항목 값 '(not set)'의 의미도 참조하세요.

환경 environment API 프록시가 배포되는 Apigee 환경입니다. 예를 들면 test 또는 prod입니다.
오류 시 오류 코드 ax_edge_execution_fault_code

오류의 오류 코드입니다. 예를 들면 다음과 같습니다. messaging.adaptors.http.flow.GatewayTimeout

오류의 흐름 이름 ax_execution_fault
  _flow_name

오류를 일으킨 API 프록시에서 이름이 지정된 흐름입니다. 예를 들면 PreFlow, PostFlow 또는 사용자가 만든 조건부 흐름의 이름입니다.

Apigee API에서 사용할 전체 이름은 줄바꿈 없이 ax_execution_fault_flow_name입니다.

오류가 발생하지 않으면 (not set)가 표시됩니다.

흐름 리소스 flow_resource Apigee 전용입니다. 궁금한 점이 있으면 애널리틱스에서 '리소스 흐름' 측정기준 사용 방법을 참조하세요.
오류의 흐름 상태 ax_execution_fault
  _flow_state

PROXY_REQ_FLOW 또는 TARGET_RESP_FLOW 등 오류가 발생한 API 프록시 흐름 상태의 이름입니다.

Apigee API에서 사용할 전체 이름은 줄바꿈 없이 ax_execution_fault_flow_state입니다.

게이트웨이 흐름 ID gateway_flow_id API 호출이 Apigee를 통해 이동하는 경우 각 호출에는 자체 게이트웨이 흐름 ID가 있습니다. 예시: rrt329ea-12575-114653952-1. 게이트웨이 흐름 ID는 조직, 환경, 타임스탬프와 같은 다른 측정 기준이 모든 호출에서 동일한 높은 TPS가 상황에서 측정항목을 구분하는 데 유용합니다.
조직 organization API 프록시가 배포되는 Apigee 조직입니다.
오류의 정책 이름 ax_execution_fault
  _policy_name

오류를 발생시켜 API 호출이 실패하도록 한 정책의 이름입니다.

Apigee API에서 사용할 전체 이름은 줄바꿈 없이 ax_execution_fault_policy_name입니다.

정책에서 오류가 발생하지만 정책 루트 속성 continueOnErrortrue로 설정된 경우, API 프록시 흐름은 실패 없이 계속 실행되며, 이 측정기준에서 정책 오류가 계산되지 않습니다.

프록시 apiproxy API 프록시의 머신 이름(표시 이름 아님)입니다.
프록시 기본 경로 proxy_basepath

API 프록시 ProxyEndpoint에 구성된 기본 경로입니다. 기본 경로에는 API 프록시 URL의 도메인 및 포트 부분이 포함되지 않습니다. 예를 들어 API 프록시의 기본 URL이 https://apigeedocs-test.apigee.net/releasenotes/이면 기본 경로는 /releasenotes입니다.

이 값은 proxy.basepath 흐름 변수에도 저장됩니다.

프록시 배포 유형 proxy_deployment_type

배포된 프록시의 API 프록시 유형입니다. 프록시 유형을 지정하면 해당 프록시 유형으로 결과가 제한됩니다. 가능한 값은 STANDARD, EXTENSIBLE 또는 설정되지 않았습니다.

프록시 경로 서픽스 proxy_pathsuffix

API 프록시 기본 경로에 추가된 리소스 경로입니다. 예를 들어 API 프록시의 기본 URL이 https://apigeedocs-test.apigee.net/hello/이고 https://apigeedocs-test.apigee.net/hello/json로 호출한 경우 pathsuffix/json입니다.

pathsuffix을 사용하지 않으면 이 값이 비어 있습니다.

이 값은 proxy.pathsuffix 흐름 변수에도 저장됩니다.

프록시 버전 apiproxy_revision API 호출을 처리한 API 프록시의 버전 번호입니다. 그렇다고 해서 API 프록시의 최신 버전을 의미하지는 않습니다. API 프록시에 10개의 버전이 있는 경우 8번째 버전은 현재 배포될 수 있습니다. 또한 프록시 배포에 설명된 대로 버전마다 기본 경로가 서로 다른 한 API에 여러 버전이 배포될 수 있습니다.
확인된 클라이언트 IP ax_resolved_client_ip

발신 클라이언트 IP 주소입니다. ax_resolved_client_ip 측정기준의 값은 ax_true_client_ipx_forwarded_for_ip 측정기준의 값에서 계산됩니다.

Akamai와 같은 라우팅 제품을 사용하여 클라이언트의 실제 IP 주소를 캡처하면 클라이언트 IP가 HTTP 헤더 True-Client-IP의 Apigee에 전달되며 이후 ax_true_client_ip 측정기준을 설정하기 위해 사용됩니다.

ax_resolved_client_ip 측정기준 값은 다음과 같이 계산됩니다.

  1. ax_true_client_ip가 null이 아니고 로컬 IP 주소를 포함하지 않으면 ax_resolved_client_ipax_true_client_ip로 설정합니다.
  2. 또는 ax_resolved_client_ipx_forwarded_for_ip의 첫 번째 비로컬 IP 주소로 설정합니다.
  3. ax_true_client_ipx_forwarded_for_ip에 로컬 IP만 포함된 경우에는 ax_resolved_client_ipx_forwarded_for_ip의 마지막 로컬 IP로 설정합니다.
  4. ax_true_client_ipx_forwarded_for_ip가 모두 null일 때는 ax_resolved_client_ip(not set)으로 설정합니다.
  5. ax_true_client_ip가 로컬 IP이고 x_forwarded_for_ip가 null이면 ax_resolved_client_ip(not set)으로 설정합니다.
응답 상태 코드 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

proxy.client.ip 흐름 변수에 저장된 호출 클라이언트의 IP 주소입니다. Apigee가 최종 외부 TCP 핸드셰이크에서 수신한 IP 주소인 인바운드 호출의 X-Forwarded-For 주소입니다. 호출 클라이언트 또는 부하 분산기일 수 있습니다. X-Forwarded-For 헤더에 여러 IP가 있으면 이는 나열된 마지막 IP입니다.

추천 클라이언트 IP ax_true_client_ip

Akamai와 같은 라우팅 제품을 사용하여 클라이언트의 실제 IP 주소를 캡처하면 클라이언트 IP가 HTTP 헤더 True-Client-IP의 Apigee로 전달됩니다. 이 측정기준은 해당 헤더에서 True-Client-IP를 캡처합니다.

ax_resolved_client_ip 측정기준을 통해 액세스하는 원본 클라이언트 IP 주소를 확인하려면 Apigee는 ax_true_client_ipx_forwarded_for_ip 측정기준을 사용합니다.

요청 경로 request_path

쿼리 매개변수를 제외하고 대상 서비스에 대한 리소스 경로(도메인 제외)입니다.

예를 들어 Apigee 샘플 대상 http://mocktarget.apigee.net에는 인사말을 반환하는 /user를 비롯한 여러 리소스가 포함됩니다. API 프록시가 http://mocktarget.apigee.net/user을 호출하는 방식에 관계없이 request_path는 /user입니다.

요청 URI request_uri

쿼리 매개변수를 포함한 대상 서비스에 대한 리소스 경로(도메인 제외)입니다.

예를 들어 Apigee 샘플 대상 http://mocktarget.apigee.net에는 제공된 이름에 대한 커스텀 인사말을 반환하기 위한 /user?user={name} 리소스와 쿼리 매개변수를 비롯한 여러 리소스가 포함됩니다. API 프록시가 http://mocktarget.apigee.net/user?user=Dude을 호출하는 방식에 관계없이 request_uri는 /user?user=Dude입니다.

요청 동사 request_verb GET, POST, PUT, DELETE와 같은 API 요청의 HTTP 요청 동사입니다.
사용자 에이전트 useragent

API 호출을 수행하는 데 사용되는 사용자 에이전트 또는 소프트웨어 에이전트의 이름입니다. 예:

  • Chrome을 통해 호출을 수행하는 Pixel XL: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36
  • Chrome을 통해 호출을 수행하는 iPad: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1
  • 터미널의 cURL: curl/7.51.0
사용자 에이전트 제품군 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 요청을 처리한 대상 엔드포인트입니다. default).
대상 기본 경로 target_basepath

프록시의 <TargetEndpoint>에 정의된 쿼리 매개변수를 제외한 대상 서비스에 대한 리소스 경로(도메인 제외)입니다.

예를 들어 API 프록시가 다음 대상을 호출한다고 가정해 보겠습니다.

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

이 예시에서 target_basepath는 /user입니다.

대상이 다음과 같은 경우:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

target_basepath가 null이 됩니다.

디버그 도구에서 흐름 다이어그램의 끝에 있는 AX 아이콘을 선택하면 target.basepath 흐름 변수가 target_basepath 측정기준에 매핑됩니다.

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

200, 404, 503 등 대상 서비스에서 API 프록시에 반환하는 HTTP 응답 상태 코드입니다.

null 값은 요청이 대상 서비스에 도달하지 않았다는 의미입니다. ResponseCache 정책에서 응답을 제공하거나 요청 처리에 실패할 경우 이러한 상황이 발생합니다.

이는 응답 상태 코드(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은 http://mocktarget.apigee.net/user?user=Dude입니다.

target.url 흐름 변수로 API 프록시를 처리하는 동안에도 URL을 재정의할 수 있습니다.

프록시 체이닝에서 호출 프록시의 target_url은 null입니다.

X-Forwarded-For IP x_forwarded_for_ip

X-Forwarded-For 헤더의 IP 주소 목록입니다.

ax_resolved_client_ip 측정기준을 통해 액세스하는 원본 클라이언트 IP 주소를 확인하려면 Apigee는 ax_true_client_ipx_forwarded_for_ip 측정기준을 사용합니다.

X-Forwarded-For Proto x_forwarded_proto

클라이언트가 라우터에 연결하는 데 사용한 프로토콜입니다. 유효한 값은 http 또는 https입니다.

시간
요일 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_YorkEurope/Dublin 등 API 호출이 수행된 시간대의 일반적인 이름입니다.
월별 주차 ax_week_of_month 특정 달의 주차 숫자 값입니다. 예를 들어 특정 달의 세 번째 주에 수행된 API 호출의 경우 ax_week_of_month는 3입니다.
위치
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
  • 트랜잭션 수익의 통화는 DataCapture 정책에서 캡처되는 currency 수익 창출 변수의 값으로 설정됩니다. 이 통화는 revShareGrossPrice의 통화와 연결됩니다.
  • 수수료 측정항목의 컨텍스트에서 설정 수수료, 반복 수수료 또는 선불 잔액 충전의 통화입니다.
요금제 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 논리를 사용하여 가능한 여러 필터 표현식을 평가할 수 있습니다. 필터에는 조건 중 하나 이상을 충족하는 데이터가 포함됩니다.