MCP Tools Reference: monitoring.googleapis.com

도구: list_dashboards

Google Cloud 프로젝트에서 기존 맞춤 모니터링 대시보드의 목록을 가져오는 기본 도구로 사용합니다. 사용자는 맞춤 모니터링 대시보드를 사용하여 동일한 컨텍스트에서 여러 소스의 데이터를 보고 분석할 수 있습니다. 이는 특정 프로젝트에서 현재 구성되어 사용 가능한 맞춤 대시보드를 파악하는 데 유용합니다.

다음 코드 샘플은 curl를 사용하여 list_dashboards 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_dashboards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

ListDashboards 요청입니다.

ListDashboardsRequest

JSON 표현 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
필드
parent

string

필수 항목입니다. 목록에 표시할 대시보드의 범위입니다. 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]
pageSize

integer

반환할 최대 결과 수인 양수입니다. 지정하지 않으면 기본값 1000이 사용됩니다.
pageToken

string

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

출력 스키마

ListDashboards 요청입니다.

ListDashboardsResponse

JSON 표현 
{
  "dashboards": [
    {
      object (Dashboard)
    }
  ],
  "nextPageToken": string
}
필드
dashboards[]

object (Dashboard)

요청된 대시보드 목록입니다.
nextPageToken

string

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

대시보드

JSON 표현 
{
  "name": string,
  "displayName": string,
  "etag": string,
  "dashboardFilters": [
    {
      object (DashboardFilter)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    object (DashboardAnnotations)
  },

  // Union field layout can be only one of the following:
  "gridLayout": {
    object (GridLayout)
  },
  "mosaicLayout": {
    object (MosaicLayout)
  },
  "rowLayout": {
    object (RowLayout)
  },
  "columnLayout": {
    object (ColumnLayout)
  }
  // End of list of possible types for union field layout.
}
필드
name

string

식별자. 대시보드의 리소스 이름입니다.
displayName

string

필수 항목입니다. 변경 가능한 사람이 읽을 수 있는 이름입니다.
etag

string

etag는 동시에 발생한 여러 정책 업데이트가 서로를 덮어쓰지 않도록 방지하는 낙관적 동시 실행 제어에 사용됩니다. etag는 GetDashboard에 대한 응답으로 반환되며, 사용자는 변경사항이 동일한 버전의 대시보드 구성에 적용되도록 UpdateDashboard 요청에 해당 etag를 넣어야 합니다. 대시보드 생성 중에는 필드를 전달하면 안 됩니다.
dashboardFilters[]

object (DashboardFilter)

필터 기준에 따라 차트에 표시되는 데이터 양을 줄이는 필터입니다.
labels

map (key: string, value: string)

대시보드에 적용된 라벨

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

object (DashboardAnnotations)

이 대시보드에 표시할 이벤트 주석의 구성입니다.
통합 필드 layout. 레이아웃 스타일을 정의하는 대시보드의 루트 컨테이너 요소입니다. layout은 다음 중 하나여야 합니다.
gridLayout

object (GridLayout)

콘텐츠는 위젯이나 카드와 같은 정보 요소의 간단한 목록을 리플로우하는 기본 레이아웃으로 정렬됩니다.
mosaicLayout

object (MosaicLayout)

콘텐츠는 타일 그리드로 정렬되며 각 콘텐츠 위젯은 하나 이상의 그리드 블록을 차지합니다.
rowLayout

object (RowLayout)

콘텐츠가 동일한 간격의 행으로 나뉘고 위젯이 가로로 배치됩니다.
columnLayout

object (ColumnLayout)

콘텐츠가 동일한 간격의 열로 나누어지고 위젯이 세로로 정렬됩니다.

GridLayout

JSON 표현 
{
  "columns": string,
  "widgets": [
    {
      object (Widget)
    }
  ]
}
필드
columns

string (int64 format)

뷰의 너비가 나누어지는 열의 수입니다. 생략되거나 0으로 설정되면 렌더링 중에 시스템 기본값이 사용됩니다.
widgets[]

object (Widget)

열 행 우선으로 정렬된 정보 요소입니다.

위젯

JSON 표현 
{
  "title": string,
  "id": string,
  "visibilityCondition": {
    object (VisibilityCondition)
  },
  "timeRange": {
    object (TimeRange)
  },

  // Union field content can be only one of the following:
  "xyChart": {
    object (XyChart)
  },
  "scorecard": {
    object (Scorecard)
  },
  "text": {
    object (Text)
  },
  "blank": {
    object
  },
  "alertChart": {
    object (AlertChart)
  },
  "timeSeriesTable": {
    object (TimeSeriesTable)
  },
  "collapsibleGroup": {
    object (CollapsibleGroup)
  },
  "logsPanel": {
    object (LogsPanel)
  },
  "incidentList": {
    object (IncidentList)
  },
  "pieChart": {
    object (PieChart)
  },
  "treemap": {
    object (Treemap)
  },
  "errorReportingPanel": {
    object (ErrorReportingPanel)
  },
  "sectionHeader": {
    object (SectionHeader)
  },
  "singleViewGroup": {
    object (SingleViewGroup)
  },
  "filterControl": {
    object (FilterControl)
  }
  // End of list of possible types for union field content.
}
필드
title

string

선택사항입니다. 위젯의 제목입니다.
id

string

선택사항입니다. 위젯 ID입니다. ID는 영숫자, 대시, 밑줄로 구성될 수 있습니다. 위젯 ID는 선택사항입니다.
visibilityCondition

object (VisibilityCondition)

선택사항입니다. 설정된 경우 이 위젯은 조건이 true로 평가될 때만 렌더링됩니다.
timeRange

object (TimeRange)

선택사항입니다. 위젯의 시간 범위를 나타냅니다. 설정하면 이 기간이 대시보드 기간을 재정의합니다. 선, 누적 영역, 누적 막대 위젯에만 지원됩니다.
통합 필드 content. 콘텐츠는 위젯을 채우는 데 사용되는 구성요소를 정의합니다. content은 다음 중 하나여야 합니다.
xyChart

object (XyChart)

시계열 데이터의 차트입니다.
scorecard

object (Scorecard)

시계열 데이터를 요약한 스코어카드입니다.
text

object (Text)

텍스트 콘텐츠를 표시하는 원시 문자열 또는 마크다운입니다.
blank

object

빈 공간
alertChart

object (AlertChart)

알림 정책 데이터 차트
timeSeriesTable

object (TimeSeriesTable)

시계열 데이터를 표 형식으로 표시하는 위젯입니다.
collapsibleGroup

object (CollapsibleGroup)

다른 위젯을 그룹화하는 위젯입니다. 그룹화 위젯이 포함하는 영역 내에 있는 모든 위젯은 구성원 위젯으로 간주됩니다.
logsPanel

object (LogsPanel)

로그 스트림을 표시하는 위젯
incidentList

object (IncidentList)

사고 목록을 표시하는 위젯입니다.
pieChart

object (PieChart)

시계열 데이터를 원형 차트로 표시하는 위젯입니다.
treemap

object (Treemap)

데이터를 트리맵으로 표시하는 위젯입니다.
errorReportingPanel

object (ErrorReportingPanel)

오류 그룹 목록을 표시하는 위젯입니다.
sectionHeader

object (SectionHeader)

대시보드를 더 쉽게 탐색할 수 있도록 섹션 헤더를 정의하는 위젯입니다.
singleViewGroup

object (SingleViewGroup)

드롭다운 메뉴를 사용하여 다른 위젯을 그룹화하는 위젯입니다.
filterControl

object (FilterControl)

템플릿 변수의 값을 변경하는 입력 필드를 표시하는 위젯

XyChart

JSON 표현 
{
  "dataSets": [
    {
      object (DataSet)
    }
  ],
  "timeshiftDuration": string,
  "thresholds": [
    {
      object (Threshold)
    }
  ],
  "xAxis": {
    object (Axis)
  },
  "yAxis": {
    object (Axis)
  },
  "y2Axis": {
    object (Axis)
  },
  "chartOptions": {
    object (ChartOptions)
  }
}
필드
dataSets[]

object (DataSet)

필수 항목입니다. 이 차트에 표시되는 데이터입니다.
timeshiftDuration

string (Duration format)

비교 차트를 표시하는 데 사용되는 기간입니다. 비교 차트는 길이가 비슷한 두 기간의 값을 동시에 보여줍니다 (예: 전주 대비 측정항목). 기간은 양수여야 하며, 선 플롯 유형의 데이터 세트가 있는 차트에만 적용할 수 있습니다.

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

object (Threshold)

차트를 가로로 가로지르는 임계값 선입니다.
xAxis

object (Axis)

x축에 적용된 속성입니다.
yAxis

object (Axis)

y축에 적용된 속성입니다.
y2Axis

object (Axis)

y2 축에 적용된 속성입니다.
chartOptions

object (ChartOptions)

차트의 표시 옵션입니다.

데이터 세트

JSON 표현 
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "plotType": enum (PlotType),
  "legendTemplate": string,
  "minAlignmentPeriod": string,
  "targetAxis": enum (TargetAxis),
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "measures": [
    {
      object (Measure)
    }
  ],
  "breakdowns": [
    {
      object (Breakdown)
    }
  ],
  "sort": [
    {
      object (ColumnSortingOptions)
    }
  ]
}
필드
timeSeriesQuery

