경로에 대하여
IBM Cloud Metrics Routing UI, IBM Cloud Metrics Routing CLI, IBM Cloud Metrics Routing REST API, IBM Cloud Metrics Routing Terraform 공급자를 사용하여 계정의 경로를 관리할 수 있습니다. 경로는 지역에서 라우팅되는 메트릭과 라우팅할 위치를 나타내는 규칙을 정의합니다.
계정에서 라우트가 어떻게 작동되는지 이해
라우트에 대한 다음 정보에 유의하십시오.
-
경로는 계정의 글로벌 경로이며 IBM Cloud® Metrics Routing 이 배포된 모든 지역에서 평가됩니다.
-
IBM Cloud Metrics Routing 사용할 수 있는 지원되는 모든 위치에서 경로를 정의할 수 있습니다. 자세한 정보는 위치를 참조하십시오.
-
경로는 모든 지역 IBM Cloud Metrics Routing API 엔드포인트에서 액세스할 수 있습니다.
-
계정에 대해 최대 30개의 라우트를 정의할 수 있습니다.
-
기본적으로 계정에는 0개의 라우트가 구성되어 있습니다.
-
각 라우트에 대해 최대 10개의 규칙을 구성할 수 있습니다.
-
각 규칙에 대해 최대 8개의 위치를 구성할 수 있습니다.
-
각 규칙에 대해 최대 3개의 대상(
{"targets":[{"id":ID1},{"id":ID2},{"id":ID3}]
)을 구성할 수 있습니다. -
라우트는 독립적으로 처리됩니다. 동일한 메트릭 데이터와 일치하는 규칙이 있는 경로가 여러 개 있는 경우 해당 데이터가 여러 타겟으로 전송됩니다.
-
1개의 경로 정의에 있는 규칙은 순서대로 처리됩니다. 메트릭 데이터와 일치하는 첫 번째 일치 규칙(예:
location
)을 사용하여 해당 데이터를 처리합니다. 메트릭이 처리될 때, 해당 경로 정의 내의 후속 규칙에 의해서는 처리되지 않습니다. 다른 규칙으로 처리되지 않는 모든 메트릭에 대한 기본 규칙을 지정하려면route
에 대한rules
정의에서 규칙("locations" : ["*"]
)을 최종 규칙으로 지정하면 됩니다. -
지표 데이터가 규칙과 일치하지 않고 기본 타겟이 구성되어 있지 않은 경우 지표가 삭제되고 어떤 타겟으로도 라우팅되지 않습니다.
-
경로 정의에서 1개 이상의 규칙을 업데이트하면 기존 규칙 세트가 삭제되고 지정된 구성으로 대체됩니다. 경로를 업데이트할 때는 변경되지 않는 규칙 세트의 모든 기존 규칙을 정의하고, 업데이트해야 하는 규칙에 변경 사항을 추가해야 합니다.
-
경로에 대한 정보는 IBM Cloud 계정에 대해 설정한 기본 위치에 메타데이터로 저장됩니다.
기본 메타데이터 위치를 구성하지 않으면 위치는 계정에서 첫 번째 대상을 정의한 위치로 설정됩니다. 자세한 내용은 계정 설정 구성을 참조하세요.
-
사설 및 공용 엔드포인트를 사용하여 라우트를 관리할 수 있습니다. 사용 가능한
ENDPOINTS
목록에 대한 자세한 정보는 엔드포인트를 참조하십시오.-
다음 형식의 API 엔드포인트를 사용하여 비공개 네트워크에서 경로를 관리할 수 있습니다:
https://private.REGION.metrics-router.cloud.ibm.com
-
다음 형식의 API 엔드포인트를 사용하여 공용 네트워크에서 경로를 관리할 수 있습니다:
https://REGION.metrics-router.cloud.ibm.com
-
계정 설정을 업데이트하여 공용 엔드포인트를 사용 안함으로 설정할 수 있습니다. 자세한 내용은 개인 엔드포인트 적용을 참조하세요.
-
-
경로 이름은 1000자 이내여야 하며 공백, 대시
-
, 점.
, 밑줄_
, 콜론:
이외의 특수 문자를 포함할 수 없습니다.이름에는 개인 식별 정보(PII)가 포함되어서는 안 됩니다.
라우트를 구성한 이후, 구성이 사용 가능하려면 최대 1시간 정도가 소요될 수 있습니다.
IAM 액세스
IAM 권한
다음 표에는 IAM 작업, 해당 범위 및 경로를 관리하는 데 필요한 역할이 나열되어 있습니다.
태스크 | IAM 조치 | IAM 정책 범위 | IAM 역할 |
---|---|---|---|
라우트 작성 | metrics-router.route.create |
계정 | Administrator Editor |
모든 라우트 나열 | metrics-router.route.list |
계정 | Administrator Editor Operator Viewer |
경로 세부 정보 보기 | metrics-router.route.read |
계정 | Administrator Editor Operator Viewer |
경로 수정 | metrics-router.route.update |
계정 | Administrator Editor |
라우트 삭제 | metrics-router.route.delete |
계정 | Administrator Editor |
감사 이벤트
다음 표에는 IAM 작업, 해당 범위 및 경로를 관리하는 데 필요한 역할이 나열되어 있습니다.
태스크 | 활동 추적 감사 이벤트 조치 |
---|---|
라우트 작성 | metrics-router.route.create |
모든 라우트 나열 | metrics-router.route.list |
경로 세부 정보 보기 | metrics-router.route.read |
경로 수정 | metrics-router.route.update |
라우트 삭제 | metrics-router.route.delete |
CLI 전제조건
CLI를 사용하여 경로를 관리하기 전에 다음 단계를 완료하세요:
-
IBM Cloud CLI를 설치하십시오.
UI를 사용하여 경로 관리
IBM Cloud Metrics Routing UI를 사용하여 경로 정의를 관리할 수 있습니다. 자세한 내용은 경로 관리를 참조하세요.
CLI 명령
다음 표에는 라우트를 관리하는 데 실행할 수 있는 조치가 나열되어 있습니다.
조치 | 명령 |
---|---|
라우트 작성 | ibmcloud metrics-router route create |
라우트 업데이트 | ibmcloud metrics-router route update |
라우트 삭제 | ibmcloud metrics-router route rm |
라우트 읽기 | ibmcloud metrics-router route get |
모든 라우트 나열 | ibmcloud metrics-router route ls |
자세한 내용은 IBM Cloud Metrics Routing v3 CLI를 참조하세요.
API 전제조건
API를 사용하여 경로를 관리하기 전에 다음 단계를 완료하세요:
- IAM 액세스 토큰을 가져오십시오. 자세한 정보는 IAM 액세스 토큰 검색을 참조하십시오.
- 라우트를 구성 또는 관리할 지역에서 API 엔드포인트를 식별하십시오. 자세한 정보는 엔드포인트를 참조하십시오.
API 메소드
다음 표에는 라우트를 관리하는 데 실행할 수 있는 조치가 나열되어 있습니다.
조치 | REST API 메소드 | API_URL |
---|---|---|
Create a route |
POST |
<ENDPOINT>/api/v3/routes |
Update a route |
PATCH |
<ENDPOINT>/api/v3/routes/<ROUTE_ID> |
Delete a route |
DELETE |
<ENDPOINT>/api/v3/routes/<ROUTE_ID> |
Get information about a route |
GET |
<ENDPOINT>/api/v3/routes/<ROUTE_ID> |
List all routes |
GET |
<ENDPOINT>/api/v3/routes |
REST API에 대한 자세한 내용은 경로를 참조하세요.
HTTP 응답 코드
IBM Cloud Metrics Routing REST API를 사용하는 경우 표준 HTTP 응답 코드를 가져와서 메소드가 완료되었는지 여부를 표시할 수 있습니다.
- 200 응답은 항상 성공을 나타냅니다.
- 4xx 응답은 실패를 나타냅니다.
- 5xx 응답은 일반적으로 내부 시스템 오류를 나타냅니다.
일부 HTTP 응답 코드는 다음 표를 참조하십시오.
상태 코드 | 상태 | 설명 |
---|---|---|
200 |
OK | 요청이 성공했습니다. |
201 |
OK | 요청이 성공했습니다. 리소스가 작성됩니다. |
204 |
OK | 경로가 성공적으로 삭제되었습니다. |
400 |
잘못된 요청 | 요청이 실패했습니다. 필요한 매개변수가 누락되었을 수 있습니다. |
401 |
권한 없음 | API 요청에 사용되는 IAM 토큰은 올바르지 않거나 만료되었습니다. |
403 |
금지됨 | 충분하지 않은 권한으로 인해 오퍼레이션이 금지되었습니다. |
404 |
찾을 수 없음 | 요청한 리소스가 존재하지 않거나 이미 삭제되었습니다. |
429 |
요청이 너무 많음 | 너무 많은 요청이 너무 빨리 API에 도달합니다. |
500 |
내부 서버 오류 | IBM Cloud Metrics Routing 처리 중에 문제가 발생했습니다. |