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


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

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

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

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

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

19.1. 제품 및 백엔드에 방법 추가

제품 또는 백엔드에 방법을 추가하면 개별 사용 세부 정보를 캡처하려는 API에서 메서드를 지정하고 있습니다. 애플리케이션 계획에서는 제품 또는 백엔드에 추가하는 각 메서드에 대한 제한을 설정하는 기능을 제공합니다. 제품에 방법 또는 지표를 추가하는 절차는 백엔드에 메서드 또는 메트릭을 추가하는 것과 유사합니다.

프로세스

  1. [ your_product_name] > Integration > Methods & Metrics 또는 [ your_backend_name] > Methods & Metrics 로 이동합니다.
  2. 메서드 추가를 클릭합니다.
  3. Friendly name 필드에 메서드에 대한 간단한 설명을 입력합니다. 이 이름은 3scale 관리 포털의 다른 섹션에 표시됩니다. 친숙한 이름은 제품에 대해 고유해야 합니다.

    중요

    메서드의 시스템 이름을 변경하거나 삭제하는 데 주의하십시오. 이러한 변경으로 인해 메서드의 이전 시스템 이름을 가리키는 매핑 규칙이 있는 경우 이미 배포된 3scale 통합이 중단될 수 있습니다.

  4. 시스템 이름 필드에 3scale Service Management API를 통해 사용량을 보고하는 데 사용할 API의 메서드 이름을 입력합니다.

    시스템 이름의 형식을 결정합니다. 이 이름은 끝점(/status)과 유사하거나, 예를 들어 메서드 및 경로(GET_/status)를 포함할 수 있습니다. 그러나 시스템 이름은 다음 규칙을 준수해야 합니다.

    • 제품 또는 백엔드에서 고유합니다.
    • 영숫자, 밑줄 _, 하이픈 - 또는 슬래시 / 만 포함합니다.
    • 공백이 없습니다.
    • 백엔드 API의 경우 시스템 이름 메서드에는 매핑된 백엔드를 식별하는 숫자 문자열이 포함됩니다. 이 백엔드 ID는 수정할 수 없습니다.
  5. 선택 사항: 설명 필드에 메서드에 대한 자세한 설명을 입력합니다.
  6. Create Method 를 클릭합니다.

검증 단계

  • 추가 방법은 애플리케이션 계획에서 사용할 수 있습니다.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat