MetricDefinition

사용자 정의 이름, 기본 측정항목 유형, 선택적 필터를 비롯하여 쿼리할 특정 측정항목을 정의합니다.

JSON 표현
{
  "name": string,
  "baseMetric": {
    object (BaseMetric)
  },
  "filter": string
}
필드
name

string

필수 항목입니다. 이 측정항목의 사용자 정의 이름입니다. 이 이름은 응답에서 이 측정항목 값의 키로 사용됩니다.

baseMetric

object (BaseMetric)

필수 항목입니다. 쿼리할 기본 측정항목입니다.

filter

string

선택사항입니다. 측정항목에 적용할 선택적 필터입니다.

BaseMetric

쿼리할 기본 측정항목을 지정합니다. 사전 정의된 표준 측정항목 또는 사용자 정의 맞춤 측정항목일 수 있습니다 (향후 지원되는 경우).

JSON 표현
{

  "standardMetric": enum (StandardMetric)
}
필드
통합 필드 metric. 쿼리할 특정 측정항목입니다. metric은 다음 중 하나여야 합니다.
standardMetric

enum (StandardMetric)

사전 정의된 표준 측정항목입니다.

StandardMetric

쿼리할 수 있는 사전 정의된 표준 측정항목을 열거합니다.

열거형
STANDARD_METRIC_UNSPECIFIED 지정되지 않은 표준 측정항목입니다. 이 값은 직접 사용해서는 안 됩니다.
FEEDBACK_LOOP_ID

피드백 루프 (FBL) ID의 사전 정의된 측정항목입니다. filter 필드는 집계 키 유형 선택을 지원합니다. 지원되는 형식: aggregation_key_type = "".

지원되는 값:

  • FROM_HEADER: (기본값) 측정항목에는 요청된 도메인과 일치하는 From: 헤더 도메인이 있는 메시지가 포함됩니다.
  • ALL_DKIM: 측정항목에는 요청된 도메인과 일치하는 서명된 DKIM 도메인 중 하나가 있는 메시지가 포함됩니다.
FEEDBACK_LOOP_SPAM_RATE

피드백 루프 (FBL) 스팸 비율의 사전 정의된 측정항목입니다. filter 필드에는 feedback_loop_id가 필요하며 선택적으로 aggregation_key_type을 허용합니다. 지원되는 형식은 다음과 같습니다.

  • feedback_loop_id = ""
  • feedback_loop_id = "" AND aggregation_key_type = ""

aggregation_key_type을 생략하면 기본적으로 FROM_HEADER가 됩니다.

지원되는 값:

  • FROM_HEADER: (기본값) 측정항목에는 요청된 도메인과 일치하는 From: 헤더 도메인이 있는 메시지가 포함됩니다.
  • ALL_DKIM: 측정항목에는 요청된 도메인과 일치하는 서명된 DKIM 도메인 중 하나가 있는 메시지가 포함됩니다.
SPAM_RATE 스팸 비율의 사전 정의된 측정항목입니다.
AUTH_SUCCESS_RATE 인증 메커니즘 (DKIM, SPF, DMARC)의 성공률입니다. 필터는 auth_type = "" 유형이어야 합니다. 여기서 는 [spf, dkim, dmarc]중 하나입니다.
TLS_ENCRYPTION_MESSAGE_COUNT 전송 중에 TLS로 암호화된 메시지의 비율입니다. 필터는 traffic_direction = "" 유형이어야 합니다. 여기서 는 [inbound, outbound]중 하나입니다.
TLS_ENCRYPTION_RATE 전송 중에 TLS로 암호화된 메시지의 비율입니다. 필터는 traffic_direction = "" 유형이어야 합니다. 여기서 는 [inbound, outbound]중 하나입니다.
DELIVERY_ERROR_COUNT

발생한 전송 오류의 총 개수입니다 (일시적 또는 영구적 거부). filter 필드는 제한된 구문을 지원합니다. 지원되는 형식은 다음과 같습니다.

  • 비어 있음: 필터가 적용되지 않습니다.
  • error_type = ""
  • error_type = "" AND error_reason = ""

빈 필터가 제공되면 측정항목이 모든 오류 유형 및 사유에 걸쳐 집계됩니다. error_type만 지정되면 측정항목이 해당 유형의 모든 사유에 걸쳐 집계됩니다.

지원되는 값:

  • reject
  • temp_fail

지원되는 값은 에 따라 다릅니다.

  • 'reject'의 경우: [bad_attachment, bad_or_missing_ptr_record, ip_in_rbls, low_domain_reputation, low_ip_reputation, spammy_content, stamp_policy_error, other]
  • 'temp_fail'의 경우: [anomalous_traffic_pattern, other]
DELIVERY_ERROR_RATE

지정된 전송 오류 유형의 전송 오류율입니다. filter 필드는 제한된 구문을 지원합니다. 지원되는 형식은 다음과 같습니다.

  • 비어 있음: 필터가 적용되지 않습니다.
  • error_type = ""
  • error_type = "" AND error_reason = ""

빈 필터가 제공되면 측정항목이 모든 오류 유형 및 사유에 걸쳐 집계됩니다. error_type만 지정되면 측정항목이 해당 유형의 모든 사유에 걸쳐 집계됩니다.

지원되는 값:

  • reject
  • temp_fail

지원되는 값은 에 따라 다릅니다.

  • 'reject'의 경우: [bad_attachment, bad_or_missing_ptr_record, ip_in_rbls, low_domain_reputation, low_ip_reputation, spammy_content, stamp_policy_error, other]
  • 'temp_fail'의 경우: [anomalous_traffic_pattern, other]