object (TimeSeriesQuery)

필수 항목입니다. Stackdriver 측정항목 API에서 시계열 데이터를 쿼리하는 필드입니다.
plotType

enum (PlotType)

이 데이터가 차트에 표시되는 방식입니다.
legendTemplate

string

결과 데이터 세트에서 TimeSeries의 이름을 지정하는 템플릿 문자열입니다. 이는 ${label_name} 형식의 삽입이 있는 문자열이어야 하며, 이는 라벨의 값으로 확인됩니다.
minAlignmentPeriod

string (Duration format)

선택사항입니다. 시계열 쿼리에서 사용할 최소 정렬 기간을 지정하여 구현된 이 데이터 세트의 데이터 포인트 빈도 하한입니다. 예를 들어 데이터가 10분마다 게시되는 경우 min_alignment_period는 10분 이상이어야 합니다. 1분 간격으로 데이터를 가져와 정렬하는 것은 적절하지 않습니다.

PromQL 쿼리의 경우 이 필드는 쿼리 step의 최소 간격을 설정하여 데이터 세부사항을 제어하는 데 사용됩니다. 값이 클수록 긴 기간의 성능이 향상될 수 있습니다. PromQL step에 대한 자세한 내용은 기본 쿼리 및 범위 쿼리를 참고하세요.

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

enum (TargetAxis)

선택사항입니다. 측정항목을 표시하는 데 사용할 타겟 축입니다.
dimensions[]

object (Dimension)

선택사항입니다. 측정기준 열의 컬렉션입니다.
measures[]

object (Measure)

선택사항입니다. 측정값의 모음입니다.
breakdowns[]

object (Breakdown)

선택사항입니다. 데이터 세트에 적용할 분류 모음입니다.
sort[]

object (ColumnSortingOptions)

선택사항입니다. 정렬 옵션 모음으로, 데이터와 범례의 순서에 영향을 줍니다.

TimeSeriesQuery

JSON 표현 
{
  "unitOverride": string,
  "outputFullDuration": boolean,

  // Union field source can be only one of the following:
  "timeSeriesFilter": {
    object (TimeSeriesFilter)
  },
  "timeSeriesFilterRatio": {
    object (TimeSeriesFilterRatio)
  },
  "timeSeriesQueryLanguage": string,
  "prometheusQuery": string,
  "opsAnalyticsQuery": {
    object (OpsAnalyticsQuery)
  },
  "traceQuery": {
    object (TraceQuery)
  }
  // End of list of possible types for union field source.
}
필드
unitOverride

string

가져온 시계열에 포함된 데이터의 단위입니다. 비어 있지 않으면 이 단위가 가져온 데이터와 함께 제공되는 단위를 재정의합니다. 형식은 MetricDescriptor의 unit 필드와 동일합니다.
outputFullDuration

boolean

선택사항입니다. 설정된 경우 Cloud Monitoring은 전체 쿼리 기간을 정렬 기간으로 처리하므로 출력 값이 하나만 있습니다.

*참고: - XyChart - 스코어카드의 스파크 차트와 같이 일련의 데이터 포인트가 예상되는 경우를 제외하고 구성된 정렬 기간을 재정의할 수 있습니다.
통합 필드 source. 차트의 데이터를 가져오는 데 필요한 매개변수입니다. source은 다음 중 하나여야 합니다.
timeSeriesFilter

object (TimeSeriesFilter)

시계열을 가져오기 위한 필터 매개변수입니다.
timeSeriesFilterRatio

object (TimeSeriesFilterRatio)

두 시계열 필터 간의 비율을 가져오는 파라미터입니다.
timeSeriesQueryLanguage

string

MQL로 시계열을 가져오는 데 사용되는 쿼리입니다.
prometheusQuery

string

PromQL로 시계열을 가져오는 데 사용되는 쿼리입니다.
opsAnalyticsQuery

object (OpsAnalyticsQuery)

미리보기: SQL을 사용하여 시계열, 카테고리 계열 또는 숫자 계열을 가져오는 데 사용되는 쿼리입니다. 이 기능은 미리보기 기능이며 최종 출시 전에 변경될 수 있습니다.
traceQuery

object (TraceQuery)

선택사항입니다. 미리보기: 트레이스 쿼리 이 기능은 미리보기 기능이며 최종 출시 전에 변경될 수 있습니다.

TimeSeriesFilter

JSON 표현 
{
  "filter": string,
  "aggregation": {
    object (Aggregation)
  },
  "secondaryAggregation": {
    object (Aggregation)
  },

  // Union field output_filter can be only one of the following:
  "pickTimeSeriesFilter": {
    object (PickTimeSeriesFilter)
  },
  "statisticalTimeSeriesFilter": {
    object (StatisticalTimeSeriesFilter)
  }
  // End of list of possible types for union field output_filter.
}
필드
filter

string

필수 항목입니다. 쿼리할 측정항목 유형, 리소스, 프로젝트를 식별하는 모니터링 필터입니다.
aggregation

object (Aggregation)

기본적으로 원시 시계열 데이터가 반환됩니다. 이 필드를 사용하여 데이터의 여러 보기에 대한 여러 시계열을 결합합니다.
secondaryAggregation

object (Aggregation)

aggregation이 적용된 후 두 번째 집계를 적용합니다.
통합 필드 output_filter. 선택적 시계열 필터를 선택합니다. output_filter은 다음 중 하나여야 합니다.
pickTimeSeriesFilter

object (PickTimeSeriesFilter)

순위 기반 시계열 필터입니다.
statisticalTimeSeriesFilter
(deprecated)

object (StatisticalTimeSeriesFilter)

통계 기반 시계열 필터입니다. 참고: 이 필드는 지원 중단되었으며 API에서 완전히 무시됩니다.

집계

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의 최댓값은 2년 또는 104주입니다.

소수점 아래가 최대 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(포함) 사이여야 합니다.

PickTimeSeriesFilter

JSON 표현 
{
  "rankingMethod": enum (Method),
  "numTimeSeries": integer,
  "direction": enum (Direction),
  "interval": {
    object (Interval)
  }
}
필드
rankingMethod

enum (Method)

ranking_method는 각 시계열에 독립적으로 적용되어 시계열을 다른 시계열과 비교하는 데 사용되는 값을 생성합니다.
numTimeSeries

integer

필터를 통과할 수 있는 시계열 수입니다.
direction

enum (Direction)

순위를 사용하여 필터를 통과하는 시계열을 선택하는 방법
interval

object (Interval)

이 시간 간격 내에서 상위 N개 스트림/시계열을 선택합니다.

간격

JSON 표현 
{
  "startTime": string,
  "endTime": string
}
필드
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"입니다.
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"입니다.

타임스탬프

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(포함) 사이여야 합니다.

StatisticalTimeSeriesFilter

JSON 표현 
{
  "rankingMethod": enum (Method),
  "numTimeSeries": integer
}
필드
rankingMethod

enum (Method)

rankingMethod는 시계열 집합에 적용되며, 각 개별 시계열에 대해 생성된 값은 지정된 시계열을 다른 시계열과 비교하는 데 사용됩니다. 이러한 메서드는 스트림별로 적용할 수 없으며 시계열을 평가하려면 요청의 전체 컨텍스트가 필요합니다.
numTimeSeries

integer

출력할 시계열 수입니다.

TimeSeriesFilterRatio

JSON 표현 
{
  "numerator": {
    object (RatioPart)
  },
  "denominator": {
    object (RatioPart)
  },
  "secondaryAggregation": {
    object (Aggregation)
  },

  // Union field output_filter can be only one of the following:
  "pickTimeSeriesFilter": {
    object (PickTimeSeriesFilter)
  },
  "statisticalTimeSeriesFilter": {
    object (StatisticalTimeSeriesFilter)
  }
  // End of list of possible types for union field output_filter.
}
필드
numerator

object (RatioPart)

비율의 분자입니다.
denominator

object (RatioPart)

비율의 분모입니다.
secondaryAggregation

object (Aggregation)

비율이 계산된 후 두 번째 집계를 적용합니다.
통합 필드 output_filter. 비율을 계산한 후 시계열에 적용되는 선택적 필터를 선택합니다. output_filter은 다음 중 하나여야 합니다.
pickTimeSeriesFilter

