커스텀 보고서 만들기 및 관리

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

Apigee Edge 문서 보기

커스텀 보고서를 사용하면 특정 API 측정항목을 상세히 살펴보고, 알아보려는 데이터를 정확하게 확인할 수 있습니다. Apigee에 내장된 측정항목측정기준을 사용하여 커스텀 보고서를 만들 수 있습니다.

커스텀 보고서에는 두 가지 유형이 있습니다.

  • 실시간 보고서(동기 보고서라고도 함): Apigee UI에서 보고서 매개변수를 지정하면 실시간 보고서가 몇 분 내에 Apigee UI에 표시됩니다.
  • 보고서 작업(비동기 보고서라고도 함): 커스텀 보고서 작업의 경우 보고서를 요청한 후 나중에 결과를 가져옵니다.

실시간 보고서와 보고서 작업 비교를 참조하세요.

커스텀 보고서 가용성

Apigee 구독 고객인 경우 Apigee API 분석 및 맞춤 보고서 기능에 대한 액세스 권한이 구독 사용 권한에 포함되어 각 Apigee 환경에 자동으로 사용 설정됩니다.

Pay-as-you-go 고객인 경우 분석에 액세스하고 맞춤 보고서를 생성하려면 Apigee API 분석을 유료 부가기능으로 사용 설정해야 합니다. 중급 또는 포괄적 Apigee 환경에 대해 Apigee API 분석 부가기능을 사용 설정하는 방법에 대한 자세한 내용은 Apigee API 분석 부가기능 관리를 참조하세요.

구독 중인지 또는 사용한 만큼만 지불 Apigee 조직을 사용 중인지 확실하지 않은 경우 Apigee 조직 관리자에게 문의하세요.

커스텀 보고서에 대한 정보

커스텀 보고서를 만들 때 표시할 데이터(측정항목)를 선택하고 데이터를 의미 있는 방식으로(측정기준) 그룹화하고 데이터의 특정한 특성(필터)에 따라 반환되는 데이터를 선택적으로 제한합니다.

커스텀 보고서에 표시되는 차트 유형을 열 또는 선 차트로 설정할 수도 있습니다. 다음 이미지는 API 프록시 측정기준별로 그룹화된 초당 트랜잭션의 차트 예시입니다.

  • 열 - 각 API 프록시는 서로 다른 열로 표시됩니다.

    커스텀 열 차트

  • 선 - 각 API는 서로 다른 선으로 표시됩니다.

    커스텀 선 차트

측정항목 및 측정기준 설정

커스텀 보고서에 대해 선택한 측정항목은 측정하려는 데이터를 지정합니다. 일반적인 측정항목은 다음과 같습니다.
  • 초당 트랜잭션 수
  • 응답 시간
  • 정책 오류

표준 측정항목 및 측정기준 외에도 DataCapture 정책을 사용하여 수집하는 커스텀 데이터에 대한 커스텀 보고서를 만들 수 있습니다. 자세한 내용은 DataCapture 정책을 사용한 커스텀 데이터 수집을 확인하세요.

일부 측정항목을 사용하면 측정항목에 대해 실행할 집계 함수를 설정할 수 있습니다. 예를 들어 응답 시간 측정항목과 함께 다음 집계 함수를 사용할 수 있습니다.

  • avg: 평균 응답 시간을 반환합니다.
  • min: 최소 응답 시간을 반환합니다.
  • max: 최대 응답 시간을 반환합니다.
  • sum: 모든 응답 시간의 합계를 반환합니다.

일부 측정항목은 모든 집계 함수를 지원하지 않습니다. 측정항목 문서에는 측정항목 이름 및 측정항목에서 지원하는 함수(sum, avg, min, max)를 지정하는 테이블이 포함되어 있습니다.

측정기준은 측정항목 데이터를 그룹화하는 방법을 지정합니다. 예를 들어 응답 시간 측정항목을 보여주는 맞춤 보고서를 만들려고 합니다. 측정기준을 사용하여 API 제품, API 프록시 또는 개발자 이메일(AppGroup ID일 수도 있음)로 측정항목 데이터를 그룹화하면 다음 항목을 가져올 수 있습니다.

  • API 제품 당 응답 시간
  • API 프록시 당 응답 시간
  • 개발자 이메일 당 응답 시간

