MCP Tools Reference: monitoring.googleapis.com

도구: list_timeseries

Google Cloud Monitoring API의 시계열 데이터를 나열합니다.

다음 코드 샘플은 curl를 사용하여 list_timeseries MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://monitoring.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_timeseries",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

ListTimeSeries 요청입니다.

ListTimeSeriesRequest

JSON 표현 
{
  "name": string,
  "filter": string,
  "interval": {
    object (TimeInterval)
  },
  "aggregation": {
    object (Aggregation)
  },
  "secondaryAggregation": {
    object (Aggregation)
  },
  "orderBy": string,
  "view": enum (TimeSeriesView),
  "pageSize": integer,
  "pageToken": string
}
필드
name

string

필수 항목입니다. 요청을 실행할 프로젝트, 조직 또는 폴더입니다. 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]
organizations/[ORGANIZATION_ID]
folders/[FOLDER_ID]
filter

string

필수 항목입니다. 반환되어야 하는 시계열을 지정하는 모니터링 필터입니다. 필터에서는 단일 측정항목 유형을 지정해야 하며 추가적으로 측정항목 라벨 및 기타 정보를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
    metric.labels.instance_name = "my-instance-name"
interval

object (TimeInterval)

필수 항목입니다. 결과를 반환해야 하는 시간 간격입니다. 지정된 간격의 데이터 포인트를 포함하는 시계열만 응답에 포함됩니다.
aggregation

object (Aggregation)

개별 시계열의 데이터 포인트 정렬과 지정된 라벨에서 검색된 시계열을 결합하는 방법을 지정합니다.

기본적으로 (aggregation가 명시적으로 지정되지 않은 경우) 원시 시계열 데이터가 반환됩니다.
secondaryAggregation

object (Aggregation)

aggregation이 적용된 후 두 번째 집계를 적용합니다. aggregation가 지정된 경우에만 지정할 수 있습니다.
orderBy

string

지원되지 않음: 비워 두어야 합니다. 각 시계열의 포인트는 현재 역 시간순 (최근에서 오래된 순)으로 반환됩니다.
view

enum (TimeSeriesView)

필수 항목입니다. 시계열에 관해 반환되는 정보를 지정합니다.
pageSize

integer

반환할 최대 결과 수인 양수입니다. page_size이 비어 있거나 결과가 100,000개를 초과하면 유효한 page_size은 100,000개입니다. view가 FULL로 설정된 경우 반환되는 최대 Points 수입니다. view가 HEADERS로 설정된 경우 반환되는 최대 TimeSeries 수입니다.
pageToken

string

이 필드가 비어 있지 않으면 이 메서드에 대한 이전 호출에서 반환된 nextPageToken 값이 포함되어야 합니다. 이 필드를 사용하면 메서드가 이전 메서드 호출에서 추가 결과를 반환합니다.

TimeInterval

JSON 표현 
{
  "endTime": string,
  "startTime": string
}
필드
endTime

string (Timestamp format)

필수 항목입니다. 시간 간격의 끝입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
startTime

string (Timestamp format)

선택사항입니다. 시간 간격의 시작입니다. 시작 시간의 기본값은 종료 시간입니다. 시작 시간은 종료 시간보다 늦으면 안 됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

집계

JSON 표현 
{
  "alignmentPeriod": string,
  "perSeriesAligner": enum (Aligner),
  "crossSeriesReducer": enum (Reducer),
  "groupByFields": [
    string
  ]
}
필드
alignmentPeriod

string (Duration format)

alignment_period는 모든 time series의 데이터를 일관된 시간 블록으로 나누는 데 사용되는 시간 간격을 초 단위로 지정합니다. 이는 시리즈별 정렬기가 데이터에 적용되기 전에 실행됩니다.

값은 60초 이상이어야 합니다. ALIGN_NONE 이외의 계열별 정렬기가 지정된 경우 이 필드는 필수이며, 그렇지 않으면 오류가 반환됩니다. 시리즈별 정렬기가 지정되지 않았거나 정렬기 ALIGN_NONE가 지정된 경우 이 필드는 무시됩니다.

alignment_period의 최댓값은 차트의 경우 104주 (2년), 알림 정책의 경우 90,000초 (25시간)입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
perSeriesAligner

enum (Aligner)

Aligner는 단일 시계열의 데이터 포인트를 시간적으로 정렬하는 방법을 설명합니다. ALIGN_NONE를 제외한 모든 정렬은 alignment_period의 모든 데이터 포인트를 수학적으로 그룹화하여 기간이 끝날 때 종료 타임스탬프가 있는 각 alignment_period에 대해 단일 데이터 포인트를 생성합니다.

일부 정렬 작업은 일부 시계열에 적용되지 않을 수 있습니다. 유효한 선택은 원래 시계열의 metric_kind 및 value_type에 따라 다릅니다. 정렬은 시계열의 metric_kind 또는 value_type를 변경할 수 있습니다.