object (PickTimeSeriesFilter)

순위 기반 시계열 필터입니다.
statisticalTimeSeriesFilter
(deprecated)

object (StatisticalTimeSeriesFilter)

통계 기반 시계열 필터입니다. 참고: 이 필드는 지원 중단되었으며 API에서 완전히 무시됩니다.

RatioPart

JSON 표현 
{
  "filter": string,
  "aggregation": {
    object (Aggregation)
  }
}
필드
filter

string

필수 항목입니다. 쿼리할 측정항목 유형, 리소스, 프로젝트를 식별하는 모니터링 필터입니다.
aggregation

object (Aggregation)

기본적으로 원시 시계열 데이터가 반환됩니다. 이 필드를 사용하여 데이터의 여러 보기에 대한 여러 시계열을 결합합니다.

OpsAnalyticsQuery

JSON 표현 
{
  "sql": string
}
필드
sql

string

시계열, 카테고리 계열 또는 숫자 계열 데이터를 가져오는 SQL 쿼리입니다.

TraceQuery

JSON 표현 
{
  "spanDataValue": enum (SpanDataValue),
  "spanFilters": {
    object (SpanFilters)
  },
  "resourceContainer": string
}
필드
spanDataValue

enum (SpanDataValue)

차트에 표시할 스팬 데이터 값의 유형입니다. 필수 항목입니다.
spanFilters

object (SpanFilters)

지원할 스팬 필터링의 첫 번째 버전입니다. 필수 항목입니다.
resourceContainer

string

선택사항입니다. 데이터를 가져올 프로젝트 또는 추적 범위의 리소스 이름입니다. 비어 있으면 위젯은 프로젝트의 기본 추적 범위로 기본 설정됩니다. 범위를 확인할 수 없는 경우 현재 프로젝트로 대체됩니다. 선택사항입니다.

SpanFilters

JSON 표현 
{
  "services": [
    string
  ],
  "displayNames": [
    string
  ],
  "status": [
    string
  ],
  "kinds": [
    string
  ],
  "minDuration": string,
  "maxDuration": string,
  "attributes": [
    {
      object (SpanAttributeFilter)
    }
  ],
  "isRootSpan": boolean,
  "applicationIds": [
    string
  ],
  "apphubServices": [
    string
  ],
  "apphubWorkloads": [
    string
  ]
}
필드
services[]

string

선택사항입니다. 목록에 있는 서비스 중 하나를 포함하는 스팬을 필터링합니다. 여러 값은 OR 연산됩니다.
displayNames[]

string

선택사항입니다. 목록에 있는 스팬 표시 이름 중 하나를 포함하는 스팬을 필터링합니다. 여러 값은 OR 연산됩니다.
status[]

string

선택사항입니다. 목록에 있는 상태 중 하나를 포함하는 스팬을 필터링합니다. 여러 값은 OR 연산됩니다.
kinds[]

string

선택사항입니다. 목록에 있는 종류 중 하나를 포함하는 스팬을 필터링합니다. 여러 값은 OR 연산됩니다.
minDuration

string (Duration format)

선택사항입니다. 최소 기간이 있는 스팬 필터링

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

string (Duration format)

선택사항입니다. 최대 기간이 있는 스팬을 필터링합니다.

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

object (SpanAttributeFilter)

선택사항입니다. 스팬 속성 필터 목록입니다. 각 SpanAttributeFilter 키는 고유해야 합니다. 여러 속성 필터는 AND 연산됩니다.
isRootSpan

boolean

선택사항입니다. true로 설정된 경우 루트 스팬만 필터링합니다. 루트 스팬은 정의된 상위 스팬 ID가 없는 스팬입니다.
applicationIds[]

string

선택사항입니다. 목록에 있는 Apphub 애플리케이션 ID 중 하나를 포함하는 스팬을 필터링합니다. 여러 값은 OR 연산됩니다.
apphubServices[]

string

선택사항입니다. 목록에 있는 Apphub 서비스 ID 중 하나를 포함하는 스팬을 필터링합니다. 여러 값은 OR 연산됩니다. 예: ['service-id1', 'service-id2']
apphubWorkloads[]

string

선택사항입니다. 목록에 있는 Apphub 워크로드 ID 중 하나를 포함하는 스팬을 필터링합니다. 여러 값은 OR 연산됩니다. 예: ['workload-id1', 'workload-id2']

SpanAttributeFilter

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

string

속성의 키
value[]

string

지정된 키의 속성 값 목록입니다. 여러 값은 OR 연산됩니다.

측정기준

JSON 표현 
{
  "column": string,
  "columnType": string,
  "maxBinCount": integer,
  "sortOrder": enum (SortOrder),
  "sortColumn": string,
  "xMin": number,
  "xMax": number,

  // Union field bin_size can be only one of the following:
  "timeBinSize": string,
  "numericBinSize": integer,
  "floatBinSize": number
  // End of list of possible types for union field bin_size.
}
필드
column

string

필수 항목입니다. SQL 쿼리를 사용하는 위젯의 경우 값을 데이터가 차트로 표시되는 결과 테이블의 열 이름으로 설정합니다. 시계열 쿼리를 사용하는 히스토그램의 경우 이 필드의 값을 metric_value로 설정합니다.
columnType

string

선택사항입니다. 측정기준 열의 유형입니다. 이 값은 bin_size 필드 중 하나가 설정된 경우에만 관련이 있습니다. 비어 있으면 설정된 bin_size 필드를 기반으로 TIMESTAMP 또는 INT64 유형이 가정됩니다. 값이 채워진 경우 다음 유형 중 하나로 설정해야 합니다. DATE, TIME, DATETIME, TIMESTAMP, BIGNUMERIC, INT64, NUMERIC, FLOAT64
maxBinCount

integer

SQL 쿼리를 사용하는 위젯의 경우 생성할 구간 수의 한도입니다. 0이 지정되면 최대 개수가 적용되지 않습니다. 시계열 쿼리를 사용하는 히스토그램의 경우 생성할 정확한 구간 수입니다. 지정하지 않거나 값이 0이면 히스토그램에서 사용할 구간 수를 결정합니다.
sortOrder

enum (SortOrder)

정렬 열에 적용된 정렬 순서입니다.
sortColumn

string

구간화에 사용할 정렬 기준 열 이름입니다. 이 열은 이 측정기준과 동일한 열이거나 결과에서 측정치로 사용되는 다른 열일 수 있습니다. sort_order이 NONE로 설정된 경우 이 값은 사용되지 않습니다.
xMin

number

x축의 최솟값입니다.
xMax

number

x축의 최댓값입니다.
통합 필드 bin_size. bin_size 값은 column 필드로 지정된 측정기준의 포인트 그룹화를 구성하는 데 사용됩니다. bin_size은 다음 중 하나여야 합니다.
timeBinSize

string (Duration format)

time_bin_size는 지정된 측정기준의 데이터 유형이 시간 유형이고 구간 크기가 시간으로 결정되는 경우에 사용됩니다. column_type이 DATE인 경우 1일의 정수 배수여야 합니다. column_type가 TIME인 경우 24시간 이하여야 합니다.

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

integer

numeric_bin_size는 측정기준에 사용되는 열 유형이 숫자 또는 문자열인 경우에 사용됩니다. column 필드가 metric_value로 설정된 경우 numericBinSize가 maxBinCount을 재정의합니다.
floatBinSize

number

선택사항입니다. float_bin_size는 측정기준에 사용되는 열 유형이 부동 소수점 숫자 열인 경우에 사용됩니다.

측정

JSON 표현 
{
  "column": string,
  "aggregationFunction": {
    object (AggregationFunction)
  }
}
필드
column

string

필수 항목입니다. 측정에 사용되는 데이터 세트 내의 열 이름입니다.
aggregationFunction

object (AggregationFunction)

필수 항목입니다. 입력 열에 적용된 집계 함수입니다. 차원에서 구간화가 사용 중지되지 않는 한 "none"로 설정하면 안 됩니다. 집계 함수는 측정기준 구간의 점을 그룹화하는 데 사용됩니다.

AggregationFunction

JSON 표현 
{
  "type": string,
  "parameters": [
    {
      object (Parameter)
    }
  ]
}
필드
type

string

필수 항목입니다. 집계 함수의 유형은 다음 중 하나여야 합니다.

  • 'none' - 함수가 없습니다.
  • 'percentile' - APPROX_QUANTILES() - 1개의 매개변수 숫자 값
  • 'average' - AVG()
  • 'count' - COUNT()
  • 'count-distinct' - COUNT(DISTINCT)
  • 'count-distinct-approx' - APPROX_COUNT_DISTINCT()
  • 'max' - MAX()
  • 'min' - MIN()
  • 'sum' - SUM()
parameters[]

object (Parameter)

