รูปแบบ JSON ของคำขอสร้างการกำหนดค่าเมตริก

คู่มือนี้จะอธิบายรูปแบบคำขอ JSON สำหรับ ปลายทาง /api/v1/generate_metrics_config ของเครื่องมือตัวสร้างการกำหนดค่าเมตริก (MCG) รูปแบบนี้ช่วยให้คุณกำหนดแคมเปญการวัดและส่งข้อมูล ได้ โดยระบุการเก็บรวบรวมข้อมูล การประมวลผลในอุปกรณ์ และการสร้างรายงาน ในโครงสร้างที่มนุษย์อ่านได้

เครื่องมือ MCG จะตรวจสอบออบเจ็กต์ JSON นี้ โดยตรวจหาปัญหาต่างๆ เช่น ประเภทไม่ตรงกัน การขึ้นต่อกันแบบเวียนกลับ หรือการอ้างอิงที่ไม่ได้กำหนด จากนั้นจะคอมไพล์ออบเจ็กต์เป็นข้อความ MetricsConfig บัฟเฟอร์โปรโตคอล (protobuf) MetricsConfig ข้อความนี้เป็นรูปแบบไบนารีที่บริการการวัดและส่งข้อมูลทางไกลในอุปกรณ์ดำเนินการ เพื่อเรียกใช้แคมเปญ

ข้อกำหนดเบื้องต้น: คุณควรคุ้นเคยกับสคีมา JSON, protobuf และโครงสร้างข้อมูลพื้นฐาน ดูภาพรวมเชิงแนวคิดได้ที่แนวคิดการกำหนดค่าเมตริก

วิธีการเขียนคำอธิบายการกำหนดค่า

หากต้องการออกแบบแคมเปญการรวบรวมเมตริก ให้ทําตามขั้นตอนต่อไปนี้

1. ระบุแหล่งข้อมูล: กำหนดว่าข้อมูลมาจากไหน
2. กำหนดตรรกะและการประมวลผล: ตั้งค่ากฎสำหรับเวลาที่ควรรวบรวมข้อมูลและวิธีประมวลผล
3. สร้างเอาต์พุต: จัดแพ็กเกจข้อมูลที่ประมวลผลแล้วเป็นข้อความสุดท้าย
4. ฟิลด์ระดับบนสุด: เพิ่มฟิลด์ระดับบนสุด เช่น UUID, signal definitions และlifecycle control

ระบุแหล่งข้อมูล

การวัดและส่งข้อมูลทางไกลรองรับการรวบรวมข้อมูลจากบริการ SDV (ผ่านมิดเดิลแวร์ SDV) และผู้เผยแพร่โฆษณาที่อิงตามรีจิสทรีของผู้เผยแพร่โฆษณาที่กำหนดค่าได้

• บริการ SDV (อิงตาม Pub/Sub): ข้อมูลจะพร้อมใช้งานจากแชแนล Pub/Sub ที่กำหนดไว้ใน VSIDL

• บริการ SDV (อิงตาม RPC): ข้อมูลจะพร้อมใช้งานหากบริการแสดง CreateSubscription หรือ GetLatestMessage RPC

• ผู้เผยแพร่โฆษณาที่อิงตามรีจิสทรีของผู้เผยแพร่โฆษณาที่กำหนดค่าได้: ข้อมูลจะพร้อมใช้งานหากแอปพลิเคชันลงทะเบียนตัวเองโดยใช้IConfigurablePublisherRegistry อินเทอร์เฟซ Android Binder หรือไลบรารีรีจิสทรีของผู้เผยแพร่โฆษณาที่กำหนดค่าได้จาก Telemetry SDK

หากต้องการใช้ข้อมูลใน SDV ให้กำหนดแหล่งข้อมูล (แนวคิด) แล้วเพิ่มลงในอาร์เรย์ data_sources

ตัวเลือกบางอย่างอาจไม่พร้อมใช้งานสำหรับแหล่งข้อมูลบางประเภท ดูข้อมูลโดยละเอียดได้ที่คำแนะนำการผสานรวมแหล่งข้อมูล

