MCP Tools Reference: monitoring.googleapis.com

도구: get_alert_policy

특정 알림 정책에 관한 정보를 얻기 위한 기본 도구로 사용합니다. 알림 정책은 서비스의 문제에 대한 알림을 받을 조건을 정의합니다. 이는 특정 알림 구성의 세부정보를 이해하는 데 유용합니다.

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

입력 스키마

GetAlertPolicy 요청의 프로토콜입니다.

GetAlertPolicyRequest

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

string

필수 항목입니다. 가져올 알림 정책입니다. 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

출력 스키마

시스템의 특정 측면이 '비정상'으로 간주되는 조건과 이러한 상태를 사람이나 서비스에 알리는 방법에 관한 설명입니다. 알림 정책 개요는 알림 소개를 참고하세요.

AlertPolicy

JSON 표현 
{
  "name": string,
  "displayName": string,
  "documentation": {
    object (Documentation)
  },
  "userLabels": {
    string: string,
    ...
  },
  "conditions": [
    {
      object (Condition)
    }
  ],
  "combiner": enum (ConditionCombinerType),
  "enabled": boolean,
  "validity": {
    object (Status)
  },
  "notificationChannels": [
    string
  ],
  "creationRecord": {
    object (MutationRecord)
  },
  "mutationRecord": {
    object (MutationRecord)
  },
  "alertStrategy": {
    object (AlertStrategy)
  },
  "severity": enum (Severity)
}
필드
name

string

식별자. 정책이 있는 경우 필수입니다. 이 정책의 리소스 이름입니다. 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

[ALERT_POLICY_ID]는 정책이 생성될 때 Cloud Monitoring에 의해 할당됩니다. alertPolicies.create 메서드를 호출할 때는 요청의 일부로 전달되는 알림 정책에 name 필드를 포함하지 마세요.
displayName

string

대시보드, 알림, 인시던트에서 정책을 식별하는 데 사용되는 닉네임 또는 문구입니다. 혼동을 방지하려면 동일한 프로젝트의 여러 정책에 동일한 표시 이름을 사용하지 마세요. 이름은 유니코드 문자 512자로 제한됩니다.

PrometheusQueryLanguageCondition의 display_name 규칙은 '{rule group name}/{alert name}'입니다. 여기서 {rule group name}과 {alert name}은 해당 Prometheus 구성 파일에서 가져와야 합니다. 이 규칙은 적용되지 않습니다. 어떤 경우에도 display_name은 AlertPolicy의 고유 키가 아닙니다.
documentation

object (Documentation)

이 정책과 관련된 알림 및 이슈와 함께 포함되는 문서입니다. 문서에는 응답자가 알림 정책에서 감지된 기본 문제를 이해하고, 완화하고, 에스컬레이션하고, 수정하는 데 도움이 되는 정보를 포함하는 것이 좋습니다. 용량이 제한된 알림 채널에는 이 문서가 표시되지 않을 수 있습니다.
userLabels

map (key: string, value: string)

AlertPolicy 객체를 구성하고 식별하는 데 사용되는 사용자 제공 키/값 데이터입니다.

필드에는 최대 64개의 항목이 포함될 수 있습니다. 각 키와 값은 63개의 유니코드 문자 또는 128바이트 중 더 작은 값으로 제한됩니다. 라벨과 값에는 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 키는 문자로 시작해야 합니다.

Prometheus {alert name}은 유효한 Prometheus 라벨 이름이지만 Prometheus {rule group}은 제한이 없는 UTF-8 문자열입니다. 사용자 라벨 값에 허용되지 않는 문자가 포함될 수 있으므로 사용자 라벨에 그대로 저장할 수 없습니다.

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

object (Condition)

정책의 조건 목록입니다. 조건은 combiner 필드에 따라 AND 또는 OR로 결합됩니다. 결합된 조건이 참으로 평가되면 사고가 생성됩니다. 정책에는 1~6개의 조건이 포함될 수 있습니다. condition_time_series_query_language가 있으면 유일한 condition여야 합니다. condition_monitoring_query_language가 있으면 유일한 condition여야 합니다.
combiner

enum (ConditionCombinerType)

여러 조건의 결과를 결합하여 사고를 열어야 하는지 여부를 결정하는 방법입니다. condition_time_series_query_language가 있으면 COMBINE_UNSPECIFIED이어야 합니다.
enabled

boolean

