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: (기본값) 측정항목에 요청된 도메인과 일치하는 보낸사람: 헤더 도메인이 있는 메일이 포함됩니다.
  • 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: (기본값) 측정항목에 요청된 도메인과 일치하는 보낸사람: 헤더 도메인이 있는 메일이 포함됩니다.
  • 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 필드는 제한된 구문을 지원합니다. 지원되는 형식은 다음과 같습니다.

  • Empty: 필터 없음
  • 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 필드는 제한된 구문을 지원합니다. 지원되는 형식은 다음과 같습니다.

  • Empty: 필터 없음
  • 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]