커스텀 보고서의 차트에 측정기준이 표시되는 방식은 차트 유형에 따라 다릅니다.

  • 열: 각 열은 각기 다른 측정기준 값에 해당합니다.
  • 선: 차트의 각 선은 각기 다른 측정기준 값에 해당하며, X축은 시간을 나타냅니다.

필터 설정

필터를 사용하면 반환할 측정항목 데이터에 대한 특정 특성을 설정하여 커스텀 보고서에 표시되는 측정항목 데이터를 제한할 수 있습니다. 예를 들어 특정 값보다 큰 응답 시간 또는 특정 이름의 API 프록시에 대한 측정항목 데이터만 표시하도록 필터를 만들 수 있습니다.

eq, ne, gt, lt 등의 조건부 문법과 연산자를 사용하여 복잡한 필터를 빌드할 수 있습니다.

커스텀 보고서 예시

가장 간단한 커스텀 보고서 유형에서는 단일 측정항목과 단일 측정기준을 지정합니다. 예를 들어 다음 설정을 사용하여 커스텀 보고서를 정의할 수 있습니다.

  • 유형 = 열
  • 측정항목 = 초당 평균 트랜잭션 수
  • 측정기준 = API 프록시

커스텀 보고서에는 API 프록시 측정기준별로 그룹화된 '초당 평균 트랜잭션 수' 측정항목 데이터가 포함된 열 차트가 포함됩니다.

커스텀 보고서 탭

커스텀 보고서에 여러 측정항목을 추가할 수 있습니다. 예를 들어 다음과 같이 2개 측정항목으로 커스텀 보고서를 정의합니다.

  • 유형 = 열
  • 측정항목 = 초당 평균 트랜잭션 수
  • 측정항목 = 정책 오류
  • 측정기준 = API 프록시

커스텀 보고서에는 측정항목마다 별도의 차트가 포함됩니다.

커스텀 보고서 2개 측정항목

커스텀 보고서에 여러 측정기준을 추가할 수 있습니다. 예를 들어 2개의 측정항목과 2개의 측정기준이 포함된 다음과 같은 설정으로 커스텀 보고서를 정의합니다.

  • 유형 = 열
  • 측정항목 = 초당 평균 트랜잭션 수
  • 측정항목 = 정책 오류
  • 측정기준 = API 프록시
  • 측정기준 = 요청 동사

실시간 보고서와 보고서 작업 비교

Apigee 애널리틱스를 사용하면 실시간 보고서 또는 보고서 작업을 실행할 수 있습니다.

  • 실시간 보고서의 경우 보고서를 요청하면 분석 서버가 응답을 제공하는 즉시 표시됩니다. 그러나 보고서가 많은 데이터 양(예: 100GB의 데이터)을 처리해야 할 수 있으므로 타임아웃으로 실시간 보고서가 실패할 수 있습니다.

    실시간 보고서의 최대 기간은 92일입니다. 이보다 큰 기간을 선택하면 보고서가 보고서 작업으로 실행됩니다.

    커스텀 보고서 실행을 참조하세요.

  • 보고서 작업의 경우 보고서를 요청하고 나중에 결과를 가져옵니다. 보고서 작업이 좋은 대안이 될 수 있는 경우는 다음과 같습니다.

    • 여러 시간 간격에 걸친 보고서를 분석하고 만드는 경우
    • 쿼리를 복잡하게 만드는 다양한 그룹화 측정기준과 기타 제약조건으로 데이터를 분석하는 경우
    • 일부 사용자 또는 조직에 대한 데이터 볼륨이 현저히 높아진 때 쿼리를 관리하는 경우

    비동기 커스텀 보고서 API 사용에 설명된 대로 API를 사용하여 보고서 작업을 실행할 수도 있습니다. 보고서 작업 보기를 참조하세요.

커스텀 보고서 페이지 열기

Cloud 콘솔의 Apigee

커스텀 보고서 페이지를 열려면 다음 안내를 따르세요.

  1. Cloud 콘솔에서 Apigee UI를 엽니다.
  2. 애널리틱스 > 커스텀 보고서를 선택합니다.