정책의 사용 설정 여부입니다. 쓰기 시 설정되지 않은 경우 기본 해석은 정책이 사용 설정된 것입니다. 읽기 시 클라이언트는 상태가 채워지지 않은 경우 상태에 관해 어떠한 가정도 해서는 안 됩니다. 필드를 삭제하는 필드 프로젝션이 지정되지 않은 한, 목록 및 가져오기 작업에서 필드가 항상 채워져야 합니다.
validity

object (Status)

알림 정책이 유효하지 않은 이유에 대한 읽기 전용 설명입니다. 이 필드는 알림 정책이 유효하지 않은 경우에만 설정됩니다. 유효하지 않은 알림 정책은 이슈를 생성하지 않습니다.
notificationChannels[]

string

이슈가 열리거나 닫힐 때 또는 이미 열린 이슈에서 새로운 위반이 발생할 때 알림을 전송해야 하는 알림 채널을 식별합니다. 이 배열의 각 요소는 ListNotificationChannels 메서드에서 반환되는 각 NotificationChannel 객체의 name 필드에 해당합니다. 이 필드의 항목 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
creationRecord

object (MutationRecord)

알림 정책 생성에 대한 읽기 전용 기록입니다. 생성 또는 업데이트 호출에 제공된 경우 이 필드는 무시됩니다.
mutationRecord

object (MutationRecord)

알림 정책의 가장 최근 변경사항에 대한 읽기 전용 기록입니다. 생성 또는 업데이트 호출에 제공된 경우 이 필드는 무시됩니다.
alertStrategy

object (AlertStrategy)

이 알림 정책의 알림 채널에 알림이 전송되는 방식을 제어합니다.
severity

enum (Severity)

선택사항입니다. 알림 정책의 심각도는 해당 정책에서 생성된 인시던트가 얼마나 중요한지를 나타냅니다. 심각도 수준은 '사고' 세부정보 페이지와 알림에 표시됩니다.

문서

JSON 표현 
{
  "content": string,
  "mimeType": string,
  "subject": string,
  "links": [
    {
      object (Link)
    }
  ]
}
필드
content

string

mime_type에 따라 해석된 문서의 본문입니다. 콘텐츠는 유니코드 문자 8,192자를 초과할 수 없으며 UTF-8 형식으로 인코딩된 경우 10,240바이트를 초과할 수 없습니다(둘 중 더 작은 값). 이 텍스트는 변수를 사용하여 템플릿화할 수 있습니다.
mimeType

string

content 필드의 형식입니다. 현재는 "text/markdown" 값만 지원됩니다. 자세한 내용은 마크다운을 참고하세요.
subject

string

선택사항입니다. 알림의 제목입니다. 제목은 10,240바이트를 초과할 수 없습니다. 이 정책에 따라 생성된 알림에서 변수 확장 후 제목 줄의 콘텐츠는 최신 UTF-8 문자 경계에서 255바이트 이하로 잘립니다. 255바이트 제한은 이 스레드에서 권장합니다. 이는 일부 서드 파티 티켓팅 제품에서 부과하는 한도이며 데이터베이스에서 텍스트 필드를 VARCHAR(255)로 정의하는 것이 일반적입니다.

제목 줄의 내용은 변수를 사용하여 템플릿화할 수 있습니다. 이 필드가 누락되거나 비어 있으면 기본 제목 줄이 생성됩니다.
links[]

object (Link)

선택사항입니다. 플레이북, 저장소, 기타 리소스와 같은 콘텐츠로 연결되는 링크입니다. 이 필드는 최대 3개의 항목을 포함할 수 있습니다.
JSON 표현 
{
  "displayName": string,
  "url": string
}
필드
displayName

string

링크의 짧은 표시 이름입니다. 표시 이름은 비어 있거나 63자(영문 기준)를 초과해서는 안 됩니다. 예: '플레이북'
url

string

웹페이지의 URL입니다. 경로 또는 쿼리 매개변수에 변수를 사용하여 URL을 템플릿화할 수 있습니다. 변수 확장 전후의 URL 총 길이는 2083자를 초과해서는 안 됩니다. 예: 'https://my_domain.com/playbook?name=${resource.name}'

UserLabelsEntry

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

string
value

string

조건

JSON 표현 
{
  "name": string,
  "displayName": string,

  // Union field condition can be only one of the following:
  "conditionThreshold": {
    object (MetricThreshold)
  },
  "conditionAbsent": {
    object (MetricAbsence)
  },
  "conditionMatchedLog": {
    object (LogMatch)
  },
  "conditionMonitoringQueryLanguage": {
    object (MonitoringQueryLanguageCondition)
  },
  "conditionPrometheusQueryLanguage": {
    object (PrometheusQueryLanguageCondition)
  },
  "conditionSql": {
    object (SqlCondition)
  }
  // End of list of possible types for union field condition.
}
필드
name