교차 시계열 축소를 실행하려면 시계열 데이터를 정렬해야 합니다. cross_series_reducer가 지정된 경우 per_series_aligner이 지정되어야 하고 ALIGN_NONE와 같지 않아야 하며 alignment_period이 지정되어야 합니다. 그렇지 않으면 오류가 반환됩니다.
crossSeriesReducer

enum (Reducer)

시계열을 단일 시계열로 결합하는 데 사용되는 감소 작업입니다. 결과 시계열의 각 데이터 포인트 값은 입력 시계열의 이미 정렬된 모든 값의 함수입니다.

일부 리듀서 작업은 모든 시계열에 적용할 수 없습니다. 유효한 선택사항은 원래 시계열의 metric_kind 및 value_type에 따라 다릅니다. 축소하면 입력 시계열과 다른 metric_kind 또는 value_type가 있는 시계열이 생성될 수 있습니다.

교차 시계열 축소를 수행하려면 먼저 시계열 데이터를 정렬해야 합니다 (per_series_aligner 참고). cross_series_reducer이 지정된 경우 per_series_aligner을 지정해야 하며 ALIGN_NONE이 아니어야 합니다. alignment_period도 지정해야 합니다. 그렇지 않으면 오류가 반환됩니다.
groupByFields[]

string

cross_series_reducer가 지정된 경우 유지할 필드 집합입니다. group_by_fields는 집계 작업을 적용하기 전에 시계열이 하위 집합으로 분할되는 방식을 결정합니다. 각 하위 집합에는 그룹화 필드별로 값이 동일한 시계열이 포함됩니다. 각 개별 시계열은 정확히 하나의 하위 집합에 속합니다. cross_series_reducer는 각 시계열 하위 집합에 적용됩니다. 서로 다른 리소스 유형 간에 줄일 수는 없으므로 이 필드에는 resource.type이 암시적으로 포함됩니다. group_by_fields에 지정되지 않은 필드는 집계됩니다. group_by_fields이 지정되지 않고 모든 시계열의 리소스 유형이 동일하면 시계열이 단일 출력 시계열로 집계됩니다. cross_series_reducer이 정의되지 않으면 이 필드는 무시됩니다.

소요 시간

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

시간 범위의 부호가 있는 초입니다. -315,576,000,000~+315,576,000,000(포함) 사이여야 합니다. 참고: 이 범위는 60초/분 * 60분/시간 * 24시간/일 * 365.25일/년 * 10,000년에서 계산됩니다.
nanos

integer

시간 범위의 나노초 단위로 된 부호가 있는 초수입니다. 1초 미만의 기간은 0 seconds 필드와 양수 또는 음수 nanos 필드로 표현됩니다. 1초 이상의 기간의 경우 nanos 필드의 0이 아닌 값은 seconds 필드와 부호가 같아야 합니다. -999,999,999~+999,999,999(포함) 사이여야 합니다.

정렬기

Aligner는 시계열의 각 정렬 기간에 있는 데이터 포인트에 적용할 작업을 지정합니다. 작업을 적용하지 않음을 지정하는 ALIGN_NONE를 제외하고 각 정렬 작업은 각 정렬 기간의 데이터 값 집합을 데이터 값에 작업을 적용한 결과인 단일 값으로 대체합니다. 정렬된 시계열에는 각 alignment_period 끝에 단일 데이터 값이 있습니다.

정렬 작업은 값의 데이터 유형도 변경할 수 있습니다. 예를 들어 부울 값에 계산 작업을 적용하면 원래 시계열의 데이터 value_type는 BOOLEAN이지만 정렬된 결과의 value_type는 INT64입니다.

열거형
ALIGN_NONE 정렬이 없습니다. 원시 데이터가 반환됩니다. 교차 시리즈 할인이 요청된 경우에는 유효하지 않습니다. 결과의 value_type는 입력의 value_type와 동일합니다.
ALIGN_DELTA

정렬하고 DELTA로 변환합니다. 출력은 delta = y1 - y0입니다.

이 정렬은 CUMULATIVE 및 DELTA 측정항목에 유효합니다. 선택한 정렬 기간에 데이터가 없는 기간이 포함되는 경우 해당 기간의 정렬된 값은 보간을 통해 생성됩니다. 정렬된 결과의 value_type는 입력의 value_type와 동일합니다.
ALIGN_RATE

정렬하고 비율로 변환합니다. 결과는 rate = (y1 - y0)/(t1 - t0), 즉 '시간에 따른 변화'로 계산됩니다. 이 정렬기는 alignment_period의 시작과 끝에 있는 값을 통과하는 선의 기울기를 제공한다고 생각하면 됩니다.

이 정렬기는 숫자 값이 있는 CUMULATIVE 및 DELTA 측정항목에 유효합니다. 선택한 정렬 기간에 데이터가 없는 기간이 포함되는 경우 해당 기간의 정렬된 값은 보간을 통해 생성됩니다. 출력은 value_type DOUBLE인 GAUGE 측정항목입니다.