이렇게 하면 아래와 같이 커스텀 보고서 페이지가 표시됩니다.

커스텀 보고서 대시보드

커스텀 보고서 페이지에는 다음과 같은 탭 두 개가 있습니다.

  • 보고서: 실시간 보고서를 표시합니다.
  • 보고서 작업: 보고서 작업을 표시합니다.

실시간 보고서와 보고서 작업 비교를 참조하세요.

두 탭에는 이미 생성된 보고서 또는 보고서 작업 목록이 표시됩니다. 보고서 또는 보고서 작업을 보려면 보고서 이름을 클릭하세요. 예시는 보고서 실행을 참조하세요.

보고서

보고서 탭에는 각 보고서에 대한 다음 정보가 표시됩니다.

  • 표시 이름: 보고서의 이름
  • 측정기준: 보고서에 포함된 측정기준
  • 측정항목: 보고서에 포함된 측정항목 및 집계 함수 (예: sum)입니다.
  • 최종 수정 시간: 보고서가 실행된 마지막 시간과 날짜

보고서 작업

보고서 작업 탭에는 각 보고서 작업에 대한 다음 정보가 표시됩니다.

  • 보고서 이름: 보고서의 이름
  • 시작 시간 범위(UTC): 보고서 작업의 시작 시간
  • 종료 시간 범위(UTC): 보고서 작업의 종료 시간
  • 상태: 보고서 작업의 상태(실행 중, 완료됨 또는 만료됨).
  • 제출됨: 보고서 작업이 제출된 날짜 및 시간.

커스텀 보고서 페이지를 사용하면 다음을 수행할 수 있습니다.

기본 Apigee

커스텀 보고서 페이지를 열려면 다음 안내를 따르세요.

  1. Apigee UI에 로그인합니다.
  2. 분석 > 커스텀 보고서 > 보고서를 선택합니다.

다음 그림과 같이 커스텀 보고서 페이지에 조직에 대해 만든 모든 커스텀 보고서가 표시됩니다.

커스텀 보고서 대시보드

그림에 강조표시된 것처럼 커스텀 보고서 페이지에서 다음을 수행할 수 있습니다.

  • 모든 커스텀 보고서의 목록 보기
  • 커스텀 보고서를 추가
  • 목록에서 이름을 클릭하여 커스텀 보고서 실행하기. 보고서는 기본적으로 지난 1시간 동안 수집된 데이터를 사용하여 실행되며 데이터는 커스텀 보고서 대시보드에 표시됩니다. 커스텀 보고서 대시보드 살펴보기를 참조하세요.
  • 검색창에 관련 문자열의 전체 또는 일부를 입력하여 커스텀 보고서 목록 검색하기. 표시된 모든 필드는 문자열에 대해 검색됩니다.
  • 커스텀 보고서 삭제하기

커스텀 보고서 대시보드 살펴보기

커스텀 보고서 대시보드는 지정된 측정항목의 열 또는 선 차트를 포함하여 특정 기간에 대한 커스텀 보고서 결과를 표시합니다.

커스텀 보고서 대시보드

커스텀 보고서 대시보드를 사용하여 다음을 수행할 수 있습니다.

  • 선택한 기간의 커스텀 보고서 데이터 보기
  • 커스텀 보고서 데이터를 보려는 환경 선택
  • 특정 측정기준을 선택하여 커스텀 보고서 데이터 필터링. 이 영역은 보고서에 여러 측정기준을 지정하는 경우에만 사용 설정됩니다.
  • 차트 또는 보기 선택

  • 연결된 측정항목의 테이블 행에 있는 커스텀 보고서 분석 아이콘 아이콘을 선택하여 측정항목을 분석합니다. 이상치를 확인하고 이전 기간 또는 다른 측정항목과 비교합니다.
  • 기간을 클릭하고 설정하여 커스텀 보고서를 실행합니다.
  • CSV 파일로 커스텀 보고서를 다운로드합니다. 파일 이름은 metric.csv 형식으로 지정됩니다. 예를 들면 Average_of_total_response_time.csv입니다.
  • 커스텀 보고서를 수정합니다.