รูปแบบของ source_identifier

บริการการวัดและส่งข้อมูลยอมรับรูปแบบตัวระบุแหล่งที่มาหลายรูปแบบ ดูภาพรวมได้ที่คำจำกัดความแหล่งข้อมูลในการกำหนดค่าเมตริก

MCG จะอนุมานประเภทข้อความ protobuf จาก source_identifier ก็ต่อเมื่อใช้รูปแบบชื่อประเภทหน่วยเท่านั้น หากคุณใช้ FQIN หรือชื่อที่กำหนดเอง (จาก Configurable Publisher Registry) MCG จะอนุมานประเภทไม่ได้ ในกรณีเหล่านี้ คุณต้องระบุdata_source_message_types หากประเภทไม่อยู่ในแคตตาล็อก คุณต้องระบุคำจำกัดความของประเภทนั้นใน descriptor_protos ด้วย

{
  "name": "SpeedSource",
  "source_identifier": "mcg.test.subpkg.speed_msg",
  "connection_type": "SUBSCRIPTION",
  "sub_sampling_interval_ms": 1000 // Limit updates to 1 per second
}

กำหนดตรรกะและการประมวลผล

ตรรกะได้รับการจัดการโดยคอมโพเนนต์ 2 อย่างที่ทำงานร่วมกัน ได้แก่ ทริกเกอร์ (แนวคิด) ซึ่งกำหนดเวลาที่เกิดเหตุการณ์ และตัวรวบรวม (แนวคิด) ซึ่งกำหนดวิธีประมวลผลข้อมูล ตามทริกเกอร์เหล่านั้น เนื่องจากนิพจน์ (แนวคิด) เป็นคีย์ สำหรับเงื่อนไขทริกเกอร์และตรรกะการรวบรวม ส่วนนี้จึงอธิบายวิธีกำหนดนิพจน์ก่อน

นิพจน์

นิพจน์ช่วยให้คุณกำหนดการคำนวณและเงื่อนไขได้โดยใช้ไวยากรณ์ที่มนุษย์อ่านได้ MCG จะคอมไพล์สตริงเหล่านี้เป็นรูปแบบที่เรียกใช้งานได้ซึ่งได้รับการเพิ่มประสิทธิภาพสำหรับการ ประเมินในอุปกรณ์

นิพจน์สามารถแสดงการคำนวณทางคณิตศาสตร์ เงื่อนไขเชิงตรรกะ และการเปรียบเทียบข้อมูล ดูไวยากรณ์ทั้งหมด รวมถึงโอเปอเรเตอร์และฟังก์ชันได้ที่ ไวยากรณ์ของนิพจน์

ความใหม่ของข้อมูล: เมื่อนิพจน์เข้าถึงแหล่งข้อมูล ลักษณะการทำงานของการดึงข้อมูล จะขึ้นอยู่กับประเภทการเชื่อมต่อ ดังนี้

• SUBSCRIPTION: ใช้ข้อความที่ได้รับล่าสุดซึ่งแคชโดยบริการการวัดและส่งข้อมูลทางไกล (หมายเหตุ: หากตั้งค่า sub_sampling_interval_ms ไว้ ข้อความนี้อาจแตกต่างจาก ข้อความที่เผยแพร่ล่าสุด)
• ON_DEMAND: เรียกใช้การโทรทันทีเพื่อดึงข้อความล่าสุดจาก บริการ

ข้อจำกัดประเภท

• อาร์เรย์: ระบบไม่รองรับการเข้าถึงดัชนีอาร์เรย์โดยตรง (เช่น my_data_source.my_array[0])
• ความปลอดภัยในการกำหนดประเภท: ตรวจสอบว่าคุณเปรียบเทียบประเภทที่เข้ากันได้ (เช่น อย่าเปรียบเทียบฟิลด์สตริงกับรายการจำนวนเต็ม)

ทริกเกอร์: กำหนดเวลาที่การดำเนินการจะเกิดขึ้น

