1. 소개

IBM Cloud의 CIS(Cloud Internet Service)에서는 GraphQL을 사용하여 로그 등을 검색할 수 있습니다(GraphQL은 API용 쿼리 언어입니다. 구그하면 더 좋은 정보가 나옵니다) .
이 기사에서는 IBM Cloud docs에 따라 GraphQL을 사용해보고 싶습니다. 또한 CIS에서 GraphQL을 이용하려면 Enterprise Plan이어야 합니다.

2. GraphiQL 도입 및 설정

여기에서 다운로드 가능. 내 환경은 Mac이므로 GraphiQL-0.7.2.dmg를 다운로드하여 두 번 클릭하여 소개했습니다.

GraphQL Endpoint 설정.

endpoint 정보는 https://api.cis.cloud.ibm.com/v1/<crn>/zones/<zoneid>/graphql입니다.

<crn> 및 zoneid(Domain ID)는 다음에서 얻을 수 있습니다.

Edit HTTP Header 누르기

헤더 정보 설정

X-Auth-User-Token의 값은 IAM의 인증 토큰 정보이며 검색 방법은 여기을 참조하십시오.

Content-Type의 값은 application/json

3. 테스트

IBM Cloud docs에 있는 샘플을 이용해 보았다.
도구의 왼쪽에 다음 쿼리를 넣고 실행 버튼을 누르면 오른쪽에 결과가 표시됩니다.

3.1 Case1

Domain ID는 적절하게 조정하십시오.

Query 예제

{
  viewer {
    zones(filter: {zoneTag: "<Domain ID>"}) {
      settings {
        browserInsightsAdaptiveGroups {
          maxDuration
          maxNumberOfFields
          maxPageSize
          enabled
          notOlderThan
        }
      }
    }
  }
}

3.2 Case2

Domain ID 및 날짜는 적절하게 조정하십시오.

Query 예제

{
  viewer {
    zones(filter: {zoneTag: "<Domain ID>"}) {
      httpRequests1hGroups(limit: 5, filter: {datetime_gt: "2020-11-08T00:00:00Z", datetime_lt: "2020-11-10T23:59:59Z"}) {
        sum {
          countryMap {
            bytes
            clientCountryName
          }
        }
        dimensions {
          date
          datetime
        }
      }
      firewallEventsAdaptiveGroups(limit: 10, filter: {datetime_gt: "2020-11-09T00:00:00Z", datetime_lt: "2020-11-10T23:59:59Z"}) {
        count
        dimensions {
          clientCountryName
          clientAsn
          datetimeHour
        }
      }
    }
  }
}