커스텀 보고서 만들기

이 섹션에서는 커스텀 보고서를 만드는 방법을 설명합니다.

Cloud 콘솔의 Apigee

커스텀 보고서 페이지에서 실시간 보고서 또는 보고서 작업을 만들 수 있습니다. 방법은 다음과 같습니다.

  1. 커스텀 보고서 페이지를 엽니다.
  2. + 만들기를 클릭합니다.
    • 실시간 보고서를 만들려면 커스텀 보고서를 선택합니다.
    • 보고서 작업을 만들려면 커스텀 보고서 작업을 선택합니다.
  3. 기본 섹션에서 다음 정보를 입력합니다.
    • 보고서 이름: 보고서의 이름입니다.
    • 실시간 보고서의 경우 보고서에 대한 설명(선택사항)을 입력할 수도 있습니다.
  4. 다음 섹션은 보고서 작업의 실시간 보고서를 만드는지 여부에 따라 다릅니다.
    • 실시간 보고서에만 해당:

      차트 유형 이후 데이터를 표시할 차트 스타일을 선택합니다.

      • 열: X축은 측정기준으로 지정된 그룹을 나타냅니다.
      • 선: X축은 시간을 나타냅니다.

    • 보고서 작업에만 해당:
      • 보고서 세부정보: 환경 필드에서 보고서를 실행할 환경을 선택합니다. 실시간 보고서의 경우 보고서를 실행한 후 보고서 페이지에서 환경을 선택할 수 있습니다.
      • 보고서 기간: 보고서의 시작 시간종료 시간을 선택합니다.

        참고: 보고서 작업의 최대 기간은 365일입니다. 초 단위까지의 기간이 필요한 보고서의 경우 Custom Reports API를 사용하여 보고서 작업을 만드세요. API는 초가 포함된 기간 입력을 허용합니다.

  5. 측정항목 섹션에서 다음을 수행합니다.
    1. 분석할 측정항목을 선택합니다.
    2. 집계 함수를 선택하여 합계, 평균, 최솟값, 최댓값을 표시합니다.
    3. 완료를 클릭합니다.

    참고: 표준 측정항목 및 측정기준 외에도 DataCapture 정책으로 수집된 커스텀 데이터에 해당하는 측정항목 또는 측정기준을 선택할 수도 있습니다.

  6. 측정기준 필드에서 '프록시'와 같은 측정기준을 선택하여 보고서를 생성하는 데 사용되는 데이터 세트를 제한합니다. 측정기준을 더 추가하여 데이터를 추가로 제한할 수 있습니다.
  7. 필터 섹션에서 보고서 정의에 필터를 추가하여 표시되는 데이터의 범위를 더 좁힐 수 있습니다. 예를 들어 날씨 API 프록시 또는 개발자인 jane@example.com에 대한 데이터를 제외하는 필터를 추가할 수 있습니다.

    먼저 필터 추가를 클릭하여 새 필터 섹션을 엽니다.

    1. 필터링할 항목의 이름(측정항목 또는 측정기준일 수 있음)을 선택합니다.
    2. 연산자(예: = 또는 !=)와 값을 선택합니다.
    3. 측정항목 또는 측정기준의 값을 입력합니다.
    4. 완료를 클릭하여 필터를 추가합니다.
  8. 저장을 클릭하여 보고서를 저장합니다.

기본 Apigee