ทริกเกอร์จะกําหนดเวลาที่การดําเนินการทํางาน ได้แก่ การประเมินเครื่องมือรวบรวม การสร้างรายงาน หรือการควบคุมวงจรการรวบรวม เพิ่มทริกเกอร์ที่กําหนดทั้งหมดลงในอาร์เรย์ triggers ระดับบนสุด

ทริกเกอร์ข้อมูล

ทริกเกอร์จะทำงานเมื่อSUBSCRIPTIONแหล่งข้อมูลให้ข้อความใหม่ (แนวคิด)

{
  "name": "OnNewSpeed",
  "data": {
    "source_name": "SpeedSource" // Reference to the defined data source
  }
}

ทริกเกอร์เป็นระยะ

ไฟไหม้เป็นระยะๆ (แนวคิด)

{
  "name": "EveryMinute",
  "periodic": {
    "period_ms": 60000 // 60,000 ms = 60 seconds
  }
}

ทริกเกอร์แบบมีเงื่อนไข

เริ่มทำงานตามการประเมินนิพจน์ (แนวคิด) ต้องมีทริกเกอร์ระดับบนอย่างน้อย 1 รายการเพื่อเริ่มการประเมิน ซึ่งมักจะเป็นทริกเกอร์ข้อมูลสำหรับแหล่งข้อมูลหรือตัวรวบรวมในนิพจน์ หรือทริกเกอร์เป็นระยะเพื่อสำรวจข้อมูล

ประเภทเงื่อนไข

condition_type พจนานุกรมต้องมีประเภทเงื่อนไขที่ใช้ได้ 1 ประเภทเป็นคีย์ ดูข้อมูลเพิ่มเติมได้ที่ทริกเกอร์แบบมีเงื่อนไข

ตัวเลือกขอบ

ออบเจ็กต์ rising_options และ falling_options มีฟิลด์ต่อไปนี้ หากระบุไว้ การเปลี่ยนที่เกี่ยวข้องต้องเป็นไปตามข้อกำหนดด้านระยะเวลา การเปลี่ยนฉากที่ไม่มีตัวเลือกที่ระบุจะเริ่มทำงานทันที

{
  "name": "SpeedingFor5Seconds",
  "conditional": {
    "triggers": ["OnNewSpeed"],
    "expression": "SpeedSource.speed > 27.7",
    "condition_type": {
      "rising_edge": {
        "rising_options": {
          "min_duration_ms": 5000 // Condition must hold for 5s in new state
        }
      }
    }
  }
}

ผู้รวบรวม: กำหนดวิธีประมวลผลข้อมูล

ใช้ตัวรวบรวมสำหรับการประมวลผลข้อมูลระดับกลางแบบมีสถานะ (แนวคิด) กำหนดตัวรวบรวมและเพิ่มลงในอาร์เรย์ aggregators

ผู้รวบรวมจะแปลงข้อมูลและทำให้ข้อมูลพร้อมใช้งานสำหรับผู้รวบรวมและรายงานอื่นๆ

เครื่องมือสร้างข้อความ

ออบเจ็กต์ message_builder จะกําหนดโครงสร้างข้อความเอาต์พุตและตรรกะการรวบรวมที่ใช้ในการคํานวณฟิลด์ของออบเจ็กต์ดังกล่าว โดยจะใช้ทั้งใน Aggregators และ Report Configurations

{
  "name": "SpeedAggregator",
  "trigger_names": ["OnNewSpeed"], // Update aggregation on new speed data
  "reset_on_get": true, // Reset stats after they are read by the report configuration
  "message_builder": {
    "field_assignments": [
      {
        "field_name": "average_speed",
        "aggregation": {
          "@type": "avg",
          "expression": "SpeedSource.speed"
        }
      },
      {
        "field_name": "speed_reading_count",
        "aggregation": {
          "@type": "count" // Counts triggers (that is, processed speed readings) since last reset
        }
      },
      {
        "field_name": "speed_history_last5",
        "aggregation": {
          "@type": "vector",
          "expression": "SpeedSource.speed",
          "max_length": 5 // Keep last 5 readings
        }
      }
    ]
  }
}

