9장. API 정의 (Methods And Metrics)
API 제품 및 백엔드 수준 모두에서 방법과 메트릭을 추가하여 API를 정의할 수 있습니다. API 제품은 하나 이상의 API 백엔드 번들입니다. 제품 수준, 방법 및 메트릭을 사용하면 제품의 애플리케이션 계획에 대한 제한 및 가격 규칙을 설정할 수 있습니다. 백엔드 수준에서 방법 및 지표를 사용하여 백엔드를 번들하는 모든 제품의 애플리케이션 계획의 제한 및 가격 규칙을 설정할 수 있습니다.
지표 는 제품 및 백엔드 수준에서 API 사용을 추적하는 데 적합합니다. hits는 각 API에 존재하고 API에 수행된 히트를 추적하는 데 사용되는 기본 제공 메트릭입니다. Hits 메트릭에서 메서드 를 정의하여 API 사용량 추적에 대한 세부적인 세분성을 얻을 수 있습니다. 메서드로 트래픽을 보고하면 메서드 및 Hits 메트릭에 대한 카운터가 자동으로 증가합니다. API 백엔드의 각 끝점 또는 끝점과 HTTP 메서드의 조합에 대해 별도의 메서드를 정의할 수 있습니다. API의 엔드포인트를 여기에 정의된 메서드에 매핑하는 방법을 알아보려면 매핑 섹션을 참조하십시오.
적중 횟수와 별도로 API 사용을 측정하려면 새 메트릭 을 정의하고 다른 단위로 사용량을 보고할 수 있습니다. 유닛은 quantifiable이어야 하며 메가바이트, CPU 시간, API에서 반환하는 요소 수 등의 비즈니스 목표에 대한 의미를 적용할 수 있어야 합니다. CPU 시간 또는 mb 와 같은 히트 이외의 모든 메트릭은 기본적으로 3scale에 포함되지 않으며 사용자가 구성한 외부 서비스에서 주기적으로 호출한 끝점을 사용하여 보고해야 합니다.
각 애플리케이션 플랜을 통해 각 방법 및 지표에 대해 다양한 사용 제한 및 가격 규칙을 정의할 수 있습니다. 메트릭 및 메서드에 보고된 사용량에 대한 자세한 내용은 API 분석 섹션을 참조하십시오.
추가 리소스
API 제품 및 백엔드에 대한 자세한 내용은 3scale 시작하기를 참조하십시오.
9.1. 방법 및 메트릭 추가
제품 또는 백엔드에 새 방법을 추가하려면 다음 단계를 따르십시오.
- [Your_product_name] > 통합 > 통합 > 메서드 및 메트릭 또는 [Your_backend_name] > 메서드 및 지표로 이동합니다.
- 메서드 목록 위에 있는 새 메서드 링크를 클릭합니다.
매개변수를 지정합니다.
- 친숙한 이름은 방법에 대한 간단한 설명이며 3scale 관리 포털의 다른 섹션에 표시됩니다. 이 이름은 제품에 대해 고유해야 합니다.
-
시스템 이름은 3scale 서비스 관리 API를 통해 사용을 보고하는 데 사용할 메서드의 이름입니다. 또한 고유해야 하며 영숫자, 밑줄
_, 하이픈-및 공백 없이 슬래시/만 포함해야 합니다. 그 외에는 시스템 이름이 원하는 것을 자유롭게 결정할 수 있으며, 끝점(/status)과 정확히 동일하거나, 예를 들어 메서드와 경로(GET_/status)를 포함할 수 있습니다. 설명 필드는 메서드에 대한 보다 자세한 설명에 사용할 수 있으며 선택 사항입니다.
- 마지막으로 Create Method 를 클릭합니다.
나중에 메서드의 정의를 변경할 수 있습니다. 메서드 이름(열 방법)을 클릭하여 필드를 업데이트하고 Update Method를 클릭합니다.
방법 및 메트릭의 시스템 이름을 변경하거나 삭제할 때 주의하십시오. 이러한 변경 사항은 메서드의 이전 시스템 이름을 가리키는 매핑 규칙이 있는 경우 이미 배포된 3scale 통합을 중단할 수 있습니다.
새 지표를 생성하려면 New 지표 를 클릭하고 필요한 매개변수를 제공합니다. 단위를 지정할 때 분석 차트에서 자동으로 통합되므로 단수형 명사(예: "hit")를 사용합니다.
이러한 새로운 방법과 메트릭은 모든 현재 및 향후 계획에서 사용할 수 있습니다. 이제 [Your_product_name] > Applications > Application Plans > [plan_you_want_to_edit]로 이동하여 각 플랜에서 제한 및 가격 규칙을 편집할 수 있습니다.