'비율'이 '변화율'을 의미하는 경우 ALIGN_PERCENT_CHANGE 정렬기를 대신 사용하세요.
ALIGN_INTERPOLATE 정렬 기간 경계 주위의 인접 포인트 사이에 보간하여 정렬합니다. 이 정렬기는 숫자 값이 있는 GAUGE 측정항목에 유효합니다. 정렬된 결과의 value_type는 입력의 value_type와 동일합니다.
ALIGN_NEXT_OLDER 정렬 기간이 끝나기 전의 가장 최근 데이터 포인트를 정렬 기간 끝의 경계로 이동하여 정렬합니다. 이 정렬기는 GAUGE 측정항목에 유효합니다. 정렬된 결과의 value_type는 입력의 value_type와 동일합니다.
ALIGN_MIN 각 정렬 기간의 최솟값을 반환하여 시계열을 정렬합니다. 이 정렬기는 숫자 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 정렬된 결과의 value_type는 입력의 value_type와 동일합니다.
ALIGN_MAX 각 정렬 기간의 최댓값을 반환하여 시계열을 정렬합니다. 이 정렬기는 숫자 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 정렬된 결과의 value_type는 입력의 value_type와 동일합니다.
ALIGN_MEAN 각 정렬 기간의 평균 값을 반환하여 시계열을 정렬합니다. 이 정렬기는 숫자 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 정렬된 결과의 value_type는 DOUBLE입니다.
ALIGN_COUNT 각 정렬 기간의 값 수를 반환하여 시계열을 정렬합니다. 이 정렬기는 숫자 또는 불리언 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 정렬된 결과의 value_type는 INT64입니다.
ALIGN_SUM 각 정렬 기간의 값 합계를 반환하여 시계열을 정렬합니다. 이 정렬기는 숫자 및 분포 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 정렬된 결과의 value_type는 입력의 value_type와 동일합니다.
ALIGN_STDDEV 각 정렬 기간의 값의 표준 편차를 반환하여 시계열을 정렬합니다. 이 정렬기는 숫자 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 출력의 value_type은 DOUBLE입니다.
ALIGN_COUNT_TRUE 각 정렬 기간의 True 값 수를 반환하여 시계열을 정렬합니다. 이 정렬기는 부울 값이 있는 GAUGE 측정항목에 유효합니다. 출력의 value_type은 INT64입니다.
ALIGN_COUNT_FALSE 각 정렬 기간의 False 값 수를 반환하여 시계열을 정렬합니다. 이 정렬기는 부울 값이 있는 GAUGE 측정항목에 유효합니다. 출력의 value_type은 INT64입니다.
ALIGN_FRACTION_TRUE 각 정렬 기간의 전체 값 수에 대한 True 값 수의 비율을 반환하여 시계열을 정렬합니다. 이 정렬기는 부울 값이 있는 GAUGE 측정항목에 유효합니다. 출력 값은 [0.0, 1.0] 범위에 있으며 value_type DOUBLE입니다.
ALIGN_PERCENTILE_99 백분위수 집계를 사용하여 시계열을 정렬합니다. 각 정렬 기간의 결과 데이터 포인트는 해당 기간의 모든 데이터 포인트의 99번째 백분위수입니다. 이 정렬기는 분포 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 출력은 value_type DOUBLE인 GAUGE 측정항목입니다.
ALIGN_PERCENTILE_95 백분위수 집계를 사용하여 시계열을 정렬합니다. 각 정렬 기간의 결과 데이터 포인트는 해당 기간의 모든 데이터 포인트의 95번째 백분위수입니다. 이 정렬기는 분포 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 출력은 value_type DOUBLE인 GAUGE 측정항목입니다.
ALIGN_PERCENTILE_50 백분위수 집계를 사용하여 시계열을 정렬합니다. 각 정렬 기간의 결과 데이터 포인트는 해당 기간의 모든 데이터 포인트의 50번째 백분위수입니다. 이 정렬기는 분포 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 출력은 value_type DOUBLE인 GAUGE 측정항목입니다.
ALIGN_PERCENTILE_05 백분위수 집계를 사용하여 시계열을 정렬합니다. 각 정렬 기간의 결과 데이터 포인트는 해당 기간의 모든 데이터 포인트의 5번째 백분위수입니다. 이 정렬기는 분포 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 출력은 value_type DOUBLE인 GAUGE 측정항목입니다.
ALIGN_PERCENT_CHANGE

정렬하고 변동률로 변환합니다. 이 정렬기는 숫자 값이 있는 GAUGE 및 DELTA 측정항목에 유효합니다. 이 정렬은 alignment_period에 따라 previous 값이 결정되는 ((current - previous)/previous) * 100를 반환합니다.