สร้างเอาต์พุต

หากต้องการกำหนดเอาต์พุตสุดท้ายของแคมเปญการวัดและส่งข้อมูลทางไกล ให้เพิ่มออบเจ็กต์ลงในอาร์เรย์ report_configs (แนวคิด) การกำหนดค่าเหล่านี้จะกำหนดวิธีแพ็กเกจข้อมูลที่ประมวลผลแล้วและเวลาที่สร้างข้อมูล คุณสามารถกำหนดค่ารายงานหลายรายการในการกำหนดค่าเมตริกเดียวเพื่อนำคอมโพเนนต์กลับมาใช้ใหม่ได้

คุณควบคุมการสร้างรายงานได้โดยใช้ฟิลด์ trigger_names นอกจากนี้ คุณยังใช้ report_initial เพื่อสร้างรายงานทันทีเมื่อการกำหนดค่า เปิดใช้งาน และ report_incomplete เพื่อสร้างรายงานสุดท้ายเมื่อการรวบรวมข้อมูล ถูกขัดจังหวะ

หมายเหตุ: หากต้องการเชื่อมต่อการประมวลผลกับเอาต์พุต ให้ใช้noneประเภทการรวบรวม (@type: "none") เพื่ออ่านค่าที่คำนวณไว้ล่วงหน้าจาก Aggregator เนื่องจากโดยปกติแล้วรายงานจะเป็นภาพรวมแบบไม่เก็บสถานะ การดำเนินการนี้จะช่วยให้ตรรกะแบบเก็บสถานะที่ซับซ้อนอยู่ภายในเครื่องมือรวบรวมข้อมูล และสงวนรายงานไว้สำหรับการจัดรูปแบบ

{
  "name": "MinuteReport",
  "trigger_names": ["EveryMinute"], // Generate report every minute
  "message_builder": {
    "field_assignments": [
      {
        "field_name": "average_speed",
        "aggregation": {
          "@type": "none", // Read the value directly from the aggregator
          "expression": "SpeedAggregator.average_speed"
        }
      },
      {
        "field_name": "reading_count",
        "aggregation": {
          "@type": "none",
          "expression": "SpeedAggregator.speed_reading_count"
        }
      }
    ]
  }
}

ฟิลด์ระดับบนสุด

นอกเหนือจากอาร์เรย์ data_sources, aggregators, triggers และ report_configs แล้ว คำอธิบายของการกำหนดค่าเมตริกยังต้องมีการอ้างอิงแคตตาล็อกสัญญาณด้วย นอกจากนี้ คุณยังรวมช่องที่ไม่บังคับเพื่อกำหนด UUID ที่เฉพาะเจาะจงและจัดการวงจรการรวบรวมได้ด้วย

ตั้งค่า UUID

MetricsConfig แต่ละรายการต้องมีตัวระบุที่ไม่ซ้ำกับผู้อื่น (UUID) หากคุณระบุ existing_uuid MCG จะใช้ existing_uuid ดังกล่าว ไม่เช่นนั้น ระบบจะสร้างรหัสแบบสุ่ม ระบุ existing_uuid เพื่อให้การติดตั้งใช้งานและเครื่องมือต่างๆ สอดคล้องกัน

สตริงต้องเป็น UUID ที่มีขีดกลางที่ถูกต้องซึ่งมีเฉพาะตัวอักษรพิมพ์เล็ก

"existing_uuid": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8",

คำจำกัดความของสัญญาณ

หากต้องการตรวจสอบชื่อและประเภทสัญญาณ MCG ต้องมีสิทธิ์เข้าถึงแคตตาล็อกสัญญาณยานพาหนะ ซึ่งเป็น Protobuf FileDescriptorSet ที่มีคำจำกัดความ VSIDL .proto (แพ็กเกจและอัปโหลดไปยัง MCG) ดูรายละเอียดเกี่ยวกับการสร้างและ อัปโหลดแคตตาล็อกได้ที่แคตตาล็อกสัญญาณยานพาหนะ