선택사항입니다. 집계 함수에 적용되는 매개변수입니다. 필요한 함수에만 사용됩니다.

매개변수

JSON 표현 
{

  // Union field value can be only one of the following:
  "intValue": string,
  "doubleValue": number
  // End of list of possible types for union field value.
}
필드
통합 필드 value. 파라미터 값입니다. value은 다음 중 하나여야 합니다.
intValue

string (int64 format)

정수 파라미터 값입니다.
doubleValue

number

부동 소수점 파라미터 값입니다.

분류

JSON 표현 
{
  "column": string,
  "limit": integer,
  "aggregationFunction": {
    object (AggregationFunction)
  },
  "sortOrder": enum (SortOrder)
}
필드
column

string

필수 항목입니다. 데이터 세트에서 분류 값을 포함하는 열의 이름입니다.
limit

integer

필수 항목입니다. 분류 수 제한입니다. 0으로 설정하면 가능한 모든 분류가 적용됩니다. 분류 목록은 sort_order 필드의 값에 따라 달라집니다.
aggregationFunction

object (AggregationFunction)

필수 항목입니다. 집계 함수는 생성된 각 분류의 모든 데이터에 적용됩니다.
sortOrder

enum (SortOrder)

필수 항목입니다. 정렬 순서는 분류 열의 값에 적용됩니다.

ColumnSortingOptions

JSON 표현 
{
  "column": string,
  "direction": enum (SortOrder)
}
필드
column

string

선택사항입니다. 데이터를 정렬할 열 이름
direction

enum (SortOrder)

선택사항입니다. 오름차순 또는 내림차순을 결정하는 정렬 방향입니다. 표와의 하위 호환성을 위해 유지되는 기존 필드입니다.

임곗값

JSON 표현 
{
  "label": string,
  "value": number,
  "color": enum (Color),
  "direction": enum (Direction),
  "targetAxis": enum (TargetAxis)
}
필드
label

string

기준점의 라벨입니다.
value

number

기준값입니다. 값은 측정항목의 기본 단위로 정의해야 합니다.
color

enum (Color)

이 기준점의 상태 색상입니다. XyChart에서는 색상이 허용되지 않습니다.
direction

enum (Direction)

현재 기준의 방향입니다. XyChart에서는 방향이 허용되지 않습니다.
targetAxis

enum (TargetAxis)

기준점을 표시하는 데 사용할 타겟 축입니다. 스코어카드에서는 타겟 축이 허용되지 않습니다.

Axis

JSON 표현 
{
  "label": string,
  "scale": enum (Scale)
}
필드
label

string

축의 라벨입니다.
scale

enum (Scale)

축 배율입니다. 기본적으로 선형 스케일이 사용됩니다.

ChartOptions

JSON 표현 
{
  "mode": enum (Mode),
  "displayHorizontal": boolean
}
필드
mode

enum (Mode)

차트 모드입니다.
displayHorizontal

boolean

미리보기: 차트에 표시된 값이 가로축 또는 세로축에 표시되는지 여부를 구성합니다. 기본적으로 값은 세로 축에 표시됩니다. 이 기능은 미리보기 기능이며 최종 출시 전에 변경될 수 있습니다.

스코어카드

JSON 표현 
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "thresholds": [
    {
      object (Threshold)
    }
  ],
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "measures": [
    {
      object (Measure)
    }
  ],
  "breakdowns": [
    {
      object (Breakdown)
    }
  ],

  // Union field data_view can be only one of the following:
  "gaugeView": {
    object (GaugeView)
  },
  "sparkChartView": {
    object (SparkChartView)
  },
  "blankView": {
    object
  }
  // End of list of possible types for union field data_view.
}
필드
timeSeriesQuery

object (TimeSeriesQuery)

필수 항목입니다. Stackdriver 측정항목 API에서 시계열 데이터를 쿼리하는 필드입니다.
thresholds[]

object (Threshold)

시계열의 현재 값을 고려하여 스코어카드의 상태를 결정하는 데 사용되는 기준입니다. 실제 값 x의 경우 x가 아래에서 트리거되는 위험 기준 이하이거나 위에서 트리거되는 위험 기준 이상이면 스코어카드가 위험 상태에 있습니다. 마찬가지로 x가 위/아래를 트리거하는 경고 임곗값 위/아래에 있으면 x로 인해 위험 상태가 되지 않는 한 스코어카드는 경고 상태에 있습니다. (위험이 경고보다 우선합니다.)

예를 들어 다음 네 가지 기준점이 있는 스코어카드를 생각해 보겠습니다.

{
  value: 90,
  category: 'DANGER',
  trigger: 'ABOVE',
},
{
  value: 70,
  category: 'WARNING',
  trigger: 'ABOVE',
},
{
  value: 10,
  category: 'DANGER',
  trigger: 'BELOW',
},
{
  value: 20,
  category: 'WARNING',
  trigger: 'BELOW',
}

그런 다음 10 이하의 값은 스코어카드를 위험 상태로, 10보다 크고 20 이하의 값은 경고 상태로, 20과 70 사이의 값은 양호 상태로, 70 이상 90 미만의 값은 경고 상태로, 90 이상의 값은 위험 상태로 설정합니다.
dimensions[]

object (Dimension)

선택사항입니다. 측정기준은 데이터의 측정값 집합에 대한 구조화된 라벨, 클래스 또는 카테고리입니다.
measures[]

object (Measure)

선택사항입니다. 측정값은 데이터의 속성에 대한 측정된 값입니다. 예를 들어 강수량(인치), 판매된 단위 수, 획득한 수익 등이 있습니다.
breakdowns[]

object (Breakdown)

선택사항입니다. 데이터 세트에 적용할 분류 모음입니다. 분류는 데이터를 분류하는 방법입니다. 예를 들어 리전별로 데이터를 분류할 수 있습니다.
통합 필드 data_view. 스코어카드에 표시되는 선택적 추가 차트를 정의합니다. 둘 다 포함되지 않으면 기본 스코어카드가 표시됩니다. data_view은 다음 중 하나여야 합니다.
gaugeView

object (GaugeView)

스코어카드에 게이지 차트가 표시됩니다.
sparkChartView

object (SparkChartView)

스코어카드에 스파크 차트가 표시됩니다.
blankView

object

Scorecard에 임계값에 대한 값의 표시기 없이 값만 표시됩니다.

GaugeView

JSON 표현 
{
  "lowerBound": number,
  "upperBound": number
}
필드
lowerBound

number

이 게이지 차트의 하한입니다. 차트의 값은 항상 이 값 이상이어야 합니다.
upperBound

number

이 게이지 차트의 상한입니다. 차트의 값은 항상 이 값보다 작거나 같아야 합니다.

SparkChartView

JSON 표현 
{
  "sparkChartType": enum (SparkChartType),
  "minAlignmentPeriod": string
}
필드
sparkChartType

enum (SparkChartType)

필수 항목입니다. 이 chartView에 표시할 스파크 차트의 유형입니다.
minAlignmentPeriod

string (Duration format)

시계열 쿼리에서 사용할 최소 정렬 기간을 지정하여 구현된 차트의 데이터 포인트 빈도 하한입니다. 예를 들어 데이터가 10분마다 한 번 게시되는 경우 1분 간격으로 데이터를 가져와 정렬하는 것은 의미가 없습니다. 이 필드는 선택사항이며 힌트로만 존재합니다.

PromQL 쿼리의 경우 이 필드는 쿼리 step의 최소 간격을 설정하여 데이터 세부사항을 제어하는 데 사용됩니다. 값이 클수록 긴 기간의 성능이 향상될 수 있습니다. PromQL step에 대한 자세한 내용은 기본 쿼리 및 범위 쿼리를 참고하세요.

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

텍스트

JSON 표현 
{
  "content": string,
  "format": enum (Format),
  "style": {
    object (TextStyle)
  }
}
필드
content

string

표시할 텍스트 콘텐츠입니다.
format

enum (Format)

텍스트 콘텐츠의 형식입니다.
style

object (TextStyle)

텍스트의 스타일 지정 방법

TextStyle

JSON 표현 
{
  "backgroundColor": string,
  "textColor": string,
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "padding": enum (PaddingSize),
  "fontSize": enum (FontSize),
  "pointerLocation": enum (PointerLocation)
}
필드
backgroundColor

string

배경색(16진수 문자열)입니다. '#RRGGBB' 또는 '#RGB'
textColor

string

텍스트 색상(16진수 문자열)입니다. '#RRGGBB' 또는 '#RGB'
horizontalAlignment

enum (HorizontalAlignment)

제목과 콘텐츠의 가로 정렬
verticalAlignment

enum (VerticalAlignment)

제목과 콘텐츠의 세로 정렬
padding

enum (PaddingSize)

위젯 주변의 패딩 양
fontSize

enum (FontSize)