current과 previous의 값이 모두 0이면 반환되는 값은 0입니다. previous만 0이면 반환되는 값은 무한대입니다.

위의 계산 전에 정렬 기간의 각 지점에서 10분 이동 평균이 계산되어 측정항목을 평활화하고 매우 짧은 급증으로 인한 거짓양성을 방지합니다. 이동 평균은 값이 >= 0인 데이터에만 적용됩니다. < 0 값은 누락된 데이터 포인트로 처리되며 무시됩니다. DELTA 측정항목은 이 정렬에서 허용되지만 측정항목의 값이 항상 양수여야 합니다. 출력은 value_type DOUBLE인 GAUGE 측정항목입니다.

감소기

감소기 작업은 여러 시계열의 데이터 포인트를 단일 시계열로 집계하는 방법을 설명합니다. 여기서 결과 시계열의 각 데이터 포인트 값은 입력 시계열의 이미 정렬된 모든 값의 함수입니다.

열거형
REDUCE_NONE 교차 시계열 감소가 없습니다. Aligner의 출력이 반환됩니다.
REDUCE_MEAN 각 정렬 기간의 시계열에서 평균 값을 계산하여 줄입니다. 이 리듀서는 숫자 또는 분포 값이 있는 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 DOUBLE입니다.
REDUCE_MIN 각 정렬 기간 동안 시계열에서 최솟값을 계산하여 축소합니다. 이 리듀서는 숫자 값이 있는 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 입력의 value_type과 동일합니다.
REDUCE_MAX 각 정렬 기간의 시계열에서 최댓값을 계산하여 축소합니다. 이 리듀서는 숫자 값이 있는 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 입력의 value_type과 동일합니다.
REDUCE_SUM 각 정렬 기간의 시계열에서 합계를 계산하여 줄입니다. 이 리듀서는 숫자 및 분포 값이 있는 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 입력의 value_type과 동일합니다.
REDUCE_STDDEV 각 정렬 기간의 시계열에서 표준 편차를 계산하여 줄입니다. 이 리듀서는 숫자 또는 분포 값이 있는 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 DOUBLE입니다.
REDUCE_COUNT 각 정렬 기간의 시계열에서 데이터 포인트 수를 계산하여 축소합니다. 이 리듀서는 숫자, 불리언, 분포, 문자열 value_type의 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 INT64입니다.
REDUCE_COUNT_TRUE 각 정렬 기간 동안 시계열에서 True 값 데이터 포인트 수를 계산하여 축소합니다. 이 리듀서는 불리언 value_type의 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 INT64입니다.
REDUCE_COUNT_FALSE 각 정렬 기간 동안 시계열에서 False 값 데이터 포인트 수를 계산하여 축소합니다. 이 리듀서는 불리언 value_type의 DELTA 및 GAUGE 측정항목에 유효합니다. 출력의 value_type은 INT64입니다.
REDUCE_FRACTION_TRUE 각 정렬 기간의 전체 데이터 포인트 수에 대한 True 값 데이터 포인트 수의 비율을 계산하여 축소합니다. 이 리듀서는 불리언 value_type의 DELTA 및 GAUGE 측정항목에 유효합니다. 출력 값은 [0.0, 1.0] 범위에 있으며 value_type DOUBLE입니다.
REDUCE_PERCENTILE_99 각 정렬 기간 동안 시계열 전체의 데이터 포인트에서 99번째 백분위수를 계산하여 축소합니다. 이 리듀서는 숫자 및 분포 유형의 GAUGE 및 DELTA 측정항목에 유효합니다. 출력 값은 DOUBLE입니다.
REDUCE_PERCENTILE_95 각 정렬 기간 동안 시계열의 데이터 포인트에서 95번째 백분위수를 계산하여 축소합니다. 이 리듀서는 숫자 및 분포 유형의 GAUGE 및 DELTA 측정항목에 유효합니다. 출력 값은 DOUBLE입니다.
REDUCE_PERCENTILE_50 각 정렬 기간 동안 시계열 전체의 데이터 포인트에서 50번째 백분위수를 계산하여 축소합니다. 이 리듀서는 숫자 및 분포 유형의 GAUGE 및 DELTA 측정항목에 유효합니다. 출력 값은 DOUBLE입니다.
REDUCE_PERCENTILE_05 각 정렬 기간 동안 시계열 전체의 데이터 포인트에서 5번째 백분위수를 계산하여 축소합니다. 이 리듀서는 숫자 및 분포 유형의 GAUGE 및 DELTA 측정항목에 유효합니다. 출력 값은 DOUBLE입니다.

TimeSeriesView

ListTimeSeries*에서 반환되는 필드를 제어합니다.

열거형
FULL 측정항목, 시계열, 시계열 데이터의 ID를 반환합니다.
HEADERS 측정항목 및 시계열 리소스의 ID를 반환하지만 시계열 데이터는 반환하지 않습니다.

출력 스키마

ListTimeSeries 응답입니다.