string

조건이 있는 경우 필수입니다. 이 조건의 고유한 리소스 이름입니다. 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[POLICY_ID]/conditions/[CONDITION_ID]

[CONDITION_ID]는 새 알림 정책 또는 업데이트된 알림 정책의 일부로 조건이 생성될 때 Cloud Monitoring에 의해 할당됩니다.

alertPolicies.create 메서드를 호출할 때는 요청된 알림 정책의 조건에 name 필드를 포함하지 마세요. Cloud Monitoring은 조건 식별자를 만들어 새 정책에 포함합니다.

alertPolicies.update 메서드를 호출하여 정책을 업데이트할 때 name 조건을 포함하면 기존 조건이 업데이트됩니다. 이름이 없는 조건은 업데이트된 정책에 추가됩니다. 기존 조건은 업데이트되지 않으면 삭제됩니다.

조건 임계값, 기간 또는 트리거 값과 같은 작은 변경만 하는 경우 [CONDITION_ID]를 유지하는 것이 좋습니다. 그렇지 않으면 변경사항을 새 조건으로 처리하고 기존 조건이 삭제되도록 합니다.
displayName

string

대시보드, 알림, 인시던트에서 조건을 식별하는 데 사용되는 짧은 이름 또는 문구입니다. 혼동을 방지하려면 동일한 정책에서 여러 조건에 동일한 표시 이름을 사용하지 마세요.
통합 필드 condition. 다음 조건 유형 중 하나만 지정됩니다. condition은 다음 중 하나여야 합니다.
conditionThreshold

object (MetricThreshold)

시계열을 기준과 비교하는 조건입니다.
conditionAbsent

object (MetricAbsence)

시계열이 새 데이터 포인트를 계속 수신하는지 확인하는 조건입니다.
conditionMatchedLog

object (LogMatch)

지정된 제약 조건과 일치하는 로그 메시지를 확인하는 조건입니다. 설정된 경우 다른 조건이 있을 수 없습니다.
conditionMonitoringQueryLanguage

object (MonitoringQueryLanguageCondition)

Monitoring Query Language를 사용하여 알림을 정의하는 조건입니다.
conditionPrometheusQueryLanguage

object (PrometheusQueryLanguageCondition)

Prometheus 쿼리 언어를 사용하여 알림을 정의하는 조건입니다.
conditionSql

object (SqlCondition)

SQL 쿼리 결과를 주기적으로 평가하는 조건입니다.

MetricThreshold

JSON 표현 
{
  "filter": string,
  "aggregations": [
    {
      object (Aggregation)
    }
  ],
  "denominatorFilter": string,
  "denominatorAggregations": [
    {
      object (Aggregation)
    }
  ],
  "forecastOptions": {
    object (ForecastOptions)
  },
  "comparison": enum (ComparisonType),
  "thresholdValue": number,
  "duration": string,
  "trigger": {
    object (Trigger)
  },
  "evaluationMissingData": enum (EvaluationMissingData)
}
필드
filter

string

필수 항목입니다. 기준점과 비교해야 하는 시계열을 식별하는 필터입니다.

필터는 ListTimeSeries 요청에 지정된 필터와 유사합니다 (이 호출은 검색 / 처리될 시계열을 확인하는 데 유용함). 필터는 측정항목 유형과 리소스 유형을 지정해야 합니다. 선택적으로 리소스 라벨과 측정항목 라벨을 지정할 수 있습니다. 이 필드의 길이는 유니코드 문자 2,048자를 초과할 수 없습니다.
aggregations[]

object (Aggregation)

개별 시계열의 데이터 포인트 정렬과 검색된 시계열을 결합하는 방법을 지정합니다 (예: 각 리소스의 여러 스트림을 각 리소스의 단일 스트림으로 집계하거나 리소스 그룹의 모든 구성원에 걸쳐 스트림을 집계하는 경우). 여러 집계는 지정된 순서대로 적용됩니다.

이 필드는 ListTimeSeries 요청의 필드와 유사합니다. 이 필드를 디버깅할 때는 ListTimeSeries 메서드를 사용하는 것이 좋습니다.
denominatorFilter

string

기준값과 비교할 비율의 분모로 사용해야 하는 시계열을 식별하는 필터입니다. denominator_filter가 지정된 경우 filter 필드로 지정된 시계열이 분자로 사용됩니다.

