IBM Cloud Docs
경로에 대하여

경로에 대하여

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 액세스

IBM Cloud Metrics Routing 구성하려면 올바른 IAM 권한이 있는지 확인하세요.

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를 사용하여 경로를 관리하기 전에 다음 단계를 완료하세요:

  1. IBM Cloud CLI를 설치하십시오.

  2. IBM Cloud Metrics Routing 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를 사용하여 경로를 관리하기 전에 다음 단계를 완료하세요:

  1. IAM 액세스 토큰을 가져오십시오. 자세한 정보는 IAM 액세스 토큰 검색을 참조하십시오.
  2. 라우트를 구성 또는 관리할 지역에서 API 엔드포인트를 식별하십시오. 자세한 정보는 엔드포인트를 참조하십시오.

API 메소드

다음 표에는 라우트를 관리하는 데 실행할 수 있는 조치가 나열되어 있습니다.

IBM Cloud Metrics Routing REST 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 응답 코드는 다음 표를 참조하십시오.

HTTP 응답 코드 목록
상태 코드 상태 설명
200 OK 요청이 성공했습니다.
201 OK 요청이 성공했습니다. 리소스가 작성됩니다.
204 OK 경로가 성공적으로 삭제되었습니다.
400 잘못된 요청 요청이 실패했습니다. 필요한 매개변수가 누락되었을 수 있습니다.
401 권한 없음 API 요청에 사용되는 IAM 토큰은 올바르지 않거나 만료되었습니다.
403 금지됨 충분하지 않은 권한으로 인해 오퍼레이션이 금지되었습니다.
404 찾을 수 없음 요청한 리소스가 존재하지 않거나 이미 삭제되었습니다.
429 요청이 너무 많음 너무 많은 요청이 너무 빨리 API에 도달합니다.
500 내부 서버 오류 IBM Cloud Metrics Routing 처리 중에 문제가 발생했습니다.