ListTimeSeriesResponse

JSON 표현 
{
  "timeSeries": [
    {
      object (TimeSeries)
    }
  ],
  "nextPageToken": string,
  "executionErrors": [
    {
      object (Status)
    }
  ],
  "unit": string,
  "unreachable": [
    string
  ]
}
필드
timeSeries[]

object (TimeSeries)

요청에 포함된 필터와 일치하는 하나 이상의 시계열입니다.
nextPageToken

string

반환된 결과보다 더 많은 결과가 있으면 이 필드가 비어 있지 않은 값으로 설정됩니다. 추가 결과를 보려면 이 값을 다음 메서드 호출에서 page_token로 사용하세요.
executionErrors[]

object (Status)

반환된 시계열 데이터가 불완전하게 된 원인일 수 있는 쿼리 실행 오류입니다.
unit

string

모든 time_series 포인트 값이 보고되는 단위입니다. unit는 https://unitsofmeasure.org/ucum.html에 나온 단위의 UCUM 형식을 따릅니다. time_series가 서로 다른 단위를 갖는 경우 (예: 서로 다른 측정항목 유형에서 가져오거나 단위가 없는 경우) unit은 '{not_a_unit}'이 됩니다.
unreachable[]

string

도달할 수 없는 클라우드 리전으로 인해 불완전한 데이터가 반환되었을 수 있습니다.

TimeSeries

JSON 표현 
{
  "metric": {
    object (Metric)
  },
  "resource": {
    object (MonitoredResource)
  },
  "metadata": {
    object (MonitoredResourceMetadata)
  },
  "metricKind": enum (MetricKind),
  "valueType": enum (ValueType),
  "points": [
    {
      object (Point)
    }
  ],
  "unit": string,
  "description": string
}
필드
metric

object (Metric)

연결된 측정항목입니다. 시계열을 식별하는 데 사용되는 완전히 지정된 측정항목입니다.
resource

object (MonitoredResource)

연결된 모니터링 리소스입니다. 커스텀 측정항목은 시계열 데이터에서 특정 모니터링 리소스 유형만 사용할 수 있습니다. 자세한 내용은 커스텀 측정항목 모니터링 리소스를 참조하세요.
metadata

object (MonitoredResourceMetadata)

출력 전용입니다. 연결된 모니터링 리소스 메타데이터입니다. 시계열을 읽을 때 이 필드에는 축소에서 명시적으로 이름이 지정된 메타데이터 라벨이 포함됩니다. 시계열을 만들 때는 이 필드가 무시됩니다.
metricKind

enum (MetricKind)

시계열의 측정항목 종류입니다. 시계열을 나열할 때 해당 시계열이 다른 시계열의 정렬 또는 축소인 경우 이 측정항목 종류는 연결된 측정항목의 측정항목 종류와 다를 수 있습니다.

시계열을 만들 때 이 필드는 선택사항입니다. 있는 경우 연결된 측정항목의 측정항목 종류와 동일해야 합니다. 연결된 측정항목의 설명을 자동으로 만들어야 하는 경우 이 필드는 새 설명의 측정항목 종류를 지정하며 GAUGE(기본값) 또는 CUMULATIVE여야 합니다.
valueType

enum (ValueType)

시계열의 값 유형입니다. 시계열을 나열할 때 해당 시계열이 다른 시계열의 정렬 또는 축소인 경우 이 값 유형은 연결된 측정항목의 값 유형과 다를 수 있습니다.

시계열을 만들 때 이 필드는 선택사항입니다. 있는 경우 points 필드의 데이터 유형과 동일해야 합니다.
points[]

object (Point)

이 시계열의 데이터 포인트입니다. 시계열을 나열할 때 포인트는 역시간순으로 반환됩니다.

시계열을 만들 때 이 필드에는 정확히 하나의 포인트가 포함되어야 하며 포인트의 유형은 연결된 측정항목의 값 유형과 동일해야 합니다. 연결된 측정항목의 설명을 자동으로 만들어야 하는 경우 설명의 값 유형은 포인트의 유형(BOOL, INT64, DOUBLE 또는 DISTRIBUTION 중 하나)에 따라 결정됩니다.
unit

string

측정항목 값이 보고되는 단위입니다. value_type이 INT64, DOUBLE 또는 DISTRIBUTION인 경우에만 적용됩니다. unit은 저장된 측정항목 값의 표현을 정의합니다. 이 필드는 비어 있을 때 CreateTimeSeries를 통해서만 변경할 수 있습니다.
description

string

입력 전용입니다. 측정항목에 대해 google.api.MetricDescriptor와 연결될 시계열에 대한 자세한 설명입니다. 이 필드는 설정된 후 CreateTimeSeries를 통해 변경할 수 없습니다.

측정항목

JSON 표현 
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
필드
type

string

기존 측정항목 유형입니다(google.api.MetricDescriptor 참고). 예를 들면 custom.googleapis.com/invoice/paid/amount입니다.
labels