제목과 콘텐츠의 글꼴 크기입니다. 제목은 콘텐츠에 비해 여전히 더 크게 표시됩니다.
pointerLocation

enum (PointerLocation)

이 위젯의 포인터 위치입니다('꼬리'라고도 함).

AlertChart

JSON 표현 
{
  "name": string
}
필드
name

string

필수 항목입니다. 알림 정책의 리소스 이름입니다. 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

TimeSeriesTable

JSON 표현 
{
  "dataSets": [
    {
      object (TableDataSet)
    }
  ],
  "metricVisualization": enum (MetricVisualization),
  "columnSettings": [
    {
      object (ColumnSettings)
    }
  ]
}
필드
dataSets[]

object (TableDataSet)

필수 항목입니다. 이 표에 표시된 데이터입니다.
metricVisualization

enum (MetricVisualization)

선택사항입니다. 저장소 렌더링 전략
columnSettings[]

object (ColumnSettings)

선택사항입니다. 표의 영구 열 설정 목록입니다.

TableDataSet

JSON 표현 
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "tableTemplate": string,
  "minAlignmentPeriod": string,
  "tableDisplayOptions": {
    object (TableDisplayOptions)
  }
}
필드
timeSeriesQuery

object (TimeSeriesQuery)

필수 항목입니다. Stackdriver 측정항목 API에서 시계열 데이터를 쿼리하는 필드입니다.
tableTemplate

string

선택사항입니다. 결과 데이터 세트에서 TimeSeries의 이름을 지정하는 템플릿 문자열입니다. 이는 ${label_name} 형식의 삽입이 있는 문자열이어야 하며, 이는 라벨의 값(예: '${resource.labels.project_id}')으로 확인됩니다.
minAlignmentPeriod

string (Duration format)

선택사항입니다. 이 데이터 세트의 데이터 포인트 빈도의 하한입니다. 시계열 쿼리에서 사용할 최소 정렬 기간을 지정하여 구현됩니다. 예를 들어 데이터가 10분마다 한 번 게시되는 경우 min_alignment_period는 최소 10분이어야 합니다. 1분 간격으로 데이터를 가져와 정렬하는 것은 적절하지 않습니다.

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

object (TableDisplayOptions)

선택사항입니다. 표가 렌더링되는 방식을 구성하는 표 표시 옵션입니다.

TableDisplayOptions

JSON 표현 
{
  "shownColumns": [
    string
  ]
}
필드
shownColumns[]
(deprecated)

string

선택사항입니다. 이 필드는 사용되지 않으며 TimeSeriesTable.column_settings로 대체되었습니다.

ColumnSettings

JSON 표현 
{
  "column": string,
  "visible": boolean,
  "alignment": enum (CellAlignment),
  "displayName": string,
  "thresholds": [
    {
      object (Threshold)
    }
  ]
}
필드
column

string

필수 항목입니다. 열의 ID입니다.
visible

boolean

필수 항목입니다. 페이지 로드 시 열이 표시되어야 하는지 여부입니다.
alignment

enum (CellAlignment)

선택사항입니다. 열을 왼쪽 / 가운데 / 오른쪽으로 정렬할지 여부
displayName

string

선택사항입니다. 열의 표시 이름
thresholds[]

object (Threshold)

선택사항입니다. 시계열의 현재 값을 고려하여 표 셀을 렌더링하는 방법을 결정하는 데 사용되는 기준입니다.

CollapsibleGroup

JSON 표현 
{
  "collapsed": boolean
}
필드
collapsed

boolean

첫 페이지 로드 시 위젯의 축소된 상태입니다.

LogsPanel

JSON 표현 
{
  "filter": string,
  "resourceNames": [
    string
  ]
}
필드
filter

string

반환할 로그 항목을 선택하는 필터입니다. 고급 로그 쿼리를 참고하세요. 필터와 일치하는 로그 항목만 반환됩니다. 빈 필터는 모든 로그 항목과 일치합니다.
resourceNames[]

string

로그를 수집할 로깅 리소스의 이름입니다. 현재 프로젝트 및 스토리지 뷰가 지원됩니다. 비어 있으면 위젯은 기본적으로 호스트 프로젝트로 설정됩니다.

IncidentList

JSON 표현 
{
  "monitoredResources": [
    {
      object (MonitoredResource)
    }
  ],
  "policyNames": [
    string
  ]
}
필드
monitoredResources[]

object (MonitoredResource)

선택사항입니다. 이슈가 나열된 모니터링 리소스입니다. 리소스를 완전히 지정할 필요는 없습니다. 즉, 리소스 유형은 지정할 수 있지만 리소스 라벨의 값은 지정할 수 없습니다. 리소스 유형과 라벨은 필터링에 사용됩니다.
policyNames[]

string

선택사항입니다. 사고 목록을 필터링할 알림 정책 이름 목록입니다. 정책 이름에 프로젝트 ID 접두사를 포함하지 마세요. 예를 들어 alertPolicies/utilization을 사용합니다.

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

PieChart

JSON 표현 
{
  "dataSets": [
    {
      object (PieChartDataSet)
    }
  ],
  "chartType": enum (PieChartType),
  "showLabels": boolean
}
필드
dataSets[]

object (PieChartDataSet)

필수 항목입니다. 차트 데이터의 쿼리입니다.
chartType

enum (PieChartType)

필수 항목입니다. PieChart의 시각화 유형을 나타냅니다.
showLabels

boolean

선택사항입니다. 원형 차트에서 슬라이스의 라벨을 표시할지 여부를 나타냅니다.

PieChartDataSet

JSON 표현 
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "sliceNameTemplate": string,
  "minAlignmentPeriod": string,
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "measures": [
    {
      object (Measure)
    }
  ]
}
필드
timeSeriesQuery

object (TimeSeriesQuery)

필수 항목입니다. 원형 차트의 쿼리입니다. google.monitoring.dashboard.v1.TimeSeriesQuery를 참고하세요.
sliceNameTemplate

string

선택사항입니다. 슬라이스 이름의 템플릿입니다. 이 이름은 원형 차트의 범례와 도움말에 표시됩니다. 슬라이스의 자동 생성 이름을 대체합니다. 예를 들어 템플릿이 ${resource.labels.zone}로 설정된 경우 기본 이름 대신 영역의 값이 이름에 사용됩니다.
minAlignmentPeriod

string (Duration format)

선택사항입니다. 시계열 쿼리에서 사용할 최소 정렬 기간을 지정하여 구현된 이 데이터 세트의 데이터 포인트 빈도 하한입니다. 예를 들어 데이터가 10분마다 게시되는 경우 min_alignment_period는 10분 이상이어야 합니다. 1분 간격으로 데이터를 가져와 정렬하는 것은 적절하지 않습니다.

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

object (Dimension)

측정기준은 데이터의 측정값 집합에 대한 구조화된 라벨, 클래스 또는 카테고리입니다.
measures[]

object (Measure)

측정값은 데이터의 속성에 대한 측정된 값입니다. 예를 들어 강수량(인치), 판매된 단위 수, 획득한 수익 등이 있습니다.

트리맵

JSON 표현 
{
  "dataSets": [
    {
      object (TreemapDataSet)
    }
  ],
  "treemapHierarchy": [
    string
  ]
}
필드
dataSets[]

object (TreemapDataSet)

필수 항목입니다. 트리맵을 구성하고 채우는 데 사용되는 데이터 세트 모음입니다. 렌더링된 트리맵 직사각형의 경우:

  • 색상은 각 그룹화의 집계 값에 따라 결정됩니다.
  • 크기는 해당 직사각형 세그먼트 내에서 집계된 시계열 수에 비례합니다.
treemapHierarchy[]

string

필수 항목입니다. 계층적 트리맵 구조를 나타내는 순서가 지정된 라벨입니다.

TreemapDataSet

JSON 표현 
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "measures": [
    {
      object (Measure)
    }
  ],
  "breakdowns": [
    {
      object (Breakdown)
    }
  ]
}
필드
timeSeriesQuery

object (TimeSeriesQuery)

필수 항목입니다. 관련 데이터를 가져오는 쿼리입니다. google.monitoring.dashboard.v1.TimeSeriesQuery 보기
measures[]

object (Measure)

선택사항입니다. 측정값의 모음입니다. 측정값은 데이터의 속성에 대한 측정된 값입니다. 예를 들어 강수량(인치), 판매된 단위 수, 획득한 수익 등이 있습니다.
breakdowns[]

object (Breakdown)

선택사항입니다. 데이터 세트에 적용할 분류 모음입니다. 분류는 데이터를 분류하는 방법입니다. 예를 들어 리전별로 데이터를 분류할 수 있습니다.

ErrorReportingPanel

JSON 표현 
{
  "projectNames": [
    string
  ],
  "services": [
    string
  ],
  "versions": [
    string
  ]
}
필드
projectNames[]

