IBM Cloud Metrics Routing 시작하기

IBM Cloud 계정에서 생성된 플랫폼 지표의 라우팅을 구성하려면 IBM Cloud® Metrics Routing 을 사용하세요.

플랫폼 서비스 IBM Cloud Metrics Routing 사용하면 대상과 데이터 포인트가 라우팅되는 위치를 정의하는 경로를 구성하여 계정 수준에서 플랫폼 메트릭을 관리할 수 있습니다. IBM Cloud Metrics Routing 활성화된 서비스를 통해 지원되는 지역 에서 생성된 메트릭을 라우팅할 수 있습니다. IBM Cloud Metrics Routing에 대한 자세한 정보는 IBM Cloud Metrics Routing 정보를 참조하십시오.

IBM Cloud Metrics Routing 아키텍처의 샘플을 보여주는 다이어그램입니다. — IBM Cloud Metrics Routing 아키텍처의 샘플입니다.

전제조건

IBM Cloud CLI를 설치하십시오.
IBM Cloud Metrics Routing CLI를 설치하십시오.
IBM Cloud Metrics Routing 을 관리할 수 있는 권한이 있는 사용자 ID가 있어야 합니다. IAM 역할과 이를 할당하는 방법에 대한 자세한 내용은 IAM을 사용하여 액세스 관리 및 IBM Cloud Metrics Routing 에 대한 액세스 할당을 참조하세요.
IBM Cloud Metrics Routing 구성하여 메트릭을 Monitoring 인스턴스로 라우팅하려면 서비스 간 권한 부여를 구성해야 합니다. IBM Cloud Metrics Routing 에 자격 증명을 제공할 필요가 없습니다.

서비스 간 인증을 구성하는 방법에 대한 자세한 내용은 서비스 간 액세스 권한을 부여하는 권한 관리를 참조하세요.

1단계. 계정 설정 구성

IBM Cloud Metrics Routing 사용하여 계정에서 메트릭을 수집, 라우팅, 관리하는 위치와 방법을 정의하려면 이 계정 설정을 지정합니다.

계정에서 IBM Cloud Metrics Routing 을 구성하는 경우 메타데이터 위치, 구성을 관리할 수 있는 엔드포인트 유형, 대상을 정의할 수 있는 위치, 메트릭 라우팅 방법을 명시적으로 구성하지 않은 지역에서 메트릭을 수집하기 위한 기본 대상 등의 계정 설정을 구성할 수 있습니다. 자세한 내용은 IBM Cloud Metrics Routing 계정 설정 구성을 참조하세요.

계정에서 대상 및 경로를 구성하려면 먼저 모든 IBM Cloud Metrics Routing 리소스 정의가 저장되는 지역을 정의하는 기본 메타데이터 위치를 구성해야 합니다.

다음 명령을 실행하여 기본 메타데이터 위치를 구성합니다:

ibmcloud metrics-router setting update --primary-metadata-region <REGION>

여기서 <REGION> IBM Cloud Metrics Routing 사용할 수 있는 지원 지역으로 설정됩니다. 자세한 정보는 위치를 참조하십시오.

메타데이터 위치를 설정하기 전에 해당 데이터 위치에 적용되는 규정 준수 또는 업계 규정을 확인하세요.

2단계. 1개의 타겟을 구성하세요

대상은 메트릭이 수집되는 위치를 정의합니다. 타겟에 대한 자세한 내용은 계정에서 타겟이 작동하는 방식 이해를 참조하세요.

대상을 구성할 때는 계정의 지역에서 수집된 플랫폼 지표를 전송할 대상을 정의하는 것입니다.

다음 단계를 완료하여 대상을 구성합니다:

메트릭을 라우팅할 대상을 정의합니다.
```
ibmcloud metrics-router target create --name TARGET_NAME --destination-crn DESTINATION_TARGET_CRN [--region REGION]
```
여기서,

--name

대상에 부여할 이름을 정의합니다.

--destination-crn

메트릭을 라우팅할 IBM Cloud Monitoring 인스턴스의 CRN을 정의합니다. IBM Cloud Monitoring 대상만 지원됩니다.

--region

[선택 사항] 대상 정의가 생성되는 지역을 정의합니다. 지원되는 지역 만 지정할 수 있습니다. 특정 지역에 타겟을 만들고 다른 지역에 연결되어 있는 경우 이 옵션을 설정합니다.
대상에서 대상으로 구성한 IBM Cloud Metrics Routing 서비스와 IBM Cloud Monitoring 인스턴스 간의 서비스 간 인증을 정의합니다. 자세한 내용은 서비스 간 액세스 권한을 부여하는 권한 관리를 참조하세요.

3단계. 1개의 경로 구성

경로는 지역에서 라우팅되는 메트릭과 해당 메트릭을 저장할 위치를 나타내는 규칙을 정의합니다. 경로는 계정의 글로벌 경로이며 IBM Cloud Metrics Routing 이 배포된 모든 지역에서 평가됩니다. 자세한 내용은 계정에서 경로가 작동하는 방식 이해를 참조하세요.

이 단계에서는 이전 단계에서 구성한 대상 목적지로 메트릭을 리디렉션하는 경로를 구성합니다.

다음 명령을 실행하여 라우트를 작성하십시오.

ibmcloud metrics-router route create --name ROUTE_NAME  --rules RULES

여기서,

--name ROUTE_NAME: 경로에 부여할 이름을 정의합니다.
--rules RULES: 작은따옴표로 묶은 JSON 형식의 규칙 정의를 정의합니다. 자세히 알아보십시오.

라우트를 구성한 이후, 구성이 사용 가능하려면 최대 1시간 정도가 소요될 수 있습니다.

예를 들어, us-east에서 생성된 메트릭을 이전 단계에서 만든 대상으로 전송하는 경로를 만들려면 다음 명령을 실행합니다.

ibmcloud metrics-router route create --name "my-route" --rules '[{"action": "send", "targets":[{"id":"TARGETID"}], "inclusion_filters":[{"operand": "location","operator": "is","values": "us-east"}]}]''

여기서 TARGETID 은 이전 단계에서 생성한 대상의 ID입니다.

4단계. 메트릭 수집 확인

대상과 경로를 구성한 후에는 메트릭을 사용할 수 있는지 확인해야 합니다.

대상으로 구성한 {{site.data.keyword.mon_short} {{site.data.keyword.mon_short}} IBM Cloud Monitoring UI를 실행하고 메트릭을 살펴보세요.

또는 사전 구축된 오픈 소스 및 엔터프라이즈용 테라폼 IBM 모듈(TIM)을 사용하여 다음을 수행할 수 있습니다. IBM Cloud Monitoring 을 사용하여 대상, 경로 및 계정 설정을 구성할 수 있습니다. 이 모듈은 모범 사례에 따라 타겟과 경로를 간단하게 만들고 관리할 수 있습니다.