ระบุเวอร์ชันแคตตาล็อกในฟิลด์ vs_version ของออบเจ็กต์ JSON ดังนี้

"vs_version": "v1.0",

กำหนดทริกเกอร์วงจรลูกค้า

ในบริบทของแคมเปญการวัดและส่งข้อมูล วงจรของMetricsConfig จะเป็นตัวกำหนดเวลาที่บันทึกข้อมูลจริง ขณะที่ระบบการจัดการแคมเปญ กําลังติดตั้งใช้งานและเปิดใช้งานการกําหนดค่าในอุปกรณ์ คุณสามารถใช้ทริกเกอร์วงจร เพื่อควบคุมเวลาที่เก็บรวบรวมข้อมูลในการติดตั้งใช้งานนั้นได้อย่างแม่นยำ

ซึ่งช่วยให้คุณปรับการเก็บรวบรวมข้อมูลให้สอดคล้องกับรูปแบบการใช้งานยานพาหนะ เช่น "การเดินทาง" (IgnitionOn ถึง IgnitionOff) หรือ "เซสชันการชาร์จ" โดยไม่ต้อง ปิดใช้งานการกำหนดค่า

• การควบคุมเซสชัน (เริ่ม/หยุดชั่วคราว): ใช้ start_trigger_name และ stop_trigger_name เพื่อควบคุมเวลาที่เกิดการรวบรวม เช่น หากต้องการ รวบรวมข้อมูลขณะที่ยานพาหนะกำลังขับเท่านั้น ให้ใช้ IgnitionOn เป็นทริกเกอร์เริ่มต้นและ IgnitionOff เป็นทริกเกอร์หยุด การกำหนดค่าจะยังคงใช้งานได้ในอุปกรณ์ แต่จะ "หยุดชั่วคราว" (หยุดรวบรวมและประมวลผล) เมื่อทริกเกอร์หยุดทำงาน และจะกลับมาทำงานอีกครั้งเมื่อทริกเกอร์เริ่มทำงานอีกครั้ง

  สำคัญ: การดำเนินการนี้จะหยุดการเก็บรวบรวมชั่วคราวเท่านั้น แต่ไม่ได้กำหนด กรอบเวลาเชิงตรรกะ ชุดข้อมูลแยกต่างหาก หรือมีผลข้างเคียงอื่นๆ ระบบไม่รีเซ็ตค่าตัวรวบรวมเมื่อหยุดชั่วคราวหรือกลับมาดำเนินการรวบรวมต่อ

• การตรวจจับแบบครั้งเดียว (เสร็จสิ้น): ใช้ deactivate_trigger_name หากการกำหนดค่าควรทำงานเพียงครั้งเดียว (เช่น เพื่อตรวจหาการเกิดรหัสข้อบกพร่องที่เฉพาะเจาะจงเป็นครั้งแรก) แล้วปิดใช้งานตัวเองอย่างถาวรในอุปกรณ์นั้น แม้ว่าในทางเทคนิคแล้วแคมเปญจะยังคงใช้งานอยู่ก็ตาม

หากคุณไม่ได้ระบุทริกเกอร์วงจรลูกค้า การเก็บรวบรวมข้อมูลจะเริ่มทันที เมื่อแคมเปญเปิดใช้งานการกำหนดค่า และจะดำเนินการอย่างต่อเนื่อง จนกว่าแคมเปญจะสิ้นสุด

ขั้นสูง: คำจำกัดความของโปรโตคอลที่กำหนดเอง

ใน 2 กรณีหลัก vs_version เพียงอย่างเดียวไม่เพียงพอให้ MCG เข้าใจข้อความทุกประเภทในคำอธิบายของการกำหนดค่าเมตริก