필터는 측정항목 유형을 지정해야 하며 리소스 유형, 리소스 라벨, 측정항목 라벨에 대한 제한사항을 포함할 수 있습니다. 이 필드의 길이는 유니코드 문자 2048자를 초과할 수 없습니다.
denominatorAggregations[]

object (Aggregation)

denominatorFilter로 선택된 개별 시계열의 데이터 포인트 정렬과 검색된 시계열을 결합하는 방법을 지정합니다 (예: 각 리소스의 여러 스트림을 각 리소스의 단일 스트림으로 집계하거나 리소스 그룹의 모든 구성원에 걸쳐 스트림을 집계하는 경우).

비율을 계산할 때 aggregations 및 denominator_aggregations 필드는 동일한 정렬 기간을 사용해야 하며 동일한 주기성과 라벨이 있는 시계열을 생성해야 합니다.
forecastOptions

object (ForecastOptions)

이 필드가 있으면 MetricThreshold 조건은 시계열이 forecast_horizon 내에 기준점을 위반할 것으로 예측되는지 여부를 예측합니다. 이 필드가 설정되지 않으면 MetricThreshold에서 시계열의 현재 값을 기준과 비교합니다.
comparison

enum (ComparisonType)

시계열 (filter 및 aggregation로 표시됨)과 기준점 (threshold_value로 표시됨) 사이에 적용할 비교입니다. 비교는 각 시계열에 적용되며, 시계열은 왼쪽에 있고 기준점은 오른쪽에 있습니다.

현재 COMPARISON_LT 및 COMPARISON_GT만 지원됩니다.
thresholdValue

number

시계열과 비교할 값입니다.
duration

string (Duration format)

필수 항목입니다. 시계열이 실패로 간주되려면 임곗값을 위반해야 하는 시간입니다. 현재는 분의 배수인 값(예: 0, 60, 120, 300초)만 지원됩니다. 잘못된 값이 제공되면 오류가 반환됩니다. 기간을 선택할 때는 기본 시계열 데이터의 빈도 (aggregations 필드에 지정된 정렬의 영향을 받을 수도 있음)를 염두에 두는 것이 좋습니다. 단일 이상치로 인해 가짜 알림이 생성되지 않을 만큼 길지만 비정상 상태가 빠르게 감지되고 알림이 전송될 만큼 짧은 기간이 적절합니다.

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

object (Trigger)

조건이 트리거되려면 비교가 유지되어야 하는 시계열의 수/비율입니다. 지정하지 않으면 filter 및 aggregations로 식별된 시계열 중 하나 또는 denominator_filter 및 denominator_aggregations가 지정된 경우 비율에 대한 비교가 참이면 조건이 트리거됩니다.
evaluationMissingData

enum (EvaluationMissingData)

데이터 도착이 중지될 때 측정항목 기준점 조건을 평가하는 방법을 결정하는 조건 컨트롤입니다. 이 제어를 사용하려면 duration 필드의 값이 60초 이상이어야 합니다.

집계

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

ForecastOptions

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

string (Duration format)

필수 항목입니다. 시계열이 기준점을 위반할지 예측할 미래 기간입니다. 예측값이 임곗값을 위반하는 것으로 확인되고 구성된 duration에 대해 이루어진 모든 예측에서 위반이 관찰되면 시계열이 실패한 것으로 간주됩니다. 예측 범위는 1시간에서 60시간 사이입니다.

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

트리거

JSON 표현 
{

  // Union field type can be only one of the following:
  "count": integer,
  "percent": number
  // End of list of possible types for union field type.
}
필드
통합 필드 type. 트리거 유형입니다. type은 다음 중 하나여야 합니다.
count

integer

조건이 트리거되려면 술어를 실패해야 하는 시계열의 절대 수입니다.
percent

number

조건이 트리거되려면 술어를 실패해야 하는 시계열의 비율입니다.

MetricAbsence

JSON 표현 
{
  "filter": string,
  "aggregations": [
    {
      object (Aggregation)
    }
  ],
  "duration": string,
  "trigger": {
    object (Trigger)
  }
}
필드
filter

string

필수 항목입니다. 기준점과 비교해야 하는 시계열을 식별하는 필터입니다.

필터는 ListTimeSeries 요청에 지정된 필터와 유사합니다 (이 호출은 검색 / 처리될 시계열을 확인하는 데 유용함). 필터는 측정항목 유형과 리소스 유형을 지정해야 합니다. 선택적으로 리소스 라벨과 측정항목 라벨을 지정할 수 있습니다. 이 필드의 길이는 유니코드 문자 2,048자를 초과할 수 없습니다.
aggregations[]

