cURL 사용

터미널에서 명령행 도구인 cURL을 사용하여 URL 구문으로 IBM Cloud Monitoring 서비스를 관리할 수 있습니다.

cURL 구문

터미널에서 다음 구문을 사용하여 cURL 명령을 실행하십시오.

curl -X <METHOD> <MONITORING_ENDPOINT>/<API_URL> <-H HEADERS,> [-d DATA]

여기서,

  • <METHOD> 는 수행하려는 REST API 호출의 유형을 나타냅니다.
  • <MONITORING-ENDPOINT> 는 모니터링 인스턴스를 사용할 수 있는 엔드포인트를 나타냅니다. 자세한 정보는 Monitoring 엔드포인트를 참조하십시오. 예를 들어, 미국에서 사용 가능한 인스턴스의 엔드포인트는 https://us-south.monitoring.cloud.ibm.com입니다.
  • <API_URL> API URL에 대한 자세한 내용은 REST API 엔드포인트를 참조하세요.
  • HEADERS는 IBM Cloud Monitoring 서비스에 인증하는 데 필요한 정보와 같은 정보를 추가합니다.
  • DATA를 사용하면 필요한 추가 정보를 전달할 수 있습니다.

IAM 토큰에 대한 헤더

IBM Cloud Monitoring REST API를 사용하여 루틴 태스크를 자동화하고 알림을 모니터하는 경우 IAM 토큰을 사용하여 Monitoring 서비스를 인증하십시오.

cURL 명령에서 IAM 토큰을 사용하여 IBM Cloud Monitoring 서비스에 인증하기 위해 다음 옵션을 추가하십시오.

-H "Authorization: $AUTH_TOKEN"
-H "IBMInstanceID: $GUID"
-H "SysdigTeamID: $TEAM_ID"

여기서,

  • IBMInstanceID는 cURL 명령으로 대상으로 지정할 IBM Cloud Monitoring 인스턴스의 GUID를 표시합니다.

    모니터링 인스턴스의 GUID를 가져오려면 다음 명령을 실행합니다: ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid'

  • Authorization은 IBM Cloud Monitoring 서비스 인스턴스에 인증하는 데 사용되는 IAM 토큰을 표시합니다.

    IAM AUTH_TOKEN 토큰을 가져오려면 다음 명령을 실행하십시오. ibmcloud iam oauth-tokens | awk '{print $4}'

    자세한 정보는 IAM API 토큰 가져오기를 참조하십시오.

  • SysdigTeamID는 팀의 GUID를 나타냅니다.

    GUID를 가져오려면 Monitoring 팀의 ID 가져오기를 참조하십시오.

Monitoring 토큰의 헤더

Monitoring REST API를 사용하여 루틴 태스크를 자동화하고 알림을 모니터하는 경우 IBM Cloud Monitoring API 토큰을 사용하여 Monitoring 서비스를 인증할 수도 있습니다.

cURL 명령에서 다음 명령 옵션을 추가하면 IBM Cloud Monitoring 토큰을 사용하여 Monitoring 서비스를 인증할 수 있습니다.

-H "Authorization: Bearer $SYSDIG_TOKEN"

Monitoring 토큰을 가져오려면 Monitoring API 토큰 가져오기를 참조하십시오.

cURL API 조회 실행

IAM 토큰을 사용하여 cURL API 조회와 authrnticat을 실행하려면 다음 단계를 완료하십시오.

  1. IAM 토큰을 설정하십시오.

    AUTH_TOKEN=$(ibmcloud iam oauth-tokens | awk '{print $4}')

  2. IBM Cloud Monitoring 인스턴스 GUID를 설정하십시오.

    GUID=$(ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid')

  3. cURL API 조회를 실행하십시오.

    curl -X <METHOD> <MONITORING_ENDPOINT>/<API_URL> -H "Authorization: $AUTH_TOKEN" -H "IBMInstanceID: $GUID" -H "content-type: application/json"

예를 들어, 경보 정의와 알림 채널이 JSON 파일을 통해 정의된 경보를 작성하기 위해 다음 명령을 실행할 수 있습니다.

curl -X POST \
  https://us-south.monitoring.cloud.ibm.com/api/alerts \
  -H 'Authorization: Bearer eyJraW...' \
  -H 'IBMInstanceID: fc8ceb8a-...' \
  -H 'Content-Type: application/json' \
  -d @alert.json