19장. 방법 지정 및 사용 세부 정보 캡처를 위한 메트릭 추가

애플리케이션 계획은 API에 대한 소비자 액세스를 위한 제한 및 가격 규칙을 설정합니다. 제한 및 규칙을 적용할 수 있도록 하려면 개별 사용 데이터를 수집하거나 메트릭을 추가할 API의 메서드를 지정합니다. 지정된 각 메서드 및 각 사용자 지정 메트릭에 매핑 규칙을 추가합니다. 매핑 규칙은 캡처하려는 사용 데이터에 대한 세부 정보를 지정합니다.

메서드를 지정하거나 제품 및 백엔드에 대한 메트릭을 추가할 수 있습니다. 제품의 경우 이를 통해 제품의 애플리케이션 계획에서 제한 및 가격 규칙을 설정할 수 있습니다. 백엔드의 경우 이를 통해 백엔드와 번들 제품에 대한 애플리케이션 계획에서 제한 및 가격 책정 규칙을 설정할 수 있습니다.

개별 호출 수를 캡처할 방법을 지정합니다. 이를 통해 API 사용을 추적할 수 있는 보다 세밀한 세분성을 제공합니다. 메서드에 트래픽을 보고하면 메서드 및 Hits 지표에 대한 카운터가 자동으로 증가합니다. API 백엔드의 각 끝점 또는 끝점과 HTTP 메서드의 조합을 지정할 수 있습니다. 방법 및 메트릭에 매핑 규칙 추가를 참조하여 API의 끝점을 여기에 추가된 메서드에 매핑하는 방법을 알아봅니다.

메트릭은 제품 및 백엔드 모두에 대해 API 사용을 추적하는 데 적합합니다. hits 는 각 API에 존재하는 기본 제공 메트릭입니다. API에 대한 호출 수를 추적합니다. Hits 와 별도로 API 사용을 캡처하려면 사용량을 다른 단위로 보고하는 지표를 정의합니다. 단위는 수량이어야 하며, 메가바이트, CPU 시간 또는 API에서 반환하는 요소 수와 같은 비즈니스 목표에 대한 의미를 적용해야 합니다. CPU 시간 또는 mb 와 같은 Hits 이외의 메트릭은 기본적으로 제공되지 않습니다. 사용자가 구성한 외부 서비스에서 호출한 엔드포인트를 사용하여 이러한 지표를 가져옵니다.

방법 및 메트릭은 API 패키징을 위한 스캐폴드입니다. 각 애플리케이션 계획을 사용하면 지정된 각 방법과 각 메트릭에 대해 다양한 사용 제한 및 가격 규칙을 정의할 수 있습니다. 지표 및 방법에서 보고한 사용법에 대해 자세히 알아보려면 API 분석을 참조하십시오.