map (key: string, value: string)

이 측정항목을 고유하게 식별하는 라벨 값의 집합입니다. MetricDescriptor에 나열된 모든 라벨에 값을 할당해야 합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

LabelsEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

MonitoredResource

JSON 표현 
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
필드
type

string

필수 항목. 모니터링 리소스 유형입니다. 이 필드는 MonitoredResourceDescriptor 객체의 type 필드와 일치해야 합니다. 예를 들어 Compute Engine VM 인스턴스 유형은 gce_instance입니다. 유형 목록은 모니터링 리소스 유형 및 로깅 리소스 유형을 참고하세요.
labels

map (key: string, value: string)

필수 항목입니다. 관련 모니터링 리소스 설명자에 나열된 모든 라벨의 값입니다. 예를 들어 Compute Engine VM 인스턴스는 "project_id", "instance_id", "zone" 라벨을 사용합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

LabelsEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

MonitoredResourceMetadata

JSON 표현 
{
  "systemLabels": {
    object
  },
  "userLabels": {
    string: string,
    ...
  }
}
필드
systemLabels

object (Struct format)

출력 전용. 미리 정의된 시스템 메타데이터 라벨의 값입니다. 시스템 라벨은 Google에서 추출한 메타데이터의 종류로, 'machine_image', 'vpc', 'subnet_id', 'security_group', 'name' 등이 있습니다. 시스템 라벨 값에는 문자열, 불리언 값 또는 문자열 목록만 허용됩니다. 예를 들면 다음과 같습니다.

{ "name": "my-test-instance",
  "security_group": ["a", "b", "c"],
  "spot_instance": false }
userLabels

map (key: string, value: string)

출력 전용. 사용자 정의 메타데이터 라벨의 맵입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

구조체

JSON 표현 
{
  "fields": {
    string: value,
    ...
  }
}
필드
fields

map (key: string, value: value (Value format))

동적으로 입력된 값의 순서가 지정되지 않은 맵입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

JSON 표현 
{
  "key": string,
  "value": value
}
필드
key

string
value

value (Value format)

값

JSON 표현 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 값의 종류입니다. kind은 다음 중 하나여야 합니다.
nullValue

null

JSON null를 나타냅니다.
numberValue

number

JSON 숫자를 나타냅니다. JSON에서는 NaN, Infinity, -Infinity가 지원되지 않으므로 이러한 값은 사용할 수 없습니다. 또한 JSON 형식은 일반적으로 숫자 유형에서 큰 Int64 값을 지원하지 않으므로 이를 표현할 수 없습니다.
stringValue

string

JSON 문자열을 나타냅니다.
boolValue

boolean

JSON 불리언 (JSON의 true 또는 false 리터럴)을 나타냅니다.
structValue

object (Struct format)

JSON 객체를 나타냅니다.
listValue

array (ListValue format)

JSON 배열을 나타냅니다.

ListValue

JSON 표현 
{
  "values": [
    value
  ]
}
필드
values[]

value (Value format)

동적으로 입력된 값의 반복 필드입니다.

UserLabelsEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

점

JSON 표현 
{
  "interval": {
    object (TimeInterval)
  },
  "value": {
    object (TypedValue)
  }
}
필드
interval

object (TimeInterval)

데이터 포인트가 적용되는 시간 간격입니다. GAUGE 측정항목의 경우 시작 시간은 선택사항이지만 지정하면 종료 시간과 동일해야 합니다. DELTA 측정항목의 경우 시작 및 종료 시간은 0이 아닌 간격을 지정해야 하고, 이후 포인트는 연속 및 겹치지 않는 간격을 지정해야 합니다. CUMULATIVE 측정항목의 경우 시작 및 종료 시간은 이벤트가 누적 값을 0으로 재설정하고 새 시작 시간을 다음 포인트로 설정할 때까지 0이 아닌 간격을 지정해야 하며, 이후 포인트는 동일한 시작 시간을 지정하고 종료 시간을 늘려야 합니다.
value

object (TypedValue)

데이터 포인트의 값입니다.

TimeInterval

JSON 표현 
{
  "endTime": string,
  "startTime": string
}
필드
endTime

string (Timestamp format)

필수 항목입니다. 시간 간격의 끝입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
startTime

string (Timestamp format)

선택사항입니다. 시간 간격의 시작입니다. 시작 시간의 기본값은 종료 시간입니다. 시작 시간은 종료 시간보다 늦으면 안 됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

TypedValue

JSON 표현 
{

  // Union field value can be only one of the following:
  "boolValue": boolean,
  "int64Value": string,
  "doubleValue": number,
  "stringValue": string,
  "distributionValue": {
    object (Distribution)
  }
  // End of list of possible types for union field value.
}
필드
통합 필드 value. 입력된 값 필드입니다. value은 다음 중 하나여야 합니다.
boolValue

boolean

