타겟에 대하여

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 용 Terraform IBM 모듈(TIM)을 사용하여 계정에서 Monitoring 타겟을 관리할 수 있습니다. 대상은 메트릭을 수집할 수 있는 리소스입니다. 리소스는 메트릭이 생성되는 동일한 IBM Cloud 계정 또는 다른 계정에 위치할 수 있습니다.

계정에서 대상의 작동 방식 파악

대상에 대한 다음의 정보를 참조하십시오.

대상은 계정 내의 지역적 대상이며 모든 지역적 IBM Cloud Metrics Routing API 엔드포인트에서 액세스할 수 있습니다.
IBM Cloud Metrics Routing 사용할 수 있는 지원되는 모든 위치에서 대상을 정의할 수 있습니다. 자세한 정보는 위치를 참조하십시오.
각 계정에서 최대 16개의 대상을 구성할 수 있습니다.
각 IBM Cloud 계정에 대해 최대 두 개의 기본 대상을 구성할 수 있습니다.

기본 대상은 계정에서 생성된 메트릭을 라우팅할 위치를 지정하지 않은 위치에서 메트릭을 수집합니다.
대상에 대한 정보는 IBM Cloud 계정에 대해 설정한 기본 및 백업 위치에 메타데이터로 저장됩니다. 저장되는 정보에는 대상 리소스에 대한 세부정보와 메트릭을 보내기 위한 자격 증명이 포함됩니다.

기본 메타데이터 위치는 대상을 구성하기 전에 설정해야 합니다.

기본 메타데이터 위치를 구성하지 않으면 위치는 계정에서 첫 번째 대상을 정의한 위치로 설정됩니다. 자세한 내용은 계정 설정 구성을 참조하세요.
사설 및 공용 엔드포인트를 사용하여 대상을 관리할 수 있습니다. 사용 가능한 엔드포인트 목록에 대한 자세한 내용은 엔드포인트를 참조하세요.
- 다음 형식의 API 엔드포인트를 사용하여 비공개 네트워크에서 대상을 관리할 수 있습니다: https://private.REGION.metrics-router.cloud.ibm.com
- 다음 형식의 API 엔드포인트를 사용하여 공용 네트워크에서 대상을 관리할 수 있습니다: https://REGION.metrics-router.cloud.ibm.com
- 계정 설정을 업데이트하여 공용 엔드포인트를 사용 안함으로 설정할 수 있습니다. 자세한 내용은 개인 엔드포인트 적용을 참조하세요.
대상 이름은 1000자 이내여야 하며 공백, 대시 -, 점 ., 밑줄 _, 콜론 : 이외의 특수 문자를 포함할 수 없습니다.

이름에는 개인 식별 정보(PII)가 포함되어서는 안 됩니다.

대상 유형

다음 대상 유형 중 하나를 구성할 수 있습니다:

대상 목록
대상	유형	범위	설명
IBM Cloud Monitoring	`sysdig-monitor`	`Account`	이 타겟을 사용하면 주요 운영 지역의 시계열 데이터를 통합할 수 있습니다.

IAM 액세스

대상을 관리하려면 IBM Cloud Metrics Routing 을 구성할 수 있는 올바른 IAM 권한이 있는지 확인하세요.

IBM Cloud Metrics Routing 서비스에서 Monitoring 대상으로 메트릭을 전송하려면 대상이 있는 계정에서 서비스 간 권한 부여를 구성해야 합니다. 자세한 내용은 서비스 간 액세스 권한을 부여하는 권한 관리를 참조하세요.

IAM 권한

다음 표에는 IAM 작업, 해당 범위 및 경로를 관리하는 데 필요한 역할이 나열되어 있습니다.

대상 관리를 위한 IAM 작업 범위 및 역할
태스크	IAM 조치	IAM 정책 범위	IAM 역할
대상 작성	`metrics-router.target.create`	지역	`Administrator` `Editor`
모든 대상 나열	`metrics-router.target.list`	계정	`Administrator` `Editor` `Operator` `Viewer`
대상의 세부 정보 가져오기	`metrics-router.target.read`	지역	`Administrator` `Editor` `Operator` `Viewer`
타겟 수정	`metrics-router.target.update`	지역	`Administrator` `Editor`
대상 삭제	`metrics-router.target.delete`	지역	`Administrator` `Editor`

CLI를 사용할 때 대상을 생성, 읽기, 업데이트 또는 삭제하려면 metrics-router.target.list 역할이 필요합니다.

감사 이벤트

다음 표에는 IAM 작업, 해당 범위 및 경로를 관리하는 데 필요한 역할이 나열되어 있습니다.

활동 추적 감사 이벤트 조치
태스크	활동 추적 감사 이벤트 조치
대상 작성	`metrics-router.target.create`
모든 대상 나열	`metrics-router.target.list`
대상의 세부 정보 가져오기	`metrics-router.target.read`
타겟 수정	`metrics-router.target.update`
대상 삭제	`metrics-router.target.delete`

UI를 사용하여 타겟 관리

IBM Cloud Metrics Routing UI를 사용하여 타겟 정의를 관리할 수 있습니다. 자세한 내용은 대상 관리를 참조하세요.

CLI 전제조건

CLI를 사용하여 대상을 관리하기 전에 다음 단계를 완료하십시오.

IBM Cloud Metrics Routing 구성하려면 올바른 IAM 권한이 있는지 확인하세요.
IBM Cloud CLI를 설치하십시오.
IBM Cloud Metrics Routing CLI를 설치하십시오.

CLI 명령

다음 표에는 대상을 관리하기 위해 실행할 수 있는 조치가 나열되어 있습니다.

타겟 작업
조치	명령
`Create a target`	`ibmcloud metrics-router target create`
`Update a target`	`ibmcloud metrics-router target update`
`Delete a target`	`ibmcloud metrics-router target rm`
`Read a target`	`ibmcloud metrics-router target get`
`List all targets`	`ibmcloud metrics-router target ls`

자세한 내용은 IBM Cloud Metrics Routing v3 CLI를 참조하세요.

API 전제조건

API를 사용하여 대상을 관리하기 전에 다음 단계를 완료하세요:

IBM Cloud Metrics Routing 구성하려면 올바른 IAM 권한이 있는지 확인하세요.
IAM 액세스 토큰을 가져오십시오. 자세한 정보는 IAM 액세스 토큰 검색을 참조하십시오.
대상을 구성하거나 관리할 지역에서 API 엔드포인트를 식별하십시오. 자세한 정보는 엔드포인트를 참조하십시오.

API 메소드

다음 표에는 대상을 관리하기 위해 실행할 수 있는 조치가 나열되어 있습니다.

IBM Cloud Metrics Routing REST API를 사용하여 대상 작업 지정
조치	REST API 메소드	API_URL
`Create a target`	`POST`	`<ENDPOINT>/api/v3/targets`
`Update a target`	`PATCH`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Delete a target`	`DELETE`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Read a target`	`GET`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`List all targets`	`GET`	`<ENDPOINT>/api/v3/targets`

자세한 내용은 IBM Cloud Metrics Routing v3 API를 참조하세요.

HTTP 응답 코드

IBM Cloud Metrics Routing REST API를 사용하는 경우 표준 HTTP 응답 코드를 가져와서 메소드가 완료되었는지 여부를 표시할 수 있습니다.

200 응답은 항상 성공을 나타냅니다.
4xx 응답은 실패를 나타냅니다.
5xx 응답은 일반적으로 내부 시스템 오류를 나타냅니다.

일부 HTTP 응답 코드는 다음 표를 참조하십시오.

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