MetricDefinition

কোয়েরি করার জন্য একটি নির্দিষ্ট মেট্রিক নির্ধারণ করে, যার মধ্যে ব্যবহারকারী-নির্ধারিত নাম, মূল মেট্রিকের ধরন এবং ঐচ্ছিক ফিল্টার অন্তর্ভুক্ত থাকে।

JSON উপস্থাপনা
{
  "name": string,
  "baseMetric": {
    object (BaseMetric)
  },
  "filter": string
}
ক্ষেত্র
name

string

আবশ্যক। এই মেট্রিকের জন্য ব্যবহারকারী-নির্ধারিত নাম। এই নামটি রেসপন্সে মেট্রিকটির ভ্যালুর কী (key) হিসেবে ব্যবহৃত হবে।

baseMetric

object ( BaseMetric )

প্রয়োজনীয়। যে মূল মেট্রিকটি সম্পর্কে জিজ্ঞাসা করতে হবে।

filter

string

ঐচ্ছিক। মেট্রিকটিতে প্রয়োগ করার জন্য ঐচ্ছিক ফিল্টারসমূহ।

বেসমেট্রিক

কোয়েরি করার জন্য মূল মেট্রিক নির্দিষ্ট করে, যা একটি পূর্বনির্ধারিত স্ট্যান্ডার্ড মেট্রিক অথবা ব্যবহারকারী-সংজ্ঞায়িত কাস্টম মেট্রিক (ভবিষ্যতে সমর্থিত হলে) হতে পারে।

JSON উপস্থাপনা
{

  "standardMetric": enum (StandardMetric)
}
ক্ষেত্র
ইউনিয়ন ফিল্ড metric । যে নির্দিষ্ট মেট্রিকটি কোয়েরি করতে হবে। metric নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
standardMetric

enum ( StandardMetric )

একটি পূর্বনির্ধারিত আদর্শ পরিমাপ।

স্ট্যান্ডার্ডমেট্রিক

পূর্বনির্ধারিত স্ট্যান্ডার্ড মেট্রিকগুলোর তালিকা দেয় যেগুলো কোয়েরি করা যেতে পারে।

এনাম
STANDARD_METRIC_UNSPECIFIED অনির্দিষ্ট প্রমিত মেট্রিক। এই মানটি সরাসরি ব্যবহার করা উচিত নয়।
FEEDBACK_LOOP_ID

ফিডব্যাক লুপ (FBL) আইডির জন্য পূর্বনির্ধারিত মেট্রিক। 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 = " " এবং 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 = " টাইপের হতে হবে যেখানে নিম্নলিখিতগুলির মধ্যে একটি: [অন্তঃগামী, বহির্গামী]
TLS_ENCRYPTION_RATE ট্রানজিটে TLS এনক্রিপ্টেড মেসেজের হার ফিল্টার অবশ্যই traffic_direction = " টাইপের হতে হবে যেখানে নিম্নলিখিতগুলির মধ্যে একটি: [অন্তঃগামী, বহির্গামী]
DELIVERY_ERROR_COUNT

ডেলিভারিতে মোট যতগুলো ত্রুটি পাওয়া গেছে (অস্থায়ী বা স্থায়ী বাতিল)। filter ফিল্ডটি একটি সীমিত সিনট্যাক্স সমর্থন করে। সমর্থিত ফরম্যাটগুলো হলো:

  • খালি: কোনো ফিল্টার প্রয়োগ করা হয়নি।
  • error_type = " "
  • error_type = " " এবং error_reason = " "

যদি একটি খালি ফিল্টার প্রদান করা হয়, তাহলে মেট্রিকটি সমস্ত ত্রুটির ধরণ এবং কারণ জুড়ে একত্রিত করা হবে। যদি শুধুমাত্র error_type নির্দিষ্ট করা হয়, তাহলে মেট্রিকটি সেই ধরণের সমস্ত কারণ জুড়ে একত্রিত করা হবে।

সমর্থিত মান:

  • প্রত্যাখ্যান করুন
  • টেম্প_ফেল

সমর্থিত মান নির্ভর করে :

  • 'প্রত্যাখ্যান'-এর জন্য: [খারাপ সংযুক্তি, খারাপ বা অনুপস্থিত পিটিআর রেকর্ড, আরবিএলএস-এ আইপি, কম ডোমেইন খ্যাতি, কম আইপি খ্যাতি, স্প্যামি বিষয়বস্তু, স্ট্যাম্প নীতি ত্রুটি, অন্যান্য]
  • 'temp_fail'-এর জন্য: [অস্বাভাবিক ট্র্যাফিক প্যাটার্ন, অন্যান্য]
DELIVERY_ERROR_RATE

নির্দিষ্ট ডেলিভারি ত্রুটির ধরনের জন্য ডেলিভারি ত্রুটির হার। filter ফিল্ডটি সীমিত সিনট্যাক্স সমর্থন করে। সমর্থিত ফরম্যাটগুলো হলো:

  • খালি: কোনো ফিল্টার প্রয়োগ করা হয়নি।
  • error_type = " "
  • error_type = " " এবং error_reason = " "

যদি একটি খালি ফিল্টার প্রদান করা হয়, তাহলে মেট্রিকটি সমস্ত ত্রুটির ধরণ এবং কারণ জুড়ে একত্রিত করা হবে। যদি শুধুমাত্র error_type নির্দিষ্ট করা হয়, তাহলে মেট্রিকটি সেই ধরণের সমস্ত কারণ জুড়ে একত্রিত করা হবে।

সমর্থিত মান:

  • প্রত্যাখ্যান করুন
  • টেম্প_ফেল

সমর্থিত মান নির্ভর করে :

  • 'প্রত্যাখ্যান'-এর জন্য: [খারাপ সংযুক্তি, খারাপ বা অনুপস্থিত পিটিআর রেকর্ড, আরবিএলএস-এ আইপি, কম ডোমেইন খ্যাতি, কম আইপি খ্যাতি, স্প্যামি বিষয়বস্তু, স্ট্যাম্প নীতি ত্রুটি, অন্যান্য]
  • 'temp_fail'-এর জন্য: [অস্বাভাবিক ট্র্যাফিক প্যাটার্ন, অন্যান্য]