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

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

API 구문: tps

API 요청 대신 응답 캐시를 사용하는 성공한 API 요청의 응답을 전송합니다.

API 구문: sum(cache_hit)

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

API 구문: avg(ax_cache_l1_count)

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

정책 오류는 일반적으로 설계에 따라 발생하는 계획적인 오류입니다. 예를 들어 Verify API 키 정책은 요청에 잘못된 API 키가 전달되었을 때의 오류 및 Spike Arrest 정책 API 호출 수가 정책에 정의된 한도를 초과하면 오류가 발생합니다. 따라서 이 측정항목은 API에서 잠재적인 문제가 있는 부분을 찾을 때 유용합니다. 예를 들어 developer_app 측정기준으로 그룹화된 policy_error 측정항목을 사용하면 특정 앱의 API 키 또는 OAuth 토큰이 만료된 경우 또는 A/B 테스트를 특정 API 프록시에서 많은 Spike Arrest 오류가 발생하므로 프록시의 급증 저지 한도는 연휴 트래픽 증가를 설명하지 않습니다.

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

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

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

API 구문: sum(policy_error)

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

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

API 구문: sum(is_error)

시간(평균, 최소 또는 최대)(밀리초) 수신 요청을 처리하는 데 필요합니다 요청이 Edge로, Edge가 요청을 대상 서비스로 전달하면 종료됩니다.

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

API 구문: max(request_processing_latency)

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

API 구문: avg(request_size)

지정된 기간 동안 응답 캐시 정책이 실행된 총횟수 있습니다.

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

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

Trace 도구에서 실행된 API 호출의 응답 캐시 아이콘을 클릭하고 responsecache.executed 흐름 변수를 확인해 캐시 실행 여부(1의 값)를 확인할 수 있습니다.

API 구문: sum(ax_cache_executed)

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

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

API 구문: min(response_processing_latency)

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

API 구문: max(response_size)

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

API 구문: sum(target_error)

시간 (합계, 평균, 최소 또는 최대) 밀리초여야 합니다. 이 측정항목은 대상 서버의 성능을 나타냅니다. Edge에서 요청을 전달하는 시간이 시작됩니다. 대상 서비스에 전달되며 Edge가 응답을 수신하면 종료됩니다.

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

API 구문: avg(target_response_time)

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

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

API 구문: avg(total_response_time)

지정된 기간 동안 Edge에서 처리한 총 API 호출 수입니다.

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

API 구문: sum(message_count)

호출 중인 API 프록시가 포함된 API 제품의 이름입니다. 이 측정기준을 가져오려면 호출을 수행하는 개발자 앱이 API 프록시를 포함하는 하나 이상의 API 제품과 연결되어야 하며 호출되는 프록시가 API 호출로 전송된 API 키 또는 OAuth 토큰을 확인해야 합니다. 키나 토큰은 API 제품과 연결되어 있습니다. 자세한 내용은 가장 먼저 할 일: 완전한 분석 데이터를 생성하는 방법

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

액세스된 응답 캐시 값이 포함된 키입니다. 자세한 내용은 응답 캐시에 대해 키가 생성되는 방식은 응답 캐시 정책을 참조하세요.

Trace 도구에서 캐시를 읽거나 작성하는 응답 캐시 정책을 선택할 때 responsecache.cachekey 흐름 변수에서 이 값을 확인할 수 있습니다.

응답 캐시 정책에서 사용하는 키/값을 포함한 캐시의 이름으로 orgName__envName__으로 시작합니다. 예를 들어 조직이 'foo'이고 환경은 'test'이며 캐시 이름은 'myCache'인 경우 ax_cache_name은 foo__test__myCache입니다.

Trace 도구에서 응답 캐시 정책을 선택할 때 responsecache.cachename 흐름 변수에서 이 값을 확인할 수 있습니다.

응답 캐시의 캐시 수준('L1' 인메모리 또는 'L2' 데이터베이스) 있습니다. 이 측정기준에는 'CACHE_MISS'도 표시됩니다. 응답이 전송된 시점 캐시 대신 타겟을 사용하고 응답 캐시가 타겟 응답으로 새로고침되었습니다. 또는 요청의 캐시 키가 유효하지 않은 경우. 캐시 키는 크기가 2KB로 제한됩니다.

