getMetricStatisticList

개요

네이버 클라우드 플랫폼에서는 (서버)인스턴스들의 Metric에 대한 통계 정보를 일정 주기마다 수집하고 있으며, 사용자가 이를 활용할 수 있도록 조회 API를 제공합니다.

요청

요청 파라미터

• instanceNo
  • 통계 정보를 조회할 (서버)인스턴스 번호 리스트를 입력합니다.
• metricName
  • 통계 정보를 조회하려고 하는 항목(Metric)의 이름을 입력합니다.
• 아래의 값들이 입력될 수 있습니다.

CPU사용률(CPUUtilization) | 디스크의 데이터를 저장하는 용량(DiskWriteBytes) | 디스크의 데이터를 읽어들이는 용량(DiskReadBytes) | 초당 전송 비트수 - 수신(NetworkIn) | 초당 전송 비트수 - 송신 (NetworkOut)

• startTime
  • 통계 데이터의 최초 조회 시점을 입력합니다.
  • 아래와 같은 형식으로 입력해야 합니다.

형식 : yyyy-MM-dd'T'HH:mm:ssZ
예제 : 2013-07-25T17:50:00+0900, 2013-07-25T08:50:00Z

• endTime
  • 통계 데이터의 마지막 조회 시점을 입력합니다.
  • 아래와 같은 형식으로 입력해야 합니다.

형식 : yyyy-MM-dd'T'HH:mm:ssZ
예제 : 2013-07-25T17:50:00+0900, 2013-07-25T08:50:00Z

• period
  • 통계 데이터를 추출하기 위한 기초 데이터의 수집 기간을 입력합니다.
  • 아래와 같은 수집 기간을 입력할 수 있습니다.

예시

요청 예시

<getMetricStatisticListResponse>
  <requestId>22cc3369-4fb5-498f-9a8e-2b3e0ac9ab2d</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <metricStatisticList>
    <metricStatistic>
      <instanceNo>1151393</instanceNo>
      <metricDataList>
        <metricData>
          <label>DiskWriteBytes</label>
          <average>1219.4</average>
          <maximum>1352.0</maximum>
          <minimum>1177.0</minimum>
          <sum>6097.0</sum>
          <dataPointList>
            <dataPoint>
              <timestamp>2020-05-20T15:00:00Z</timestamp>
              <average>1352.0</average>
              <unit>Bytes</unit>
            </dataPoint>
            <dataPoint>
              <timestamp>2020-05-20T15:30:00Z</timestamp>
              <average>1177.0</average>
              <unit>Bytes</unit>
            </dataPoint>
            <dataPoint>
              <timestamp>2020-05-20T16:00:00Z</timestamp>
              <average>1192.0</average>
              <unit>Bytes</unit>
            </dataPoint>
            <dataPoint>
              <timestamp>2020-05-20T16:30:00Z</timestamp>
              <average>1179.0</average>
              <unit>Bytes</unit>
            </dataPoint>
            <dataPoint>
              <timestamp>2020-05-20T17:00:00Z</timestamp>
              <average>1197.0</average>
              <unit>Bytes</unit>
            </dataPoint>
          </dataPointList>
        </metricData>
      </metricDataList>
    </metricStatistic>
  </metricStatisticList>
</getMetricStatisticListResponse>