string

Google Cloud Platform 프로젝트의 리소스 이름입니다. projects/{projectID} 또는 projects/{projectNumber}으로 작성되며, 여기서 {projectID} 및 {projectNumber}은 Google Cloud 콘솔에서 확인할 수 있습니다.

예시: projects/my-project-123, projects/5551234.
services[]

string

실행 파일 이름, 작업, Google App Engine 서비스 이름과 같은 서비스 식별자입니다. 이 필드는 새 코드가 배포될 때마다 변경할 수 있는 version과 달리 시간이 지남에 따라 상대적으로 안정된 값이 적을 것으로 예상됩니다.

Google App Engine 로그에서 추출된 오류 보고서의 서비스 이름 또는 App Engine 기본 서비스가 사용된 경우 default을 포함합니다.
versions[]

string

개발자가 제공한 소스 코드 버전을 나타내며, 예를 들어 버전 라벨 또는 Git SHA-1 해시를 나타낼 수 있습니다. App Engine 표준 환경에서는 버전이 앱의 버전으로 설정됩니다.

SectionHeader

JSON 표현 
{
  "subtitle": string,
  "dividerBelow": boolean
}
필드
subtitle

string

섹션의 부제목
dividerBelow

boolean

목차의 섹션 아래에 구분선을 삽입할지 여부

SingleViewGroup

JSON 표현 
{
  "displayType": enum (DisplayType)
}
필드
displayType

enum (DisplayType)

선택사항입니다. 위젯 선택기가 표시되는 방식을 결정합니다.

FilterControl

JSON 표현 
{
  "templateVariable": string
}
필드
templateVariable

string

위젯이 영향을 미치는 템플릿 변수의 이름입니다.

VisibilityCondition

JSON 표현 
{
  "templateVariableCondition": {
    object (TemplateVariableCondition)
  }
}
필드
templateVariableCondition

object (TemplateVariableCondition)

템플릿 변수 값을 기반으로 평가되는 조건입니다.

TemplateVariableCondition

JSON 표현 
{
  "templateVariable": string,
  "templateVariableValue": string,
  "comparator": enum (Comparator)
}
필드
templateVariable

string

값이 평가되는 템플릿 변수입니다.
templateVariableValue

string

템플릿 변수와 비교할 값입니다. 예를 들어 비교 연산자가 REGEX_FULL_MATCH인 경우 이 필드에는 정규식이 포함되어야 합니다.
comparator

enum (Comparator)

템플릿 변수의 값이 template_variable_value와 일치하는지 평가하는 데 사용할 비교 연산자입니다. 예를 들어 비교기가 REGEX_FULL_MATCH인 경우 template_variable_value에는 템플릿 변수의 값과 일치하는 정규식이 포함됩니다.

TimeRange

JSON 표현 
{

  // Union field time_interval can be only one of the following:
  "absoluteWindow": {
    object (Interval)
  },
  "relativeDuration": string
  // End of list of possible types for union field time_interval.
}
필드
통합 필드 time_interval. 시간 범위 간격의 유형을 지정합니다. time_interval은 다음 중 하나여야 합니다.
absoluteWindow

object (Interval)

선택사항입니다. 절대 시작 시간과 종료 시간이 있는 시간 범위를 나타냅니다. 시작 시간은 포함되고 종료 시간은 제외됩니다.
relativeDuration

string (Duration format)

선택사항입니다. 현재 시간을 종료 시간으로 하여 데이터를 이동하는 데 사용되는 기간을 지정합니다. 기간은 양수여야 합니다.

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

MosaicLayout

JSON 표현 
{
  "columns": integer,
  "tiles": [
    {
      object (Tile)
    }
  ]
}
필드
columns

integer

모자이크 그리드의 열 수입니다. 열 수는 1~48개여야 합니다.
tiles[]

object (Tile)

표시할 타일입니다.

타일

JSON 표현 
{
  "xPos": integer,
  "yPos": integer,
  "width": integer,
  "height": integer,
  "widget": {
    object (Widget)
  }
}
필드
xPos

integer

그리드 블록에서 타일의 0부터 시작하는 위치입니다(그리드의 왼쪽 가장자리를 기준으로). 타일은 지정된 열 수 내에 포함되어야 합니다. x_pos은 음수일 수 없습니다.
yPos

integer

그리드 블록에서 타일의 0 기반 위치입니다(그리드의 상단 가장자리를 기준으로). y_pos은 음수일 수 없습니다.
width

integer

타일의 너비입니다(그리드 블록 단위). 타일의 최소 너비는 1이어야 합니다.
height

integer

타일의 높이입니다(그리드 블록 단위). 타일의 최소 높이는 1이어야 합니다.
widget

object (Widget)

타일에 포함된 정보 위젯입니다. 예를 들어 XyChart입니다.

RowLayout

JSON 표현 
{
  "rows": [
    {
      object (Row)
    }
  ]
}
필드
rows[]

object (Row)

표시할 콘텐츠 행입니다.

행

JSON 표현 
{
  "weight": string,
  "widgets": [
    {
      object (Widget)
    }
  ]
}
필드
weight

string (int64 format)

이 행의 상대적 가중치입니다. 행 가중치는 화면에서 행의 높이를 조정하는 데 사용됩니다 (동종 항목과 관련). 가중치가 클수록 화면에서 행의 높이가 커집니다. 생략하면 렌더링 중에 값 1이 사용됩니다.
widgets[]

object (Widget)

이 행에 가로로 정렬된 디스플레이 위젯입니다.

ColumnLayout

JSON 표현 
{
  "columns": [
    {
      object (Column)
    }
  ]
}
필드
columns[]

object (Column)

표시할 콘텐츠 열입니다.

열

JSON 표현 
{
  "weight": string,
  "widgets": [
    {
      object (Widget)
    }
  ]
}
필드
weight

string (int64 format)

이 열의 상대 가중치입니다. 열 가중치는 화면에서 열의 너비를 조정하는 데 사용됩니다 (동종 항목과 관련). 가중치가 클수록 화면의 열 너비가 커집니다. 생략하면 렌더링 중에 값 1이 사용됩니다.
widgets[]

object (Widget)

이 열에 세로로 정렬된 위젯을 표시합니다.

DashboardFilter

JSON 표현 
{
  "labelKey": string,
  "templateVariable": string,
  "valueType": enum (ValueType),
  "filterType": enum (FilterType),

  // Union field default_value can be only one of the following:
  "stringValue": string,
  "stringArrayValue": {
    object (StringArray)
  }
  // End of list of possible types for union field default_value.

  // Union field value_source can be only one of the following:
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "stringArray": {
    object (StringArray)
  }
  // End of list of possible types for union field value_source.
}
필드
labelKey

string

선택사항입니다. 라벨의 키입니다. filter_type이 VALUE_ONLY인 경우 생략해야 하지만 그렇지 않은 경우에는 필수입니다.
templateVariable

string

필터 문자열 또는 MQL 쿼리에서 참조할 수 있는 자리표시자 텍스트입니다. 생략하면 대시보드 필터가 대시보드의 모든 관련 위젯에 적용됩니다.
valueType

enum (ValueType)

필터 값의 유형입니다. value_type이 제공되지 않으면 default_value에서 추론됩니다. value_type과 default_value가 모두 제공되지 않으면 value_type이 기본적으로 STRING으로 설정됩니다.
filterType

enum (FilterType)

지정된 필터 유형
통합 필드 default_value. 필터 비교 default_value에 사용되는 기본값은 다음 중 하나일 수 있습니다.
stringValue

string

가변 길이 문자열 값입니다. 이 필드가 설정된 경우 value_type은 STRING 또는 VALUE_TYPE_UNSPECIFIED로 설정해야 합니다.
stringArrayValue

object (StringArray)

가변 길이 문자열 값의 배열입니다. 이 필드가 설정된 경우 value_type은 STRING_ARRAY 또는 VALUE_TYPE_UNSPECIFIED로 설정해야 합니다.
통합 필드 value_source. 필터의 유효한 값 집합의 정의입니다. 이는 선택사항이지만 VALUE_ONLY 필터에 권장됩니다. 다른 필터 유형의 경우 유효한 값 집합은 차트에 표시된 데이터에서 추론됩니다. value_source은 다음 중 하나여야 합니다.
timeSeriesQuery

object (TimeSeriesQuery)

필터의 가능한 값을 가져오기 위해 실행할 쿼리입니다. OpsAnalyticsQueries만 지원됩니다.
stringArray

object (StringArray)

필터에 사용할 수 있는 문자열 값의 목록

StringArray

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

string

배열의 값

LabelsEntry

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

string
value

string

DashboardAnnotations

JSON 표현 
{
  "defaultResourceNames": [
    string
  ],
  "eventAnnotations": [
    {
      object (EventAnnotation)
    }
  ]
}
필드
defaultResourceNames[]