불리언 값: true 또는 false
int64Value

string (int64 format)

64비트 정수입니다. 범위는 약 ±9.2x1018입니다.
doubleValue

number

64비트 배정밀도 부동 소수점 수입니다. 크기는 약 ±10±300이고 유효 자릿수는 16자리입니다.
stringValue

string

가변 길이 문자열 값입니다.
distributionValue

object (Distribution)

분포 값입니다.

분포

JSON 표현 
{
  "count": string,
  "mean": number,
  "sumOfSquaredDeviation": number,
  "range": {
    object (Range)
  },
  "bucketOptions": {
    object (BucketOptions)
  },
  "bucketCounts": [
    string
  ],
  "exemplars": [
    {
      object (Exemplar)
    }
  ]
}
필드
count

string (int64 format)

모집단의 값 수입니다. Must be non-negative. 히스토그램이 제공된 경우 이 값은 bucket_counts의 값 합계와 같아야 합니다.
mean

number

모집단에 있는 값의 산술 평균입니다. count이 0이면 이 필드는 0이어야 합니다.
sumOfSquaredDeviation

number

모집단에 있는 값의 평균에서 제곱 편차의 합계입니다. 값 x_i의 경우 다음과 같습니다.

Sum[i=1..n]((x_i - mean)^2)

Knuth, 'The Art of Computer Programming', Vol. 2, page 232, 3rd edition에서는 한 번의 패스로 이 합계를 누적하는 Welford의 방법을 설명합니다.

count이 0이면 이 필드는 0이어야 합니다.
range

object (Range)

지정된 경우 모집단 값의 범위를 포함합니다. 개수가 0인 경우 이 필드가 없어야 합니다. 이 필드는 현재 Cloud Monitoring API v3에서 무시됩니다.
bucketOptions

object (BucketOptions)

Cloud Monitoring API v3에서 필요합니다. 히스토그램 버킷 경계를 정의합니다.
bucketCounts[]

string (int64 format)

Cloud Monitoring API v3에서 필요합니다. bucket_options에 지정된 각 버킷의 값입니다. bucketCounts의 값 합계는 Distribution 객체의 개수 필드 값과 같아야 합니다. 버킷 개수의 순서는 세 가지 버킷 유형에 설명된 번호 매기기 체계를 따릅니다. 언더플로 버킷의 번호는 0이고, 유한 버킷(있는 경우)의 번호는 1부터 N-2까지이며, 오버플로 버킷의 번호는 N-1입니다. bucket_counts의 크기는 N보다 클 수 없습니다. 크기가 N보다 작으면 나머지 버킷에 0 값이 할당됩니다.
exemplars[]

object (Exemplar)

value 필드의 오름차순이어야 합니다.

범위

JSON 표현 
{
  "min": number,
  "max": number
}
필드
min

number

모집단 값의 최솟값입니다.
max

number

모집단 값의 최댓값입니다.

BucketOptions

JSON 표현 
{

  // Union field options can be only one of the following:
  "linearBuckets": {
    object (Linear)
  },
  "exponentialBuckets": {
    object (Exponential)
  },
  "explicitBuckets": {
    object (Explicit)
  }
  // End of list of possible types for union field options.
}
필드
통합 필드 options. 이 세 필드 중 하나를 정확히 설정해야 합니다. options은 다음 중 하나여야 합니다.
linearBuckets

object (Linear)

선형 버킷입니다.
exponentialBuckets

object (Exponential)

지수 버킷입니다.
explicitBuckets

object (Explicit)

명시적 버킷입니다.

선형

JSON 표현 
{
  "numFiniteBuckets": integer,
  "width": number,
  "offset": number
}
필드
numFiniteBuckets

integer

0보다 커야 합니다.
width

number

0보다 커야 합니다.
offset

number

첫 번째 버킷의 하한입니다.

지수

JSON 표현 
{
  "numFiniteBuckets": integer,
  "growthFactor": number,
  "scale": number
}
필드
numFiniteBuckets

integer

0보다 커야 합니다.
growthFactor

number

1보다 커야 합니다.
scale

number

0보다 커야 합니다.

명시적

JSON 표현 
{
  "bounds": [
    number
  ]
}
필드
bounds[]

number

값은 단조롭게 증가해야 합니다.

Exemplar

