1.2. 매핑 규칙
API에 대한 요청에 따라 매핑 규칙은 보고할 지표 또는 메서드를 정의합니다. 다음은 매핑 규칙의 예입니다.
이 규칙은 /
로 시작하는 GET
요청이 메트릭 적중
을 1씩 증가함을 의미합니다. 이 규칙은 API에 대한 모든 요청과 일치합니다. 그러나 대부분의 경우 너무 일반적이므로 이 규칙을 변경할 수 있으며 보다 구체적인 규칙이 추가되면 종종 두 번 카운트가 발생합니다.
Echo API에 대한 다음 규칙은 더 구체적인 예를 보여줍니다.
1.2.1. 제품 및 백엔드에서 규칙 매핑
매핑 규칙은 API 제품 및 API 백엔드 수준에서 작동합니다. 이 섹션에서는 각 수준에서 매핑 규칙의 동작에 대해 알아보고 매핑 규칙이 작동하는 방식을 설명하는 예제를 봅니다.
제품 수준에서 매핑 규칙
- 매핑 규칙이 우선합니다. 즉, 제품 매핑 규칙이 평가되는 첫 번째 규칙입니다.
- 매핑 규칙은 리디렉션된 트래픽을 수신하는 백엔드와 관계없이 항상 평가됩니다.
백엔드 수준에서 매핑 규칙
- 백엔드에 매핑 규칙을 추가하면 백엔드가 결합된 모든 제품에 추가됩니다.
- 매핑 규칙은 제품 수준에서 정의된 매핑 규칙 다음에 평가합니다.
- 매핑 규칙은 트래픽이 매핑 규칙이 속하는 동일한 백엔드로 리디렉션되는 경우에만 평가됩니다.
- 제품의 백엔드 경로는 언급된 제품에 번들로 묶인 백엔드의 각 매핑 규칙에 자동으로 앞에 추가됩니다.
제품 및 백엔드를 사용하여 룰 매핑의 예
이 예에서는 백엔드와 제품부터 시작합니다.
Echo API 백엔드:
-
프라이빗 엔드 포인트가 있음:
https://echo-api.3scale.net
- 다음 패턴과 함께 2개의 매핑 규칙이 포함되어 있습니다.
-
프라이빗 엔드 포인트가 있음:
/hello /bye
collectd API 제품:
-
이 공용 엔드 포인트가 있음 :
https://cool.api
-
이 라우팅 경로
/echo
와 함께 Echo API 백엔드를 사용합니다.
-
이 공용 엔드 포인트가 있음 :
- 다음 패턴을 사용한 매핑 규칙은 자동으로 API 제품의 일부입니다.
/echo/hello /echo/bye
-
즉, 공개 URL
https://cool.api/echo/hello로 전송된 요청이 https://echo-api.3scale.net/hello
https://echo-api.3scale.net/hello
로 리디렉션됩니다. -
마찬가지로 https://cool.api/echo/bye로 전송된 요청이
https://echo-api.3scale.net/bye
https://echo-api.3scale.net/bye
로 리디렉션됩니다.
이제 동일한 Echo API 백엔드를 사용하는 Tools For Devs 라는 추가 제품을 고려해 보십시오.
Devs용 툴:
-
공용 엔드 포인트가 있음 :
https://dev-tools.api
-
다음과 같은 라우팅 경로와 함께 Echo API 백엔드를 사용합니다.
/tellmeback
.
-
공용 엔드 포인트가 있음 :
다음 패턴을 사용하여 룰 매핑은 자동으로 Tools For Devs 제품의 일부입니다.
/tellmeback/hello /tellmeback/bye
-
따라서 공개 URL
https://dev-tools.api/tellmeback/hello로 전송된 요청이 https://echo-api.3scale.net/hello
https://echo-api.3scale.net/hello
로 리디렉션됩니다. -
마찬가지로 https://dev-tools.api/tellmeback/bye로 전송된 요청이
https://echo-api.3scale.net/bye
https://echo-api.3scale.net/bye
로 리디렉션됩니다.
-
따라서 공개 URL
/ping
패턴과 함께 매핑 규칙을 Echo API 백엔드에 추가하면 두 제품(API 및 Tools for Devs)이 모두 영향을 받습니다.-
cool API 에는 이러한 패턴이 있는 매핑 규칙이 있습니다.
/echo/ping
-
Devs용 도구 에는 이러한 패턴이 포함된 매핑 규칙이 있습니다.
/tellmeback/ping
-
cool API 에는 이러한 패턴이 있는 매핑 규칙이 있습니다.