string

이벤트를 검색할 로깅 리소스 이름의 대시보드 수준 기본값입니다. 현재는 프로젝트만 지원됩니다. 각 EventAnnotation에는 자체 재정의가 있을 수 있습니다. 이 필드와 주석별 필드가 모두 비어 있으면 범위 지정 프로젝트가 사용됩니다. 한도: 50개 프로젝트 예를 들면 다음과 같습니다.

“projects/some-project-id”
eventAnnotations[]

object (EventAnnotation)

이 대시보드의 주석 구성 목록입니다. 각 항목은 하나의 이벤트 유형을 지정합니다.

EventAnnotation

JSON 표현 
{
  "displayName": string,
  "eventType": enum (EventType),
  "filter": string,
  "enabled": boolean,
  "resourceNames": [
    string
  ]
}
필드
displayName

string

UI 표시 전용입니다. 프로그래매틱 방식으로 사용해서는 안 됩니다.
eventType

enum (EventType)

표시할 이벤트 유형입니다.
filter

string

이벤트를 필터링하는 문자열입니다(이벤트에 따라 다름). 예시 값:

"resource.labels.pod_name = 'pod-1'"
"protoPayload.authenticationInfo.principalEmail='user@example.com'"
enabled

boolean

대시보드에 이벤트를 기본적으로 표시할지 여부
resourceNames[]

string

이벤트를 검색할 로깅 리소스 이름의 주석 수준별 재정의입니다. 현재는 프로젝트만 지원됩니다. 이 필드와 주석별 필드가 모두 비어 있으면 기본값은 호스트 프로젝트입니다. 한도: 50개 프로젝트 예를 들면 다음과 같습니다.

“projects/another-project-id”

정렬기

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입니다.

메서드

PickTimeSeriesFilter에 적용할 수 있는 값 리듀서입니다.

열거형
METHOD_UNSPECIFIED 허용되지 않음 PickTimeSeriesFilter를 지정하는 경우 다른 Method를 지정해야 합니다.
METHOD_MEAN 모든 값의 평균을 선택합니다.
METHOD_MAX 최댓값을 선택합니다.
METHOD_MIN 최솟값을 선택합니다.
METHOD_SUM 모든 값의 합계를 계산합니다.
METHOD_LATEST 최근 값을 선택합니다.

방향

순위 지정 방향을 설명합니다.

열거형
DIRECTION_UNSPECIFIED 허용되지 않음 PickTimeSeriesFilter를 지정하는 경우 다른 Direction를 지정해야 합니다.
TOP 가장 높은 num_time_series 순위 입력값을 전달합니다.
BOTTOM 가장 낮은 num_time_series 순위 입력값을 전달합니다.

메서드

스트림에 적용할 수 있는 필터 메서드입니다.

열거형
METHOD_UNSPECIFIED 형식이 올바른 요청에서는 허용되지 않습니다.
METHOD_CLUSTER_OUTLIER 각 스트림의 이상치 점수를 계산합니다.

SpanDataValue

차트에 표시되는 데이터를 결정하는 데 사용되는 다양한 스팬 데이터 값의 목록

열거형
SPAN_DATA_VALUE_UNSPECIFIED 열거형에는 UNSPECIFIED 값이 있어야 합니다. 실제로 사용해서는 안 됩니다.
SPAN_COUNT 스팬 개수 데이터 값
SPAN_DURATION 스팬 소요 시간 데이터 값
SPAN_DURATION_PERCENTILES 스팬 지속 시간 백분위수 데이터 값

PlotType

데이터 세트의 플롯팅 전략 유형입니다.

열거형
PLOT_TYPE_UNSPECIFIED 플롯 유형이 지정되지 않았습니다. 뷰는 기본적으로 LINE로 설정됩니다.
LINE 데이터는 선 집합 (계열당 하나의 선)으로 표시됩니다.
STACKED_AREA 데이터는 채워진 영역 집합 (계열당 하나의 영역)으로 표시되며 영역은 세로로 누적됩니다 (각 영역의 기준은 이전 영역의 상단이고 첫 번째 영역의 기준은 x축임). 영역이 겹치지 않으므로 각 영역은 불투명한 다른 색상으로 채워집니다.
STACKED_BAR 데이터는 직사각형 상자 세트 (계열당 상자 하나)로 표시되며 상자는 세로로 쌓입니다 (각 상자의 밑면은 이전 상자의 상단이고 첫 번째 상자의 밑면은 x축임). 상자가 겹치지 않으므로 각 상자는 서로 다른 불투명 색상으로 채워집니다.
HEATMAP 데이터가 히트맵으로 표시됩니다. 플롯되는 계열의 값 유형은 DISTRIBUTION이어야 합니다. 분포의 각 버킷 값은 색상으로 표시됩니다. 이 유형은 현재 Stackdriver Monitoring 애플리케이션에서 사용할 수 없습니다.

TargetAxis

축 식별자입니다.

열거형
TARGET_AXIS_UNSPECIFIED 타겟 축이 지정되지 않았습니다. 기본값은 Y1입니다.
Y1 y_axis (차트의 오른쪽 축)입니다.
Y2 y2_axis (차트의 왼쪽 축)입니다.

SortOrder

정렬 순서 옵션입니다.

열거형
SORT_ORDER_UNSPECIFIED 지정되지 않은 정렬 순서입니다. 정렬이 필요한 경우 이 옵션은 유효하지 않습니다.
SORT_ORDER_NONE 정렬이 적용되지 않습니다.
SORT_ORDER_ASCENDING 값이 가장 낮은 항목이 먼저 선택됩니다.
SORT_ORDER_DESCENDING 값이 가장 높은 항목이 먼저 선택됩니다.

색상

색상은 실제 값이 기준값을 교차할 때 시청자에게 해석을 제안합니다. 각 색상에 대한 의견은 사용자가 특정 상태 색상을 해석하는 방법에 관한 UX 안내를 제공합니다.

열거형
COLOR_UNSPECIFIED 색상이 지정되지 않았습니다. 형식이 올바른 요청에서는 허용되지 않습니다.
YELLOW 임계값을 초과하는 것은 '우려되는' 동작입니다.
RED 임계값을 초과하는 것은 '긴급' 동작입니다.

방향

실제 값이 기준값 위 또는 아래에 있어 기준을 초과한 것으로 간주되는지 여부입니다.

열거형
DIRECTION_UNSPECIFIED 형식이 올바른 요청에서는 허용되지 않습니다.
ABOVE 실제 값이 기준 값을 초과하면 기준 값을 초과한 것으로 간주됩니다.
BELOW 실제 값이 임곗값 미만이면 임곗값을 초과한 것으로 간주됩니다.

TargetAxis

축 식별자입니다.

열거형
TARGET_AXIS_UNSPECIFIED 타겟 축이 지정되지 않았습니다. 기본값은 Y1입니다.
Y1 y_axis (차트의 오른쪽 축)입니다.
Y2 y2_axis (차트의 왼쪽 축)입니다.

확장

축에 사용된 스케일 유형입니다.

열거형
SCALE_UNSPECIFIED 규모가 지정되지 않았습니다. 뷰는 기본적으로 LINEAR로 설정됩니다.
LINEAR 선형 스케일입니다.
LOG10 로그 스케일 (밑 10)

모드

차트 모드 옵션입니다.

열거형
MODE_UNSPECIFIED 모드가 지정되지 않았습니다. 뷰는 기본적으로 COLOR로 설정됩니다.
COLOR 차트에서는 서로 다른 색상을 사용하여 데이터 계열을 구분합니다. 차트에 선이 많으면 선 색상이 재사용될 수 있습니다.
X_RAY 차트는 각 데이터 세트가 동일한 반투명 색상을 사용하여 표시되는 Stackdriver X-Ray 모드를 사용합니다.
STATS 차트에는 평균, 중앙값, 95번째 백분위수 등의 통계가 표시됩니다.

SparkChartType

Scorecard에서 지원하는 스파크 차트의 가능한 유형을 정의합니다.

열거형
SPARK_CHART_TYPE_UNSPECIFIED 형식이 올바른 요청에서는 허용되지 않습니다.
SPARK_LINE 스파크라인이 작은 선 차트로 렌더링됩니다.
SPARK_BAR 스파크 막대는 작은 막대 그래프로 렌더링됩니다.

형식

텍스트 콘텐츠의 형식 유형입니다.

열거형
FORMAT_UNSPECIFIED 형식이 지정되지 않았습니다. 기본값은 MARKDOWN입니다.
MARKDOWN 텍스트에 마크다운 형식이 포함되어 있습니다.
RAW 텍스트에 특별한 서식이 포함되어 있지 않습니다.

HorizontalAlignment

텍스트 위젯의 제목과 콘텐츠의 가로 정렬