JSON 표현 
{
  "value": number,
  "timestamp": string,
  "attachments": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
필드
value

number

예시 포인트의 값입니다. 이 값은 예시가 속한 버킷을 결정합니다.
timestamp

string (Timestamp format)

위 값의 관측 (샘플링) 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
attachments[]

object

예시 값에 관한 컨텍스트 정보입니다. 예를 들면 다음과 같습니다.

Trace: type.googleapis.com/google.monitoring.v3.SpanContext

리터럴 문자열: type.googleapis.com/google.protobuf.StringValue

집계 중에 삭제된 라벨: type.googleapis.com/google.monitoring.v3.DroppedLabels

단일 예시에는 특정 메시지 유형의 첨부파일이 하나만 있을 수 있으며 이는 시스템에 의해 적용됩니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

모두

JSON 표현 
{
  "typeUrl": string,
  "value": string
}
필드
typeUrl

string

슬래시로 끝나는 접두사와 정규화된 유형 이름으로 구성된 URI 참조를 사용하여 직렬화된 Protobuf 메시지의 유형을 식별합니다.

예: type.googleapis.com/google.protobuf.StringValue

이 문자열에는 / 문자가 하나 이상 포함되어야 하며, 마지막 / 뒤의 콘텐츠는 선행 점이 없는 표준 형식의 유형의 정규화된 이름이어야 합니다. 클라이언트가 연락을 시도하지 않도록 이러한 URI 참조에 스킴을 작성하지 마세요.

접두사는 임의적이며 Protobuf 구현은 유형을 식별하기 위해 마지막 /까지 포함한 모든 것을 삭제해야 합니다. type.googleapis.com/는 일부 기존 구현에 필요한 일반적인 기본 접두사입니다. 이 접두사는 유형의 출처를 나타내지 않으며, 이 접두사가 포함된 URI는 요청에 응답하지 않습니다.

모든 유형 URL 문자열은 참조의 콘텐츠가 영숫자, 퍼센트 인코딩된 이스케이프, 다음 집합의 문자(외부 백틱 제외)로만 구성되어야 한다는 추가 제한사항이 있는 합법적인 URI 참조여야 합니다. /-.~_!$&()*+,;= Google에서는 퍼센트 인코딩을 허용하지만 기존 파서와의 혼동을 방지하기 위해 구현에서 퍼센트 인코딩을 이스케이프 해제해서는 안 됩니다. 예를 들어 type.googleapis.com%2FFoo는 거부되어야 합니다.

Any의 원래 설계에서는 이러한 유형 URL에서 유형 확인 서비스를 실행할 가능성이 고려되었지만 Protobuf는 이를 구현하지 않았으며 이러한 URL에 연결하는 것을 문제이자 잠재적인 보안 문제로 간주합니다. 연락처 유형 URL을 시도하지 마세요.
value

string (bytes format)

type_url로 설명된 유형의 Protobuf 직렬화를 보유합니다.

base64 인코딩 문자열입니다.

상태

JSON 표현 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
필드
code

integer

상태 코드로, google.rpc.Code의 열거형 값이어야 합니다.
message

string

개발자에게 정보를 제공하는 오류 메시지로, 영어로 작성되어야 합니다. 사용자에게 표시되는 모든 오류 메시지는 현지화되어 google.rpc.Status.details 필드에 전송되거나, 클라이언트 측에서 현지화되어야 합니다.
details[]

object

오류 세부정보를 설명하는 메시지 목록입니다. API에서 사용할 일반적인 메시지 유형 집합이 있습니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

NullValue

JSON null를 나타냅니다.

NullValue는 Value 유형 결합의 null 값을 나타내기 위해 값이 하나만 있는 enum을 사용하는 센티널입니다.

0 이외의 값이 있는 NullValue 유형의 필드는 잘못된 것으로 간주됩니다. 대부분의 ProtoJSON 직렬화 프로그램은 정수 값과 관계없이 null_value이 JSON null로 설정된 Value를 내보내므로 0 값으로 왕복합니다.

열거형
NULL_VALUE null 값입니다.

MetricKind

측정 종류입니다. 데이터가 보고되는 방식을 설명합니다. MetricKind에 따라 시작 시간과 종료 시간을 설정하는 방법은 TimeInterval을 참조하세요.

열거형
METRIC_KIND_UNSPECIFIED 이 기본값을 사용하지 마세요.
GAUGE 값을 순간적으로 측정한 결과를 나타냅니다.
DELTA 특정 시간 간격 동안의 값의 변화량을 나타냅니다.
CUMULATIVE 특정 시간 간격 동안 누적된 값입니다. 시계열에서 누적 측정값은 동일한 시작 시간을 유지하고, 종료 시간은 증가해야 합니다. 누적 값이 0으로 재설정되는 이벤트가 발생하면, 그 이후 측정값부터는 새로운 시작 시간을 사용해야 합니다.

ValueType

측정항목의 값 유형입니다.

열거형
VALUE_TYPE_UNSPECIFIED 이 기본값을 사용하지 마세요.
BOOL 값이 불리언입니다. 이 값 유형은 측정항목 종류가 GAUGE인 경우에만 사용할 수 있습니다.
INT64 값이 부호 있는 64비트 정수입니다.
DOUBLE 값이 배정밀도 부동 소수점 수입니다.
STRING 값이 텍스트 문자열입니다. 이 값 유형은 측정항목 종류가 GAUGE인 경우에만 사용할 수 있습니다.
DISTRIBUTION 값이 Distribution입니다.
MONEY 값이 금액입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