object (Aggregation)

개별 시계열의 데이터 포인트 정렬과 검색된 시계열을 결합하는 방법을 지정합니다 (예: 각 리소스의 여러 스트림을 각 리소스의 단일 스트림으로 집계하거나 리소스 그룹의 모든 구성원에 걸쳐 스트림을 집계하는 경우). 여러 집계는 지정된 순서대로 적용됩니다.

이 필드는 ListTimeSeries 요청의 필드와 유사합니다. 이 필드를 디버깅할 때는 ListTimeSeries 메서드를 사용하는 것이 좋습니다.
duration

string (Duration format)

필수 항목입니다. 시계열이 실패로 간주되려면 새 데이터를 보고하지 않아야 하는 시간입니다. 이 필드의 최솟값은 120초입니다. 분 단위의 배수인 더 큰 값(예: 240초 또는 300초)이 지원됩니다. 잘못된 값이 제공되면 오류가 반환됩니다.

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

object (Trigger)

조건이 트리거되려면 비교가 유지되어야 하는 시계열의 수/비율입니다. 지정하지 않으면 filter 및 aggregations로 식별된 시계열 중 하나라도 비교가 참이면 조건이 트리거됩니다.

LogMatch

JSON 표현 
{
  "filter": string,
  "labelExtractors": {
    string: string,
    ...
  }
}
필드
filter

string

필수 항목입니다. 로그 기반 필터입니다. 이 필터를 구성하는 방법은 고급 로그 쿼리를 참고하세요.
labelExtractors

map (key: string, value: string)

선택사항입니다. 라벨 키에서 추출기 표현식으로의 맵입니다. 이 라벨 키의 값을 추출하는 데 사용됩니다. 이 맵의 각 항목은 filter와 일치하는 로그 항목에서 데이터를 추출하는 방법을 지정합니다. 추출된 값의 각 조합은 알림을 트리거하기 위한 별도의 규칙으로 취급됩니다. 라벨 키와 해당 값은 이 조건에 의해 생성된 알림에서 사용할 수 있습니다.

구문 및 예시는 로그 기반 측정항목 valueExtractor에 관한 문서를 참고하세요.

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

LabelExtractorsEntry

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

string
value

string

MonitoringQueryLanguageCondition

JSON 표현 
{
  "query": string,
  "duration": string,
  "trigger": {
    object (Trigger)
  },
  "evaluationMissingData": enum (EvaluationMissingData)
}
필드
query

string

불리언 스트림을 출력하는 모니터링 쿼리 언어 쿼리
duration

string (Duration format)

선택사항입니다. 시계열이 실패로 간주되려면 임곗값을 위반해야 하는 시간입니다. 현재는 분의 배수인 값(예: 0, 60, 120, 300초)만 지원됩니다. 잘못된 값이 제공되면 오류가 반환됩니다. 기간을 선택할 때는 기본 시계열 데이터의 빈도 (aggregations 필드에 지정된 정렬의 영향을 받을 수도 있음)를 염두에 두는 것이 좋습니다. 단일 이상치로 인해 가짜 알림이 생성되지 않을 만큼 길지만 비정상 상태가 빠르게 감지되고 알림이 전송될 만큼 짧은 기간이 적절합니다. 기본값은 0입니다.

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

object (Trigger)

조건이 트리거되려면 비교가 유지되어야 하는 시계열의 수/비율입니다. 지정하지 않으면 filter 및 aggregations로 식별된 시계열 중 하나 또는 denominator_filter 및 denominator_aggregations가 지정된 경우 비율에 대한 비교가 참이면 조건이 트리거됩니다.
evaluationMissingData

enum (EvaluationMissingData)

데이터 도착이 중지될 때 측정항목 기준점 조건을 평가하는 방법을 결정하는 조건 컨트롤입니다.

PrometheusQueryLanguageCondition

JSON 표현 
{
  "query": string,
  "duration": string,
  "evaluationInterval": string,
  "labels": {
    string: string,
    ...
  },
  "ruleGroup": string,
  "alertRule": string,
  "disableMetricValidation": boolean
}
필드
query

string

필수 항목입니다. 평가할 PromQL 표현식입니다. 이 표현식은 평가 주기마다 현재 시간에 평가되며, 결과로 생성된 모든 시계열은 대기 중/실행 알림이 됩니다. 이 필드는 비워 둘 수 없습니다.
duration