열거형
HORIZONTAL_ALIGNMENT_UNSPECIFIED 가로 정렬이 지정되지 않았으므로 H_LEFT로 기본 설정됩니다.
H_LEFT 왼쪽 맞춤
H_CENTER 가운데 맞춤
H_RIGHT 오른쪽 맞춤

VerticalAlignment

텍스트 위젯의 제목과 콘텐츠의 세로 정렬

열거형
VERTICAL_ALIGNMENT_UNSPECIFIED 세로 정렬이 지정되지 않았으므로 V_TOP으로 기본 설정됩니다.
V_TOP 위쪽 정렬
V_CENTER 가운데 맞춤
V_BOTTOM 아래쪽 맞춤

PaddingSize

텍스트 위젯 주변의 패딩 크기를 지정합니다.

열거형
PADDING_SIZE_UNSPECIFIED 패딩 크기가 지정되지 않았습니다. 기본값은 P_EXTRA_SMALL입니다.
P_EXTRA_SMALL 매우 작은 패딩
P_SMALL 작은 패딩
P_MEDIUM 중간 패딩
P_LARGE 큰 패딩
P_EXTRA_LARGE 매우 큰 패딩

FontSize

텍스트 위젯의 제목과 콘텐츠의 글꼴 크기를 지정합니다.

열거형
FONT_SIZE_UNSPECIFIED 글꼴 크기가 지정되지 않았으므로 FS_LARGE가 기본값으로 설정됩니다.
FS_EXTRA_SMALL 아주 작은 글꼴 크기
FS_SMALL 글꼴 크기가 작음
FS_MEDIUM 글꼴 크기가 중간
FS_LARGE 글꼴 크기가 큼
FS_EXTRA_LARGE 아주 큰 글꼴 크기

PointerLocation

텍스트 위젯에 시각적 포인터가 배치되는 위치를 지정합니다('꼬리'라고도 함).

열거형
POINTER_LOCATION_UNSPECIFIED 시각적 포인터 없음
PL_TOP 위젯 상단 중앙에 배치
PL_RIGHT 위젯 오른쪽 중앙에 배치
PL_BOTTOM 위젯 하단 중앙에 배치
PL_LEFT 위젯의 왼쪽 중앙에 배치
PL_TOP_LEFT 위젯 상단 왼쪽에 배치
PL_TOP_RIGHT 위젯 상단 오른쪽에 배치
PL_RIGHT_TOP 위젯의 오른쪽 상단에 배치됩니다.
PL_RIGHT_BOTTOM 위젯의 오른쪽 하단에 배치
PL_BOTTOM_RIGHT 위젯 하단 오른쪽에 배치
PL_BOTTOM_LEFT 위젯 하단 왼쪽에 배치됩니다.
PL_LEFT_BOTTOM 위젯의 왼쪽 하단에 배치됩니다.
PL_LEFT_TOP 위젯의 왼쪽 상단에 배치됩니다.

MetricVisualization

측정항목 metric_visualization의 열거형

열거형
METRIC_VISUALIZATION_UNSPECIFIED 미지정 상태입니다.
NUMBER 기본 텍스트 렌더링
BAR 가로 막대 렌더링

CellAlignment

해당 열의 표 셀의 가로 정렬

열거형
CELL_ALIGNMENT_UNSPECIFIED 가로 정렬이 지정되지 않았습니다. 기본 동작으로 대체됩니다. 라벨 값은 왼쪽 정렬됩니다. 숫자 값은 오른쪽으로 정렬됩니다.
LEFT 왼쪽 맞춤
CENTER 가운데 맞춤
RIGHT 오른쪽 맞춤

PieChartType

원형 차트의 유형입니다.

열거형
PIE_CHART_TYPE_UNSPECIFIED 0 값입니다. 유형이 지정되지 않았습니다. 사용하지 마세요.
PIE 원형 유형 PieChart입니다.
DONUT PIE와 유사하지만 DONUT 유형 PieChart에는 가운데에 구멍이 있습니다.

DisplayType

위젯 선택기가 표시되는 방식을 나타내는 유형입니다.

열거형
DISPLAY_TYPE_UNSPECIFIED 디스플레이 유형이 지정되지 않았으며 기본값은 드롭다운입니다.
DROPDOWN 위젯 선택기를 드롭다운으로 렌더링합니다.
TAB 위젯 선택기를 탭 목록으로 렌더링합니다.

비교 연산자

템플릿 변수 값이 일치할 때 평가할 비교 연산자 옵션입니다.

열거형
COMPARATOR_UNSPECIFIED 비교 연산자가 지정되지 않았습니다. 동작의 기본값은 REGEX_FULL_MATCH입니다.
REGEX_FULL_MATCH 템플릿 변수의 값이 지정된 정규식과 일치하면 이 비교 연산자가 있는 조건이 true로 평가됩니다.

ValueType

필터 값의 유형

열거형
VALUE_TYPE_UNSPECIFIED 값 유형이 지정되지 않음
STRING 문자열 유형
STRING_ARRAY 문자열 배열 유형

FilterType

대시보드 필터의 유형

열거형
FILTER_TYPE_UNSPECIFIED 필터 유형이 지정되지 않았습니다. 잘 구성된 요청에서는 유효하지 않습니다.
RESOURCE_LABEL 리소스 라벨 값 필터링
METRIC_LABEL 측정항목 라벨 값 필터링
USER_METADATA_LABEL 사용자 메타데이터 라벨 값으로 필터링
SYSTEM_METADATA_LABEL 시스템 메타데이터 라벨 값 필터링
GROUP 그룹 ID로 필터링
VALUE_ONLY 값이 하나만 포함된 필터입니다. 이 유형의 필터에서는 label_key 필드를 설정하지 않아야 합니다.

EventType

사전 정의된 이벤트 유형입니다.

열거형
EVENT_TYPE_UNSPECIFIED 지정된 이벤트 유형이 없습니다.
GKE_WORKLOAD_DEPLOYMENT GKE 워크로드의 패치/업데이트입니다.
GKE_POD_CRASH GKE 포드의 비정상 종료 이벤트입니다.
GKE_POD_UNSCHEDULABLE GKE 포드의 예약 실패
GKE_CONTAINER_CREATION_FAILED GKE 컨테이너를 만들 수 없습니다.
GKE_CLUSTER_CREATE_DELETE GKE 클러스터 생성/삭제
GKE_CLUSTER_UPDATE GKE 클러스터 업데이트
GKE_NODE_POOL_UPDATE GKE 노드 풀 업데이트
GKE_CLUSTER_AUTOSCALER GKE 클러스터 자동 확장 처리 이벤트입니다.
GKE_POD_AUTOSCALER GKE 포드 자동 확장 처리 이벤트입니다.
VM_TERMINATION 가상 머신 종료
VM_GUEST_OS_ERROR 가상 머신의 게스트 OS 오류
VM_START_FAILED 가상 머신에서 시작 실패
MIG_UPDATE 관리형 인스턴스 그룹 업데이트
MIG_AUTOSCALER 관리형 인스턴스 그룹의 자동 확장 처리기 이벤트입니다.
CLOUD_RUN_DEPLOYMENT Cloud Run 서비스의 새 배포
CLOUD_SQL_FAILOVER Cloud SQL 인스턴스의 장애 조치
CLOUD_SQL_START_STOP Cloud SQL 인스턴스의 시작/중지
CLOUD_SQL_STORAGE Cloud SQL 인스턴스의 스토리지 이벤트입니다.
UPTIME_CHECK_FAILURE Cloud Monitoring 업타임 체크 실패
CLOUD_ALERTING_ALERT Cloud Alerting의 알림
SERVICE_HEALTH_INCIDENT Service Health의 인시던트
SAP_BACKINT SAP Backint용 에이전트 관련 이벤트입니다.
SAP_AVAILABILITY SAP용 에이전트 가용성과 관련된 이벤트입니다.
SAP_OPERATIONS SAP용 에이전트 운영 관련 이벤트입니다.
INTERCONNECT_MAINTENANCE_STARTED Interconnect 유지보수가 시작됨 이벤트입니다.
INTERCONNECT_MAINTENANCE_COMPLETED Interconnect 유지보수 완료 이벤트입니다.
VPN_TRAFFIC_SELECTOR_NARROWING VPN 트래픽 선택기 범위 좁혀짐 이벤트입니다.
VPN_MAINTENANCE VPN 유지보수 이벤트입니다.

도구 주석

도구 주석은 특정 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 사용자에게 확인 메시지를 전송할 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구가 파괴적인 작업을 실행할 수 있습니다. false인 경우 도구는 추가 작업만 실행할 수 있습니다. 기본값은 true입니다.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구가 외부 엔티티의 '오픈 월드'와 상호작용할 수 있습니다. false인 경우 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

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