커스텀 보고서를 추가하려면 다음 안내를 따르세요.

  1. 커스텀 보고서 페이지를 엽니다.
  2. + 커스텀 보고서를 클릭합니다.
  3. 기본 섹션에서 다음 정보를 입력합니다.
    필드 설명
    보고서 이름 보고서의 이름입니다.
    보고서 설명 보고서에 대한 설명입니다.
    차트 유형 커스텀 분석 데이터를 표시하는 데 사용할 차트 스타일을 선택합니다.
    • 열: X축은 측정기준으로 지정된 그룹을 나타냅니다.
    • 선: X축은 시간을 나타냅니다.
  4. 측정항목 섹션에서 다음을 수행합니다.
    1. 측정항목더하기 아이콘. 아이콘을 클릭합니다.
    2. 분석할 측정항목을 선택합니다.
    3. 집계 함수를 선택하여 합계, 평균, 최솟값, 최댓값을 표시합니다.
    4. 저장을 클릭합니다.
    5. 더하기 아이콘 아이콘을 클릭하여 측정항목을 더 추가합니다.

    참고: 표준 측정항목 및 측정기준 외에도 DataCapture 정책으로 수집된 커스텀 데이터에 해당하는 측정항목 또는 측정기준을 선택할 수도 있습니다.

  5. 측정기준 섹션에서 더하기 아이콘을 클릭하고 '프록시'와 같은 측정기준을 선택하여 보고서를 생성하는 데 사용되는 데이터 세트를 제한합니다. 측정기준을 더 추가하여 데이터를 추가로 제한할 수 있습니다.
  6. 필터 섹션에서 보고서 정의에 필터를 추가하여 표시되는 데이터의 범위를 더욱 좁히세요. 예를 들어 날씨 API 프록시 또는 개발자인 jane@example.com에 대한 데이터를 제외하는 필터를 추가할 수 있습니다.

    1. 더하기 아이콘를 클릭하고 필터링할 항목의 이름, = 또는 !=와 같은 연산자, 값을 선택합니다.
    2. 추가를 클릭하여 필터를 저장합니다.
    3. 더하기 아이콘를 클릭하여 필터를 추가하고 AND 또는 OR 커넥터를 선택합니다.
  7. 저장을 클릭하여 보고서를 저장합니다.

보고서 실행

Cloud 콘솔의 Apigee

실시간 보고서를 실행하려면 다음 안내를 따르세요.

  1. 커스텀 보고서 페이지를 엽니다.
  2. 보고서 탭에서 실행할 보고서를 선택합니다.

보고서가 준비되면 아래와 같이 표시됩니다.

표시된 커스텀 보고서

보고서에는 데이터 차트와 요약 테이블이 표시됩니다.

보고서 페이지에서 다음 보고서 옵션을 선택할 수 있습니다.

  • 환경: 보고서를 실행할 환경입니다.
  • 보고서의 기간입니다.
  • 측정기준: 보고서의 측정기준입니다. 한 번에 하나의 측정기준만 표시될 수 있습니다.
  • : 측정기준의 특정 값 또는 모든 값을 표시하려면 전체를 선택합니다.

보고서 페이지 상단에서 다음 옵션을 선택할 수도 있습니다.

  • 수정: 보고서의 세부정보를 수정합니다.
  • 내보내기: 보고서 데이터를 CSV 파일로 다운로드합니다.
  • 작업 제출: 보고서를 보고서 작업으로 제출합니다. 작업 제출을 클릭하면 커스텀 보고서 만들기에 설명된 옵션을 제공하는 대화상자가 열립니다. 옵션을 입력한 후 만들기를 클릭하여 보고서 작업을 만듭니다.

보고서 작업에 대한 자세한 내용은 보고서 작업 보기를 참조하세요.

기본 Apigee

특정 기간의 커스텀 보고서를 실행하려면 다음 안내를 따르세요.

  1. 커스텀 보고서 페이지에 액세스합니다.
  2. 실행할 보고서를 선택합니다. 기본적으로 보고서에는 이전 1시간 동안의 데이터가 표시됩니다.

    참고: 보고서를 실행하는 데 60초 넘게 소요되면 이 보고서는 자동으로 실시간 보고서로 변환됩니다.

  3. 다른 기간에 대해 보고서를 실행하려면 다음 안내를 따르세요.

    1. 보고서 상단에서 시간 범위를 클릭하여 커스텀 보고서 시간 선택 팝업을 엽니다.
    2. 다음 중 하나를 선택합니다.
      • 지난 1시간, 어제, 지난 7일 등 사전 정의된 시간 범위
      • 시작/종료 날짜 및 시간을 선택하여 커스텀 기간을 선택하거나 캘린더를 사용하여 시작일 및 종료일을 선택합니다. UTC(세계 협정시)를 사용하려면 UTC를 클릭합니다.

    3. 보고서를 실행하려면 다음 중 하나를 선택하세요.
      • 적용: 보고서를 실행합니다. 보고서가 완료되면 결과가 커스텀 보고서 대시보드에 표시됩니다.

      • 작업 제출: 보고서를 보고서 작업으로 실행합니다. 다음 대화상자가 표시됩니다.

        비동기식 제출

        대화상자에서 상태 보기를 클릭하여 보고서 작업의 상태를 확인합니다.