string (Duration format)

선택사항입니다. 이 시간 동안 PromQL 표현식이 '참'으로 평가되었으면 알림이 실행되는 것으로 간주됩니다. PromQL 표현식이 충분히 오랫동안 'true'로 평가되지 않은 알림은 대기 중인 것으로 간주됩니다. 음수가 아닌 기간이거나 누락되어야 합니다. 이 필드는 선택사항입니다. 기본값은 0입니다.

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

string (Duration format)

선택사항입니다. 이 규칙을 평가해야 하는 빈도입니다. 30초의 양수 배수여야 합니다. 이 필드는 선택사항입니다. 기본값은 30초입니다. 이 PrometheusQueryLanguageCondition이 Prometheus 알림 규칙에서 생성된 경우 이 값은 묶는 규칙 그룹에서 가져와야 합니다.

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

map (key: string, value: string)

선택사항입니다. PromQL 쿼리 결과에 추가하거나 덮어쓸 라벨입니다. 라벨 이름은 유효해야 합니다. 라벨 값은 변수를 사용하여 템플릿화할 수 있습니다. 사용 가능한 변수 이름은 PromQL 결과의 라벨 이름뿐이며, 여기에는 '__name__'과 'value'가 포함됩니다. 'labels'가 비어 있을 수 있습니다.

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

string

선택사항입니다. 해당 Prometheus 구성 파일에 있는 이 알림의 규칙 그룹 이름입니다.

일부 외부 도구에서는 원래 Prometheus 구성 파일을 참조하기 위해 이 필드가 올바르게 채워져야 할 수 있습니다. 규칙 그룹 이름과 알림 이름은 향후 규칙 그룹의 정의가 변경될 경우 관련 AlertPolicies를 업데이트하는 데 필요합니다.

이 필드는 선택사항입니다. 이 필드가 비어 있지 않으면 유효한 UTF-8 문자열을 포함해야 합니다. 이 필드의 길이는 유니코드 문자 2048자를 초과할 수 없습니다.
alertRule

string

선택사항입니다. 해당 Prometheus 구성 파일에 있는 이 알림의 알림 규칙 이름입니다.

일부 외부 도구에서는 원래 Prometheus 구성 파일을 참조하기 위해 이 필드가 올바르게 채워져야 할 수 있습니다. 규칙 그룹 이름과 알림 이름은 향후 규칙 그룹의 정의가 변경될 경우 관련 AlertPolicies를 업데이트하는 데 필요합니다.

이 필드는 선택사항입니다. 이 필드가 비어 있지 않으면 유효한 Prometheus 라벨 이름이어야 합니다. 이 필드의 길이는 유니코드 문자 2048자를 초과할 수 없습니다.
disableMetricValidation

boolean

선택사항입니다. 이 조건에 대해 측정항목 존재 여부 유효성 검사를 사용 중지할지 여부입니다.

이를 통해 아직 존재하지 않는 측정항목에 알림 정책을 정의하여 Terraform을 사용한 알림 정책 구성과 같은 고급 고객 워크플로를 개선할 수 있습니다.

monitoring.alertPolicyViewer 역할이 있는 사용자는 알림 정책 조건에서 존재하지 않는 측정항목의 이름을 볼 수 있습니다.

LabelsEntry

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

string
value

string

SqlCondition

JSON 표현 
{
  "query": string,

  // Union field schedule can be only one of the following:
  "minutes": {
    object (Minutes)
  },
  "hourly": {
    object (Hourly)
  },
  "daily": {
    object (Daily)
  }
  // End of list of possible types for union field schedule.

  // Union field evaluate can be only one of the following:
  "rowCountTest": {
    object (RowCountTest)
  },
  "booleanTest": {
    object (BooleanTest)
  }
  // End of list of possible types for union field evaluate.
}
필드
query

string

필수 항목입니다. 실행할 로그 애널리틱스 SQL 쿼리(문자열)입니다. 쿼리는 필수 모양을 준수해야 합니다. 특히 쿼리는 시간별로 입력을 필터링하려고 하면 안 됩니다. 쿼리가 마지막으로 실행된 이후 수신된 모든 행을 쿼리가 수신하도록 입력이 필터링되도록 필터가 자동으로 적용됩니다.

예를 들어 다음 쿼리는 HTTP 요청이 포함된 모든 로그 항목을 추출합니다.

SELECT
  timestamp, log_name, severity, http_request, resource, labels
FROM
  my-project.global._Default._AllLogs
WHERE
  http_request IS NOT NULL
