MetricDefinition

Menentukan metrik tertentu yang akan dikueri, termasuk nama yang ditentukan pengguna, jenis metrik dasar, dan filter opsional.

Representasi JSON 
{
  "name": string,
  "baseMetric": {
    object (BaseMetric)
  },
  "filter": string
}
Kolom
name

string

Wajib. Nama yang ditentukan pengguna untuk metrik ini. Nama ini akan digunakan sebagai kunci untuk nilai metrik ini dalam respons.
baseMetric

object (BaseMetric)

Wajib. Metrik pokok yang akan dikueri.
filter

string

Opsional. Filter opsional yang akan diterapkan ke metrik.

BaseMetric

Menentukan metrik dasar yang akan dikueri, yang dapat berupa metrik standar bawaan atau metrik kustom yang ditentukan pengguna (jika didukung pada masa mendatang).

Representasi JSON 
{

  "standardMetric": enum (StandardMetric)
}
Kolom
Kolom union metric. Metrik spesifik yang akan dikueri. metric hanya dapat berupa salah satu dari berikut:
standardMetric

enum (StandardMetric)

Metrik standar yang telah ditentukan sebelumnya.

StandardMetric

Mencantumkan metrik standar yang telah ditentukan sebelumnya yang dapat dikueri.

Enum
STANDARD_METRIC_UNSPECIFIED Metrik standar tidak ditentukan. Nilai ini tidak boleh digunakan secara langsung.
FEEDBACK_LOOP_ID

ID metrik standar untuk Feedback Loop (FBL). Kolom filter mendukung pemilihan jenis kunci agregasi. Format yang didukung: aggregation_key_type = "".

Nilai yang didukung:

  • FROM_HEADER: (Default) Metrik mencakup pesan dengan domain header Dari: yang cocok dengan domain yang diminta.
  • ALL_DKIM: Metrik ini mencakup pesan dengan salah satu domain DKIM bertanda tangan yang cocok dengan domain yang diminta.
FEEDBACK_LOOP_SPAM_RATE

Metrik standar untuk rasio spam Feedback Loop (FBL). Kolom filter memerlukan feedback_loop_id dan secara opsional menerima aggregation_key_type. Format yang didukung adalah:

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

Jika aggregation_key_type dihilangkan, nilai defaultnya adalah FROM_HEADER.

Nilai yang didukung:

  • FROM_HEADER: (Default) Metrik mencakup pesan dengan domain header Dari: yang cocok dengan domain yang diminta.
  • ALL_DKIM: Metrik ini mencakup pesan dengan salah satu domain DKIM bertanda tangan yang cocok dengan domain yang diminta.
SPAM_RATE Metrik yang telah ditentukan untuk rasio spam.
AUTH_SUCCESS_RATE Tingkat keberhasilan mekanisme autentikasi (DKIM, SPF, DMARC). Filter harus berjenis auth_type = "" dengan adalah salah satu dari: [spf, dkim, dmarc]
TLS_ENCRYPTION_MESSAGE_COUNT Filter laju pesan yang dienkripsi TLS saat transit harus berjenis traffic_direction = "" dengan adalah salah satu dari: [inbound, outbound]
TLS_ENCRYPTION_RATE Filter laju pesan yang dienkripsi TLS saat transit harus berjenis traffic_direction = "" dengan adalah salah satu dari: [inbound, outbound]
DELIVERY_ERROR_COUNT

Jumlah total error pengiriman yang terjadi (penolakan sementara atau permanen). Kolom filter mendukung sintaksis terbatas. Format yang didukung adalah:

  • Kosong: Tidak ada filter yang diterapkan.
  • error_type = ""
  • error_type = "" AND error_reason = ""

Jika filter kosong diberikan, metrik akan digabungkan di semua jenis dan alasan error. Jika hanya error_type yang ditentukan, metrik akan diagregasi di semua alasan untuk jenis tersebut.

Nilai yang didukung:

  • tolak
  • temp_fail

Nilai yang didukung bergantung pada :

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

Tingkat error pengiriman untuk jenis error pengiriman yang ditentukan. Kolom filter mendukung sintaksis terbatas. Format yang didukung adalah:

  • Kosong: Tidak ada filter yang diterapkan.
  • error_type = ""
  • error_type = "" AND error_reason = ""

Jika filter kosong diberikan, metrik akan digabungkan di semua jenis dan alasan error. Jika hanya error_type yang ditentukan, metrik akan diagregasi di semua alasan untuk jenis tersebut.

Nilai yang didukung:

  • tolak
  • temp_fail

Nilai yang didukung bergantung pada :

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