메트릭 모니터링 사용

모니터링 메트릭을 수신하려면 IBM Cloud Monitoring 인스턴스를 설정해야 합니다.

모니터링 메트릭을 수신하려면 다음 단계를 수행하십시오.

1. 메트릭 모니터링 포털로 이동하여 모니터링 인스턴스 만들기를 클릭합니다.

2. IBM Cloud Monitoring 인스턴스의 지역을 선택하십시오.

   기존 VPN 서버가 없는 경우 프로비저닝하려면 VPN 서버 작성을 참조하십시오.

   지역은 기존 VPN 서버의 위치와 일치해야 합니다.

3. 가격 플랜을 선택하십시오. 가격 플랜 세부사항은 선택 창에 설명되어 있습니다. 자신의 요구사항에 가장 잘 맞는 플랜을 선택하십시오.

4. 인스턴스에 대한 고유한 서비스 이름을 제공하십시오. 이름은 원하는 이름일 수 있으며 기능에 영향을 주지 않습니다.

   이름이 동일한 다중 IBM Cloud Monitoring 인스턴스를 제공하지 마십시오.

5. 선택사항으로, 리소스 그룹을 선택하십시오. 리소스 그룹은 계정 리소스를 사용자 정의 가능한 그룹으로 구성합니다. IBM Cloud® Identity and Access Management (IAM) 액세스 제어를 사용하여 관리되는 모든 계정 리소스는 계정 내의 리소스 그룹에 속합니다.

   사전구성된 리소스 그룹이 없거나 이 리소스를 선택적으로 공유할 이유가 없는 경우 기본 선택을 사용하십시오.

   계정에 여러 개의 리소스 그룹이 있는 경우 이 IBM Cloud Monitoring 인스턴스에 대한 액세스 권한이 있는 사용자를 선택할 수 있습니다. 이 선택적 액세스를 사용하여 일부 리소스 그룹이 아닌 다른 리소스 그룹에 메트릭을 사용할 수 있습니다.

6. 플랫폼 메트릭 사용 선택란을 선택하십시오. VPN 서버에서 메트릭을 수신하려면 이 옵션을 선택해야 합니다.

7. 작성을 클릭하십시오. 모니터링 메트릭 홈 페이지로 리턴됩니다.

몇 분 이내에 몇 가지 구성을 사용하여 새 IBM Cloud Monitoring 인스턴스가 표시됩니다. 이를 보기 위해 브라우저를 새로 고쳐야 할 수도 있습니다.

API를 사용한 IBM Cloud Monitoring 관련 작업

또한 메트릭 조회 API를 사용하여 IBM Cloud Monitoring 인스턴스에 대한 작업을 수행할 수도 있습니다. 원시 데이터 점이 필요하거나 IBM Cloud Monitoring 대시보드를 사용하지 않고 명령행 인터페이스에서 메트릭을 이용하려는 경우 API를 사용할 수 있습니다.

IBM Cloud Monitoring 인스턴스를 작성한 후 다음의 두 가지 정보를 수집해야 합니다.

• 모니터 API 토큰
• IBM Cloud Monitoring 인스턴스의 엔드포인트

이 정보를 수집하고 메트릭 조회 API를 사용하여 IBM Cloud Monitoring 인스턴스에 대해 작업하려면 다음 단계를 수행하십시오.

1. 모니터링 홈 페이지에 액세스하십시오.

2. 작업할 인스턴스 이름 옆에 있는 대시보드 열기를 클릭하십시오.

3. IBM Cloud Monitoring 대시보드가 표시되면 사이드바에서 계정 프로파일 아이콘을 선택하고 설정을 선택하십시오. 이제 계정 설정이 표시됩니다.

4. 모니터 API 토큰은 Sysdig Monitor API 토큰 필드에 있는 영숫자 문자열입니다. 복사 단추를 클릭하여 토큰을 클립보드에 복사하십시오.

   이 API 토큰을 공유하지 마십시오. 이 API 토큰이 있는 사용자에게는 메트릭에 대한 전체 액세스 권한이 부여됩니다.

5. IBM Cloud Monitoring 인스턴스의 엔드포인트는 지역별입니다. 예를 들어, IBM Cloud Monitoring 인스턴스가 us-south 에 있는 경우 해당 엔드포인트는 다음과 같습니다.

   https://us-south.monitoring.cloud.ibm.com/api/data/batch
   

   URL의 첫 번째 파트(이 예에서 us-south.monitoring.cloud.ibm.com)는 엔드포인트입니다. 이 URL을 기록해 두십시오.

6. API 토큰과 엔드포인트를 모두 보유한 후에는 POST 요청을 형식화할 수 있습니다. 다음 POST 요청은 수정할 수 있는 모든 매개변수가 포함된 예입니다. 다음은 매개변수입니다.

   • 모니터 API 토큰
   • IBM Cloud Monitoring 인스턴스의 엔드포인트
   • ibm_is_vpn_server_name(메트릭을 보려는 VPN 서버 이름)의 값입니다.

   모든 VPN 서버에 대한 이 메트릭을 보려면 scope 속성 값을 입력하지 마십시오. 예를 들어, "scope" : ""를 사용하십시오.

   • 해당 결과를 보고자 하는 메트릭 유형. 이 예제에서는 ibm_is_vpn_server_health_status를 사용합니다.
   • from 및 to 속성은 epoch 시간 및 마이크로초 단위로 설정하여 스캔 초점을 맞추는 시간 범위를 정의합니다.
   • sampling 및 value 속성은 POST 요청에서 리턴되는 데이터의 단위를 설정합니다.

대량의 데이터가 IBM Cloud Monitoring에 저장되므로 특정 레벨의 세분성을 선택하는 것이 중요합니다. IBM Cloud Monitoring에서는 한 번에 요청당 600개의 데이터 점만 리턴할 수 있습니다. 따라서 sampling 및 value 속성이 중요합니다. 요청에서 이러한 두 라인을 제외하면 대신 해당 기간 중의 집계 합이 리턴됩니다.

from 및 to로 지정된 시간 범위가 크지만(예: 4일) 10초의 sampling 및 value을 정의하는 경우 이는 10초 청크로 분할되는 4일 간의 데이터를 수신한다는 것을 의미합니다. 리턴되는 많은 양의 데이터로 인해 이 샘플은 유용하지 않습니다. 더 큰 청크를 지정하는 것이 좋습니다(예: 10초 대신 1시간).

   curl \
   -H 'Authorization: Bearer <API_TOKEN>’ \
   -H 'Content-Type: application/json' \
   https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
   -d '{
     "requests": [
         {
             "format": {
                 "type": "data"
             },
             "scope": "ibm_is_vpn_server_name = \"test-001\"",
             "metrics": {
                 "k0": "timestamp",
                 "v1": "ibm_is_vpn_server_health_status"
             },
             "time": {
                 "from": 1624849800000000,
                 "to": 1624850400000000,
                 "sampling": 60000000
             },
             "group": {
                 "by": [
                     {
                        "metric": "k0",
                         "value" : 60000000
                     }
                 ],
                 "aggregations": {
                     "v1": "avg"
                 },
                 "groupAggregations": {
                     "v1": "avg"
                 }
             }
         }
     ]
 }'