통합 필드 schedule. 일정은 쿼리를 실행해야 하는 빈도를 나타냅니다. schedule은 다음 중 하나여야 합니다.
minutes

object (Minutes)

일정 간격으로 쿼리가 실행되도록 예약합니다.
hourly

object (Hourly)

일정 간격으로 쿼리가 실행되도록 예약합니다.
daily

object (Daily)

며칠마다 쿼리가 실행되도록 예약합니다.
통합 필드 evaluate. SQL 결과 집합에 대해 실행할 테스트입니다. evaluate은 다음 중 하나여야 합니다.
rowCountTest

object (RowCountTest)

기준에 대해 행 수를 테스트합니다.
booleanTest

object (BooleanTest)

표시된 열의 불리언 값을 테스트합니다.

분

JSON 표현 
{
  "periodicity": integer
}
필드
periodicity

integer

필수 항목입니다. 실행 간 시간(분)입니다. 간격은 5분 이상 1440분 이하여야 합니다.

매시간

JSON 표현 
{
  "periodicity": integer,

  // Union field _minute_offset can be only one of the following:
  "minuteOffset": integer
  // End of list of possible types for union field _minute_offset.
}
필드
periodicity

integer

필수 항목입니다. 실행 간 시간(시간)입니다. 1시간 이상, 48시간 이하여야 합니다.

통합 필드 _minute_offset.

_minute_offset는 다음 중 하나여야 합니다.
minuteOffset

integer

선택사항입니다. 쿼리를 실행할 시간 (UTC) 이후의 분 수입니다. 0분 이상, 59분 이하여야 합니다. 지정하지 않으면 임의 오프셋이 사용됩니다.

매일

JSON 표현 
{
  "periodicity": integer,
  "executionTime": {
    object (TimeOfDay)
  }
}
필드
periodicity

integer

필수 항목입니다. 실행 간의 일수입니다. 1일 이상 31일 이하여야 합니다.
executionTime

object (TimeOfDay)

선택사항입니다. 쿼리를 실행해야 하는 시간 (UTC)입니다. 지정하지 않으면 서버에서 임의의 시간을 선택하고 매일 같은 시간에 쿼리를 실행합니다.

TimeOfDay

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

integer

24시간 형식의 시간입니다. 0 이상이어야 하며 일반적으로 23 이하여야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
minutes

integer

시간의 분입니다. 0 이상 59 이하여야 합니다.
seconds

integer

분의 초입니다. 0 이상이어야 하며 일반적으로 59 이하여야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos

integer

나노초 단위의 초수입니다. 0 이상, 999,999,999 이하여야 합니다.

RowCountTest

JSON 표현 
{
  "comparison": enum (ComparisonType),
  "threshold": string
}
필드
comparison

enum (ComparisonType)

필수 항목입니다. 쿼리에서 반환된 행 수와 기준값 사이에 적용할 비교입니다.
threshold

string (int64 format)

필수 항목입니다. 행 수를 비교할 값입니다.

BooleanTest

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

string

필수 항목입니다. 불리언 값을 포함하는 열의 이름입니다. 행의 값이 NULL이면 해당 행은 무시됩니다.

BoolValue

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

boolean

불리언 값입니다.

상태

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" }

모두

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 인코딩 문자열입니다.

MutationRecord

JSON 표현 
{
  "mutateTime": string,
  "mutatedBy": string
}
필드
mutateTime

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

string

변경을 수행하는 사용자의 이메일 주소입니다.

타임스탬프

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

AlertStrategy

JSON 표현 
{
  "notificationRateLimit": {
    object (NotificationRateLimit)
  },
  "notificationPrompts": [
    enum (NotificationPrompt)
  ],
  "autoClose": string,
  "notificationChannelStrategy": [
    {
      object (NotificationChannelStrategy)
    }
  ]
}
필드
notificationRateLimit

object (NotificationRateLimit)

로그 기반 알림 정책(LogMatch 조건이 있는 정책)에 필요합니다.

이 한도는 LogMatch 조건이 없는 알림 정책에는 적용되지 않습니다.
notificationPrompts[]

enum (NotificationPrompt)

로그 기반 알림 정책의 경우 알림 프롬프트는 항상 [OPENED]입니다. 로그 기반이 아닌 알림 정책의 경우 알림 메시지는 [OPENED] 또는 [OPENED, CLOSED]일 수 있습니다.
autoClose

string (Duration format)

활성 상태였던 알림 정책에 이 기간 동안 데이터가 없으면 미해결 이슈가 모두 닫힙니다.

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