1. การอนุมานประเภทล้มเหลว: ดังที่อธิบายไว้ในsource_identifier รูปแบบ MCG จะอนุมานประเภทไม่ได้เมื่อ source_identifier ใช้ FQIN หรือชื่อที่กำหนดเอง
2. ข้อความที่กำหนดเอง: คำอธิบายการกำหนดค่าเมตริกใช้ข้อความ protobuf ซึ่งไม่พบในแคตตาล็อก VSIDL ที่ระบุใน vs_version กรณีนี้จะเกิดขึ้นเมื่อตั้งค่า message_type ใน message_builder สำหรับรูปแบบรายงานที่กำหนดเอง

ในกรณีเหล่านี้ ให้ใช้ data_source_message_types เพื่อช่วยให้ MCG อนุมานประเภทและ descriptor_protos เพื่อให้คำจำกัดความของข้อความ

data_source_message_types

แมปsource_identifierสตริงกับประเภทข้อความ protobuf ที่มีคุณสมบัติครบถ้วน คีย์ใน data_source_message_types ต้องตรงกับค่า source_identifier จากรายการ data_sources

"data_source_message_types": {
  "MyCustomSpeedService": "com.sdv.example.SampleMessage"
}

descriptor_protos

ระบุคำจำกัดความสำหรับประเภทข้อความที่ใช้ใน data_source_message_types หรือ message_builder ซึ่งไม่ได้อยู่ใน vs_version ที่กำหนดค่าไว้

ส่ง descriptorpb.FileDescriptorSet ที่เข้ารหัส Base64 ในอาร์เรย์ descriptor_protos สร้างจากไฟล์ .proto โดยใช้คอมไพเลอร์ Protobuf protoc

"descriptor_protos": [
  "Cu8BCiZtY2cvdGVzdGRhdGEvbWF4YXZnY3..." // Base64 string
]

{
  "existing_uuid": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8", // Unique identifier for the configuration
  "vs_version": "example_version", // Version of the VSIDL catalog to use
  "data_sources": [
    {
      "name": "SpeedSource",
      "source_identifier": "mcg.test.subpkg.speed_msg",
      "connection_type": "SUBSCRIPTION",
      "sub_sampling_interval_ms": 1000
    }
  ],
  "aggregators": [
    {
      "name": "SpeedAggregator",
      "trigger_names": ["OnNewSpeed"],
      "reset_on_get": true,
      "message_builder": {
        "field_assignments": [
          {
            "field_name": "average_speed",
            "aggregation": {
              "@type": "avg",
              "expression": "SpeedSource.speed"
            }
          },
          {
            "field_name": "speed_reading_count",
            "aggregation": { "@type": "count" }
          },
          {
            "field_name": "speed_history_last5",
            "aggregation": {
              "@type": "vector",
              "expression": "SpeedSource.speed",
              "max_length": 5
            }
          }
        ]
      }
    }
  ],
  "triggers": [
    {
      "name": "OnNewSpeed",
      "data": { "source_name": "SpeedSource" }
    },
    {
      "name": "EveryMinute",
      "periodic": { "period_ms": 60000 }
    }
  ],
  "report_configs": [
    {
      "name": "MinuteReport",
      "trigger_names": ["EveryMinute"],
      "message_builder": {
        "field_assignments": [
          {
            "field_name": "average_speed",
            "aggregation": {
              "@type": "none",
              "expression": "SpeedAggregator.average_speed"
            }
          },
          {
            "field_name": "reading_count",
            "aggregation": {
              "@type": "none",
              "expression": "SpeedAggregator.speed_reading_count"
            }
          }
        ]
      }
    }
  ]
}

เทมเพลตอ้างอิง

ดูคำจำกัดความ API ได้ที่เอกสารอ้างอิง MCG API

ส่วนต่อไปนี้เป็นข้อมูลอ้างอิงที่สมบูรณ์เกี่ยวกับคำอธิบายของ การกำหนดค่าเมตริก ใช้เป็นแนวทางในการสร้างคำอธิบายการกำหนดค่าเมตริกของคุณเอง

ฟิลด์ระดับบนสุด