Trace 도구에서 응답 캐시 정책을 선택할 때 responsecache.cachesource 흐름 변수에서 이 값을 확인할 수 있습니다.

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

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

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

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

API를 호출하는 에지 등록 개발자 앱

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

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

API를 호출한 앱의 에지 등록 개발자의 이메일입니다.

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

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

다음과 같은 형식의 고유한 에지 생성 개발자 ID입니다. org_name@@@org_name로 변경합니다.

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

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

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

오류를 발생시킨 API 프록시에서 이름이 지정된 flow 예를 들어 'PreFlow', 'PostFlow' 또는 생성한 조건부 흐름의 이름입니다.

관리 API에서 사용할 전체 이름은 ax_execution_fault_flow_name 할 수 있습니다.

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

오류를 일으킨 API 프록시 흐름의 이름입니다(예: 'PROXY_REQ_FLOW'). 또는 'TARGET_RESP_FLOW'

관리 API에서 사용할 전체 이름은 ax_execution_fault_flow_state입니다. 할 수 있습니다.

오류가 발생했고 API 호출 실패를 일으킨 정책의 이름입니다.

Management API에서 사용할 전체 이름은 ax_execution_fault_policy_name 할 수 있습니다.

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

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

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

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

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

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

원본 클라이언트 IP 주소를 포함합니다. ax_resolved_client_ip 측정기준의 값은 ax_true_client_ip 및 x_forwarded_for_ip 측정기준의 값에서 계산됩니다.

Akamai와 같은 라우팅 제품을 사용하여 클라이언트의 실제 IP 주소를 캡처하는 경우 클라이언트 IP가 HTTP 헤더 True-Client-IP의 에지로 전달됩니다. ax_true_client_ip 측정기준을 설정하는 데 사용됩니다.

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

1. ax_true_client_ip가 null이 아니고 로컬 IP 주소를 포함하지 않으면 ax_resolved_client_ip를 ax_true_client_ip로 설정합니다.
2. 또는 ax_resolved_client_ip를 x_forwarded_for_ip의 첫 번째 비로컬 IP 주소로 설정합니다.
3. ax_true_client_ip 및 x_forwarded_for_ip 모두에 다음이 포함된 경우 로컬 IP 주소만 사용하고 ax_resolved_client_ip를 x_forwarded_for_ip의 첫 번째 로컬 IP 주소입니다.
4. ax_true_client_ip와 x_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)로 설정합니다.

호출을 수행하는 기기의 운영체제 버전입니다.

이를 OS 제품군(ax_ua_os_family)과 함께 두 번째 '드릴다운' 측정기준으로 사용하면 운영체제의 버전을 확인하는 데 유용합니다.

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

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

원래 클라이언트 IP 주소를 확인하기 위해 ax_resolved_client_ip를 통해 액세스합니다. Edge는 ax_true_client_ip 및 x_forwarded_for_ip 측정기준

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

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

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

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

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

useragent의 버전입니다.

이를 사용자 에이전트 제품군(ax_ua_agent_family)과 함께 두 번째 '드릴다운' 측정기준으로 사용하면 에이전트 제품군의 버전을 가져오는 데 유용합니다.

프록시의 <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이 됩니다.

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

대상 서비스에서 API 프록시에 반환한 HTTP 응답 상태 코드입니다. 예를 들면 다음과 같습니다. 200, 404, 503 등

'null' 값 요청이 대상 서비스에 도달하지 않았다는 의미입니다. 이는 다음과 같은 경우에 발생합니다. 응답 캐시 정책에 의해 응답이 제공되거나 요청에 실패했을 때 가장 적합합니다

이는 응답 상태 코드(response_status_code) 측정기준과는 다릅니다.

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을 재정의할 수 있습니다.

프록시 체이닝과 스크립트를 사용할 때 대상 (Node.js)의 경우 호출 프록시의 target_url이 null입니다.

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

원래 클라이언트 IP 주소를 확인하기 위해 ax_resolved_client_ip를 통해 액세스합니다. Edge는 ax_true_client_ip 및 x_forwarded_for_ip 측정기준

24시간제를 기준으로 API 호출이 수행된 두 자릿수 시간입니다. 예를 들어 API 호출은 오후 10시에서 11시 사이에 이루어지며 ax_hour_of_day는 22입니다.

시간 값은 UTC 기준입니다.