object (NotificationChannelStrategy)

채널별로 알림이 전송되는 방식을 제어합니다.

NotificationRateLimit

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

string (Duration format)

period당 알림은 하나만 표시됩니다.

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

NotificationChannelStrategy

JSON 표현 
{
  "notificationChannelNames": [
    string
  ],
  "renotifyInterval": string
}
필드
notificationChannelNames[]

string

이 설정이 적용되는 알림 채널의 전체 REST 리소스 이름입니다. 각각은 이 AlertPolicy의 notification_channels 필드에서 참조되는 NotificationChannel 객체 중 하나의 name 필드에 해당합니다. 형식은 다음과 같습니다.

projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
renotifyInterval

string (Duration format)

미해결 이슈에 대한 리마인더 알림을 전송할 빈도입니다. 값은 30분에서 24시간 사이여야 합니다.

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

정렬기

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

ComparisonType

left 및 right이라는 두 인수에 순서 관계를 지정합니다.

열거형
COMPARISON_UNSPECIFIED 순서 지정 관계가 지정되지 않았습니다.
COMPARISON_GT 왼쪽 인수가 오른쪽 인수보다 크면 true입니다.
COMPARISON_GE 왼쪽 인수가 오른쪽 인수보다 크거나 같으면 true입니다.
COMPARISON_LT 왼쪽 인수가 오른쪽 인수보다 작으면 True입니다.
COMPARISON_LE 왼쪽 인수가 오른쪽 인수보다 작거나 같은 경우 true입니다.
COMPARISON_EQ 왼쪽 인수가 오른쪽 인수와 같으면 true입니다.
COMPARISON_NE 왼쪽 인수가 오른쪽 인수와 같지 않으면 true입니다.

EvaluationMissingData

데이터 도착이 중지될 때 측정항목 기준점 조건을 평가하는 방법을 결정하는 조건 컨트롤입니다. 이 설정은 측정항목 누락 정책에 영향을 미치지 않습니다.

열거형
EVALUATION_MISSING_DATA_UNSPECIFIED 지정되지 않은 평가 누락 데이터 옵션입니다. EVALUATION_MISSING_DATA_NO_OP와 동일합니다.
EVALUATION_MISSING_DATA_INACTIVE 조건을 평가할 데이터가 없으면 조건을 false로 평가합니다.
EVALUATION_MISSING_DATA_ACTIVE 조건을 평가할 데이터가 없으면 조건을 true로 평가합니다.
EVALUATION_MISSING_DATA_NO_OP 데이터가 없으면 조건을 어떤 값으로도 평가하지 마세요.

ConditionCombinerType

조건을 결합하는 연산자입니다.

열거형
COMBINE_UNSPECIFIED 지정되지 않은 결합기입니다.
AND 논리 AND 연산자를 사용하여 조건을 결합합니다. 모든 조건이 동시에 충족되는 경우에만 사고가 생성됩니다. 이 결합기는 완전히 다른 리소스에서 충족되더라도 모든 조건이 충족되면 충족됩니다.
OR 논리 OR 연산자를 사용하여 조건을 결합합니다. 나열된 조건 중 하나라도 충족되면 사고가 생성됩니다.
AND_WITH_MATCHING_RESOURCE 논리 AND 연산자를 사용하여 조건을 결합합니다. 하지만 일반 AND 옵션과 달리 하나 이상의 리소스에서 모든 조건이 동시에 충족되는 경우에만 인시던트가 생성됩니다.

NotificationPrompt

알림이 전송되는 시점을 제어합니다.

열거형
NOTIFICATION_PROMPT_UNSPECIFIED 지정된 전략이 없습니다. 오류로 처리됩니다.
OPENED 사고가 개설될 때 알림을 받습니다.
CLOSED 사고가 종료될 때 알림을 받습니다.

심각도

알림 정책의 가능한 심각도 수준을 열거합니다.

열거형
SEVERITY_UNSPECIFIED 심각도가 지정되지 않았습니다. 기본값입니다.
CRITICAL 심각도 수준이 가장 높습니다. 문제가 심각한 손상이나 다운타임을 일으킬 수 있는 경우에 사용합니다.
ERROR 중간 심각도 수준입니다. 문제가 경미한 손상이나 다운타임을 일으킬 수 있는 경우에 사용합니다.
WARNING 가장 낮은 심각도 수준입니다. 이 옵션은 문제가 손상이나 다운타임을 유발하지는 않지만 향후 문제로 이어질 수 있는 경우에 사용하세요.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