{
  "existing_uuid": "00000000-0000-0000-0000-000000000000", // Optional
  "vs_version": "example_version", // Optional
  "descriptor_protos": ["..."], // Optional. Base64 encoded FileDescriptorSet
  "data_source_message_types": {
    "ExampleServiceName": "com.example.ProtoMessage"
  }, // Optional
  "start_trigger_name": "DataTriggerExample", // Optional
  "stop_trigger_name": "ConditionalTriggerExample", // Optional
  "deactivate_trigger_name": "PeriodicTriggerExample" // Optional
}

อินพุต: แหล่งข้อมูลและผู้รวบรวมข้อมูล

{
  "data_sources": [
    {
      "name": "SubscriptionExample",
      "source_identifier": "com.example.sdv.ExampleMessage|example-unit",
      "connection_type": "SUBSCRIPTION", // Options: SUBSCRIPTION (default), ON_DEMAND
      "sub_sampling_interval_ms": 100, // Optional
      "fetch_last_message": false // Optional. Default: false
    },
    {
      "name": "RegistryExample",
      // Configurable Publisher Registry-based publisher (matches data_source_message_types)
      "source_identifier": "ExampleServiceName",
      "connection_type": "SUBSCRIPTION"
    },
    {
      "name": "GetterExample",
      "source_identifier": "com.example.sdv.ExampleConfig|example-unit",
      "connection_type": "ON_DEMAND",
      "configuration": {
        "type_url": "type.googleapis.com/example.Config",
        "value_json": {} // Or value_textproto, value (base64)
      }
    }
  ],
  "aggregators": [
    {
      "name": "AggregatorExample",
      "trigger_names": ["DataTriggerExample"],
      "reset_on_get": false, // Optional. Default: false. If true, resets state after it's read
      "message_builder": {
        "message_type": "com.example.AggregatedMessage", // Optional
        "field_assignments": [
          {
            "field_name": "avg_example",
            "aggregation": {
              // Options: avg, count, min, max, sum, stddev, delta, vector, none
              "@type": "avg",
              "expression": "SubscriptionExample.value"
            }
          },
          {
            "field_name": "count_example",
            "aggregation": {
              "@type": "count" // Counts number of evaluations. No expression needed
            }
          },
          {
            "field_name": "vector_example",
            "aggregation": {
              "@type": "vector",
              "expression": "SubscriptionExample.value",
              "max_length": 10 // Optional. If set, creates a ring buffer
            }
          }
        ]
      }
    }
  ]
}

ตรรกะและการประมวลผล: ทริกเกอร์

{
  "triggers": [
    {
      "name": "PeriodicTriggerExample",
      "periodic": { "period_ms": 1000 }
    },
    {
      "name": "DataTriggerExample",
      "data": { "source_name": "SubscriptionExample" }
    },
    {
      "name": "ConditionalTriggerExample",
      "conditional": {
        "triggers": ["PeriodicTriggerExample"],
        "expression": "SubscriptionExample.value > 0",
        "condition_type": {
          // Options: is_true, is_false, rising_edge, falling_edge, all_changes
          "rising_edge": {
            "rising_options": { "min_duration_ms": 0, "require_exact": false }
          }
        }
      }
    }
  ]
}

เอาต์พุต: การกำหนดค่ารายงาน

{
  "report_configs": [
    {
      "name": "ReportExample",
      "trigger_names": ["PeriodicTriggerExample"],
      "report_incomplete": false, // Optional. Default: false
      "report_initial": false, // Optional. Default: false
      "message_builder": {
        "message_type": "com.example.ReportMessage", // Optional. Must be defined in VSIDL catalog or descriptor_protos. Message type will be inferred if not provided
        "field_assignments": [
          {
            "field_name": "avg_example",
            "aggregation": {
              "@type": "none", // Passthrough since aggregation is done in AggregatorExample
              "expression": "AggregatorExample.avg_example"
            }
          }
        ]
      }
    }
  ]
}

ไวยากรณ์ของนิพจน์