ตัวสร้างการกำหนดค่าเมตริก (MCG) เป็นบริการที่ช่วยให้การเขียนการกำหนดค่าการวัดและส่งข้อมูล SDV ง่ายขึ้น
MCG จะแปลงการกำหนดค่า JSON ที่มนุษย์อ่านได้
เป็นรูปแบบไฟล์ MetricsConfiguration บัฟเฟอร์โปรโตคอล (protobuf) แบบไบนารี
ที่แคมเปญการวัดระยะทางในยานพาหนะต้องใช้
MCG เป็นบริการบนเว็บที่คุณโต้ตอบด้วยโดยใช้คำขอ HTTP มาตรฐาน แนวทางที่อิงตาม API นี้ช่วยให้คุณใช้เครื่องมือบรรทัดคำสั่ง เช่น curl สำหรับการสร้างและการแก้ไขข้อบกพร่องด้วยตนเอง หรือผสานรวม MCG เป็นแบ็กเอนด์สำหรับเครื่องมือที่ซับซ้อนยิ่งขึ้น เช่น อินเทอร์เฟซแบบกราฟิกสำหรับการสร้างการกำหนดค่า
ฟีเจอร์
บริการการวัดและส่งข้อมูลในยานพาหนะต้องใช้ข้อความ MetricsConfigurationไบนารี
protobuf แม้ว่าข้อความนี้จะแสดงเป็นรูปแบบ Textproto สำหรับการแก้ไขข้อบกพร่องได้ แต่การเขียนรูปแบบนี้โดยตรงต้องมีความรู้โดยละเอียดเกี่ยวกับโครงสร้างระดับล่าง และอาจเป็นเรื่องที่น่าเบื่อและมีแนวโน้มที่จะเกิดข้อผิดพลาด MCG ช่วยให้กระบวนการนี้มีประสิทธิภาพมากขึ้น
ด้วยการเปลี่ยนการเขียนการกำหนดค่าเป็นรูปแบบ JSON ที่ใช้งานง่าย
MCG มีฟีเจอร์ต่อไปนี้
- การกำหนดค่าที่อิงตาม JSON: คุณสามารถกำหนดค่าเมตริก รวมถึงแหล่งข้อมูล ตรรกะการประมวลผล และกฎการรายงาน ในรูปแบบ JSON ที่มนุษย์อ่านได้ ซึ่ง MCG จะคอมไพล์เป็นรูปแบบ protobuf แบบไบนารีที่จำเป็น
- การตรวจสอบความถูกต้องในตัว: กระบวนการสร้างจะตรวจสอบความถูกต้องของการกำหนดค่าโดยอัตโนมัติ เทียบกับคำจำกัดความของสัญญาณและกฎของสคีมาเพื่อตรวจหาข้อผิดพลาด ก่อนการติดตั้งใช้งาน
- การสร้างประเภทข้อความอัตโนมัติ: ผู้รวบรวมและรายงานจะสร้างผลลัพธ์ที่ต้องกำหนดโดยใช้ตัวอธิบายข้อความ protobuf ในการกำหนดค่าไบนารีขั้นสุดท้าย MCG จะอนุมานโครงสร้างของผลลัพธ์เหล่านี้โดยอิงตาม ประเภทสัญญาณอินพุตและตรรกะการรวบรวม และสร้าง ตัวอธิบายข้อความที่จำเป็นโดยอัตโนมัติ ซึ่งจะช่วยให้คุณไม่ต้องกำหนดสคีมา สำหรับโครงสร้างข้อมูลระดับกลางหรือโครงสร้างข้อมูลเฉพาะรายงานด้วยตนเอง
- การเขียนนิพจน์ที่ง่ายขึ้น: ไวยากรณ์ที่กำหนดเองซึ่งมนุษย์อ่านได้สำหรับ การกำหนดนิพจน์ช่วยให้ไม่ต้องสร้างแผนผังนิพจน์ด้วยตนเอง
ขั้นตอนการทำงาน
การใช้ MCG เพื่อสร้างการกำหนดค่าเมตริกมี 2 ขั้นตอนหลักๆ ได้แก่ การอัปโหลดแคตตาล็อกสัญญาณยานพาหนะแต่ละเวอร์ชันที่คุณต้องการใช้เพียงครั้งเดียว จากนั้นจึงเขียนและสร้างการกำหนดค่าเมตริกแต่ละรายการ
อัปโหลดคำจำกัดความของสัญญาณ: ขั้นตอนนี้ต้องทำเพียงครั้งเดียวต่อแคตตาล็อกสัญญาณยานพาหนะ แต่ละเวอร์ชัน หากต้องการเปิดใช้การตรวจสอบและการอนุมานประเภท MCG ต้องมีสิทธิ์เข้าถึงคำจำกัดความของสัญญาณยานพาหนะที่คุณต้องการอ้างอิงในการกำหนดค่า คำจำกัดความเหล่านี้ควรมีอยู่แล้วในรูปแบบไฟล์ protobuf ในโปรเจ็กต์ของคุณซึ่งเป็นส่วนหนึ่งของแคตตาล็อก VSIDL (หรือคุณจะใช้คำจำกัดความตัวอย่าง เพื่อทดลองก็ได้) หากต้องการทำให้พร้อมใช้งานใน MCG ให้จัดแพ็กเกจเป็น แคตตาล็อกสัญญาณยานพาหนะ แล้วอัปโหลดโดยใช้ API ดังนี้
- หากต้องการแพ็กเกจไฟล์ protobuf เป็น FileDescriptorSet โปรดดูสร้าง FileDescriptorSet
- หากต้องการเข้ารหัส Base64 และอัปโหลดแคตตาล็อก โปรดดูเพิ่มหรืออัปเดตแคตตาล็อก เวอร์ชัน
เขียนการกำหนดค่า: หลังจากอัปโหลดแคตตาล็อกเวอร์ชันหนึ่งไปยัง MCG แล้ว คุณจะ เขียนการกำหนดค่าเมตริกจำนวนเท่าใดก็ได้ที่อ้างอิงถึงแคตตาล็อกนั้น ในการกำหนดค่า JSON คุณจะกำหนดแหล่งข้อมูลที่จะใช้ วิธีทำการคำนวณหรือการรวบรวมข้อมูล และทริกเกอร์ที่กำหนดเวลาสร้างผลลัพธ์
สร้าง: ส่งการกำหนดค่า JSON ไปยัง MCG API API จะตรวจสอบการกำหนดค่าและรวบรวมไว้ในรูปแบบ
MetricsConfigurationคุณขอข้อมูลนี้เป็น protobuf แบบไบนารี (application/x-protobuf) สำหรับการใช้งานในรถยนต์ หรือเป็น textproto (text/x-protobuf) สำหรับการตรวจสอบหรือ การแก้ไขข้อบกพร่องได้- หากต้องการสร้าง ให้ใช้ POST /api/v1/generate_metrics_config
ดูรายละเอียดทั้งหมดเกี่ยวกับปลายทาง รูปแบบคำขอและการตอบกลับ และ ตัวอย่างการใช้งานได้ที่เอกสารอ้างอิง MCG API
การทำให้ใช้งานได้
ในฐานะบริการที่ดำเนินการบนระบบคลาวด์ MCG ได้รับการออกแบบมาให้ทำให้ใช้งานได้ในสภาพแวดล้อมระบบคลาวด์ (เช่น Google Cloud Run) ซึ่งเป็นจุดศูนย์กลางสำหรับการสร้างและตรวจสอบความถูกต้องของการกำหนดค่าในทีมต่างๆ ดูวิธีการทำให้ใช้งานได้ที่ทำให้ใช้งานได้ใน Google Cloud
สำหรับการพัฒนาและการทดสอบในเครื่อง คุณยังเรียกใช้ MCG เป็นบริการแบบสแตนด์อโลน ในเครื่องของนักพัฒนาซอฟต์แวร์ได้ด้วย ดูวิธีการตั้งค่าได้ที่หัวข้อเรียกใช้ในเครื่อง