보고서 작업 보기

Cloud 콘솔의 Apigee

보고서 작업을 보려면 커스텀 보고서 페이지 상단에서 보고서 작업 탭을 선택합니다.

아래와 같이 보고서 작업 탭이 표시됩니다.

보고서 작업

보고서 작업 페이지에서는 다음을 사용 설정할 수 있습니다.

  • 지난 7일 동안 제출된 모든 보고서 작업을 열람합니다.

  • 보고서 작업을 표시할 환경을 선택합니다.

  • 검색창에 관련 문자열의 전체 또는 일부를 입력하여 커스텀 보고서 목록을 검색합니다. 표시된 모든 필드는 문자열에 대해 검색됩니다.

커스텀 보고서를 보려면 상태를 완료해야 합니다. 그런 다음 보고서 이름을 클릭하여 보고서를 봅니다.

기본 Apigee

보고서 작업을 보려면 다음 중 하나를 선택합니다.

  • 백그라운드 작업으로 제출된 보고서 대화상자에서 상태 보기를 클릭합니다.
  • 왼쪽 탐색 메뉴에서 분석 > 커스텀 보고서 > 보고서 작업을 선택합니다.

다음 그림에 표시된 대로 보고서 작업 페이지가 표시됩니다.

보고서 작업

보고서 작업 페이지에서는 다음을 사용 설정할 수 있습니다.

  • 지난 7일 동안 제출된 모든 보고서 작업 결과를 봅니다.

  • 보고서 작업을 표시할 환경을 선택합니다.

  • 커스텀 보고서를 보려면 상태를 완료해야 합니다. 그런 다음 보고서에 해당하는 행으로 마우스를 이동합니다. 보고서 보기보고서 다운로드 아이콘이 나타납니다. 보고서를 보려면 보고서 보기을 선택합니다.

  • 커스텀 보고서를 다운로드합니다.

커스텀 보고서 수정하기

Cloud 콘솔의 Apigee

커스텀 보고서를 수정하려면 다음 안내를 따르세요.

  1. 커스텀 보고서 페이지를 엽니다.
  2. 작업 아래에 있는 점 3개로 된 메뉴를 클릭합니다.
  3. 수정을 선택합니다. 그러면 보고서 옵션을 수정할 수 있는 커스텀 보고서 수정 대화상자가 열립니다. 옵션은 커스텀 보고서 만들기에 설명되어 있습니다.
  4. Update(업데이트)를 클릭하여 변경사항을 저장합니다.

기본 Apigee

커스텀 보고서를 수정하려면 다음 안내를 따르세요.

  1. 커스텀 보고서 페이지를 엽니다.
  2. 수정하려는 보고서 이름 위로 마우스를 가져갑니다. 수정 수정 아이콘 및 삭제 아이콘 삭제 아이콘은 페이지 오른쪽에 나타납니다.
  3. 수정 아이콘을 클릭합니다.
  4. 커스텀 보고서 세부정보를 수정합니다.
  5. 저장을 클릭합니다.

커스텀 보고서 결과로 돌아갑니다.

커스텀 보고서 삭제

Cloud 콘솔의 Apigee

  1. 커스텀 보고서 페이지를 엽니다.
  2. 작업 아래에 있는 점 3개로 된 메뉴를 클릭합니다.
  3. 삭제를 클릭하여 보고서를 삭제합니다.

기본 Apigee

커스텀 보고서를 삭제하려면 다음 안내를 따르세요.

  1. 커스텀 보고서 페이지를 엽니다.
  2. 수정하려는 보고서 이름 위로 마우스를 가져갑니다. 수정 수정 아이콘 및 삭제 아이콘 삭제 아이콘은 페이지 오른쪽에 나타납니다.
  3. 보고서를 삭제하려면 삭제 아이콘을 클릭하세요.