Health Monitor (HM) เป็น Agent ของ SDV ที่ทำงานในเครื่องเสมือน (VM) แต่ละเครื่องเพื่อติดตามสถานะของแพ็กเกจบริการ ตรวจสอบประสิทธิภาพการทำงานของ VM และสร้างรายงานประสิทธิภาพการทำงานของ VM เป็นระยะๆ
แพ็กเกจบริการที่ OEM กำหนดต้องฟังสัญญาณด้านประสิทธิภาพต่างๆ ที่ HM รายงาน และดำเนินการกู้คืนตามข้อมูลดังกล่าว ตัวอย่างเช่น อินสแตนซ์ SDV ที่มีแพ็กเกจบริการที่ขัดข้องอาจต้องรีสตาร์ทหรืออัปเดต
คุณสามารถกำหนดค่าเอเจนต์ HM เพื่อติดตามสิ่งต่อไปนี้ได้
- สถานะการทำงานของเอนทิตีที่ทำงานเป็นระยะๆ โดยการตรวจสอบฮาร์ตบีตการทำงาน คุณสามารถกำหนดค่าการตรวจสอบนี้ได้ทั้งสำหรับอินสแตนซ์แพ็กเกจบริการและตัวแทน OEM ที่กำหนดเอง
- สถานะการกู้คืนของอินสแตนซ์แพ็กเกจบริการ คุณสามารถกำหนดค่าแพ็กเกจบริการให้รีสตาร์ทโดยอัตโนมัติเมื่อเกิดข้อขัดข้องได้ HM จะให้สัญญาณเพื่อตรวจสอบกระบวนการกู้คืนนี้
- QoS สำหรับการสื่อสาร
- ความพร้อมใช้งานของ SDV และ Agent ที่กำหนดเองของ OEM
คุณสามารถดูแคตตาล็อก VSIDL ทั้งหมด รวมถึงคำจำกัดความของโปรโตเพื่อใช้อ้างอิงได้ที่ //system/software_defined_vehicle/health_monitor/catalog/health_monitor.vsidl
คำศัพท์
คำศัพท์เหล่านี้ใช้ในหน้านี้
ทำงานกับระบบย่อย HM
หากต้องการใช้ฟีเจอร์ HM การติดตั้งใช้งาน OEM จะต้องทำดังนี้
- กำหนดค่าระบบตรวจสอบประสิทธิภาพโดยระบุไฟล์การกำหนดค่าตามที่อธิบายไว้ในกำหนดค่าระบบ HM
- ใช้แพ็กเกจบริการ HM Listener ที่ OEM กำหนดเพื่อฟังเอาต์พุต HM และดำเนินการที่เหมาะสม
- พัฒนาแพ็กเกจบริการที่เผยแพร่สัญญาณอย่างสม่ำเสมอตามการกำหนดค่าประสิทธิภาพ การเผยแพร่นี้ช่วยให้ HM ประเมินสถานะความสมบูรณ์ของตนเองได้ ดูข้อมูลเพิ่มเติมได้ที่คู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับแพ็กเกจบริการ
กำหนดค่าระบบ HM
การกำหนดค่าที่เกี่ยวข้องกับ HM จะอยู่ในประเภทการกำหนดค่าอย่างใดอย่างหนึ่งต่อไปนี้
- การกำหนดค่าสถานะ Health ต่อ VM ทั่วโลก
- การกำหนดค่าประสิทธิภาพการทำงานต่อแพ็กเกจบริการ ซึ่งกำหนดพารามิเตอร์ประสิทธิภาพการทำงานสำหรับอินสแตนซ์ทั้งหมดของแพ็กเกจ
การกำหนดค่าประสิทธิภาพต่อ VM
ขณะรันไทม์ เอเจนต์ HM คาดหวังการกำหนดค่าประสิทธิภาพการทำงานทั่วทั้ง VM ซึ่งเป็นไฟล์ textproto (ที่มีนามสกุล .textproto) ประเภท VMHealth ที่กำหนดไว้ที่ //system/software_defined_vehicle/health_monitor/catalog/health_monitoring_config.proto
การกำหนดค่า Health ของ VM ควรอยู่ในเส้นทางที่ระบุโดยใช้พร็อพเพอร์ตี้ระบบเวลาเปิดเครื่อง androidboot.sdv.health_monitor.config_path
หรือจะกำหนดค่านี้แบบไดนามิกขณะรันไทม์โดยตั้งค่าพร็อพเพอร์ตี้ระบบ persist.sdv.health_monitor.config_path เป็นเส้นทางที่กำหนดเองก็ได้ การตั้งค่า persist.* จะมีความสำคัญเหนือกว่าการตั้งค่า androidboot.* คุณต้องรีบูตอุปกรณ์เพื่อให้การกำหนดค่าใหม่มีผล
การกำหนดค่าประสิทธิภาพของ VM ช่วยให้คุณตั้งค่าต่อไปนี้ได้
ความถี่ของรายงานประสิทธิภาพของ VM ผ่าน
period_msการตั้งค่านี้เป็นการแลกเปลี่ยนระหว่างการส่งสัญญาณที่เร็วขึ้นว่าตรวจพบการละเมิดประสิทธิภาพการทำงานและประสิทธิภาพของระบบย่อย HM เราขอแนะนำให้ใช้ค่า 100 มิลลิวินาทีAgent ใดบ้างที่จะได้รับการตรวจสอบข้อขัดข้อง (ดูหัวข้อการตรวจสอบข้อขัดข้องของ Agent)
ตัวอย่างไฟล์การกำหนดค่าอยู่ใน //system/software_defined_vehicle/health_monitor/src/prod_configs/ ตัวอย่างไฟล์การกำหนดค่ามีดังนี้
period_ms: 100
monitored_agent {
agent_name: "sdv_dt_agent"
binder_interface_name: "google.sdv.data_tunnel.IAgentService/default"
}
monitored_agent {
agent_name: "sdv_rpc_agent"
binder_interface_name: "google.sdv.rpc.IRpcAgent/default"
}
ในตัวอย่างนี้ ตัวแทน SDV DT และ RPC ได้รับการกำหนดค่าสำหรับการตรวจสอบข้อขัดข้อง และรายงานประสิทธิภาพของ VM ได้รับการกำหนดค่าให้เผยแพร่ทุกๆ 100 มิลลิวินาที
การกำหนดค่าแพ็กเกจบริการต่อรายการ
การตรวจสอบประสิทธิภาพของอินสแตนซ์แพ็กเกจบริการเป็นตัวเลือกที่ไม่บังคับ หากต้องการเลือกใช้ ให้จัดเก็บไฟล์การกำหนดค่าด้านประสิทธิภาพการทำงานใน APEX ของแพ็กเกจบริการและกำหนดเส้นทางไปยังไฟล์ดังกล่าวในช่อง health_config_path ของ sdv_service_bundle_metadata ใน sdv_service_bundles_manifest.textproto ดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ Manifest ของแพ็กเกจบริการได้ที่ข้อมูลเมตาของแพ็กเกจบริการ
ไฟล์การกำหนดค่าสถานะเป็นไฟล์ textproto ประเภทต่อไปนี้
message ServiceBundleHealthConfiguration {
// Required: An empty ServiceBundleHealthConfiguration is equivalent to no
// implicit health monitoring or QoS monitoring configured.
//
// Key should contain the instance name that the `InstanceConfiguration` applies to.
map<string, InstanceConfiguration> instance_config = 1;
}
สำหรับแต่ละอินสแตนซ์ คุณสามารถระบุทั้งการกำหนดค่าฮาร์ตบีตของความพร้อมใช้งานและการกำหนดค่า QoS ได้ดังนี้
// Service bundle *instance* configuration.
message InstanceConfiguration {
// Optional.
//
// Instance health monitoring configuration. Monitors instance
// general health. Well suited for bundles executing periodic tasks.
optional HealthConfiguration health_config = 1;
// Optional.
//
// Map defining the QoS monitoring profile of the instance.
// The key (string) is the topic name of the specific QoS heartbeat
// publication. Choose a meaningful topic name for
// expressive HM reporting.
//
// Only one publisher should publish on this topic. The HM
// agent ignores all publishers except the first one registered
// by the service bundle instance configured for QoS monitoring.
map<string, QosMonitoringConfiguration> qos_config = 2;
}
ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าต่อฟีเจอร์ได้ที่การตรวจสอบฮาร์ตบีตของความพร้อมใช้งานและการตรวจสอบ QoS
ฟังเอาต์พุต HM
คุณสามารถฟัง HM ผ่านรายงานเป็นระยะหรือ RPC API ก็ได้
รายงานประสิทธิภาพของ VM
การตรวจสอบประสิทธิภาพจะสร้างรายงานประสิทธิภาพของ VM เป็นระยะๆ ด้วยความถี่สูง ซึ่งจะให้ข้อมูลสรุปเกี่ยวกับสถานะประสิทธิภาพของเอนทิตีที่ตรวจสอบ
ไวยากรณ์ประเภทของ VmHealth กำหนดไว้ใน //system/software_defined_vehicle/health_monitor/catalog/health_topic.proto ดังนี้
message VmHealth {
// Required.
// Describes if all monitored service bundles are healthy and report heartbeats on time.
bool all_monitored_service_bundles_healthy = 1;
// Required.
// Describes if all service bundles which should be running on the VM are alive.
bool all_service_bundles_alive = 2;
// Required.
// Indicates if QoS requirements for all service bundles which should be running
// on the VM are satisfied.
bool qos_violations_detected = 3;
}
แพ็กเกจบริการ Listener ของ HM ที่ OEM กำหนดควรฟังรายงาน VMHealth และดำเนินการที่เหมาะสมโดยขึ้นอยู่กับสถาปัตยกรรมระบบที่สมบูรณ์
การดำเนินการที่เป็นไปได้มีดังนี้
- เรียกใช้กิจวัตรการวินิจฉัยใน VM
- รีสตาร์ท VM
- เรียกใช้แคมเปญการตรวจวัดระยะไกลเพื่อหาสาเหตุ
- อัปเดตระบบหรือหยุดการอัปเดตหากระบบทำงานผิดปกติ
HM RPC API
รายงานประสิทธิภาพของ VM เป็นการเผยแพร่ที่เพิ่มประสิทธิภาพด้านความถี่และความเร็วในการส่งข้อมูล โดยให้ข้อมูลโดยรวมเกี่ยวกับสถานะประสิทธิภาพของระบบ
HM RPC API ช่วยให้ Listener ของ HM ได้รับข้อมูลโดยละเอียดเกี่ยวกับแหล่งที่มาของการละเมิดด้านประสิทธิภาพการทำงาน อินเทอร์เฟซได้รับการกำหนดไว้ใน
//system/software_defined_vehicle/health_monitor/catalog/health_monitor_service.proto
เราได้จำลองอินเทอร์เฟซไว้ที่นี่เพื่อความสะดวก
// RPC Interface of the VM Health Monitor Agent for querying details about the current VM
// health.
//
// An OEM-defined service bundle typically monitors the overall health of the SDV instance by listening to
// high-frequency `VMHealth` publication. If violations are detected, this RPC interface can
// be used to retrieve detailed information about the malfunctioning component.
service HealthMonitorService {
// Returns the list of running SDV service bundles that were created or started
// by the orchestrator on this VM.
rpc ListAllServiceBundles(ListAllServiceBundlesRequest) returns (ListAllServiceBundlesResponse) {}
// Returns the list of crashed SDV service bundles.
rpc ListCrashingServiceBundles(ListCrashingServiceBundlesRequest)
returns (ListCrashingServiceBundlesResponse) {}
// Returns the list of recovering SDV service bundles.
rpc ListRecoveringServiceBundles(ListRecoveringServiceBundlesRequest)
returns (ListRecoveringServiceBundlesResponse) {}
// Returns the list of monitored SDV service bundles, which registered for reporting
// aliveness heartbeats but failed to report heartbeats on time.
rpc ListUnhealthyMonitoredServiceBundles(ListUnhealthyMonitoredServiceBundlesRequest)
returns (ListUnhealthyMonitoredServiceBundlesResponse) {}
// Returns a list of QoS monitoring violations detected.
// Provides a snapshot of the current system state.
rpc ListQosViolations(ListQosViolationsRequest)
returns (ListQosViolationsResponse) {}
}
คำอธิบายฟีเจอร์โดยละเอียด
ส่วนนี้จะอธิบายแง่มุมต่างๆ ของ HM โดยละเอียดยิ่งขึ้น
การตรวจสอบฮาร์ตบีตของความพร้อมใช้งาน
เมื่อกำหนดค่าการตรวจสอบความพร้อมใช้งานสำหรับอินสแตนซ์แพ็กเกจบริการ HM จะคาดหวังให้อินสแตนซ์เผยแพร่ฮาร์ตบีตเป็นระยะเพื่อพิสูจน์ว่าตรรกะทางธุรกิจทำงานอย่างถูกต้อง การตรวจสอบนี้เหมาะที่สุดสำหรับอินสแตนซ์แพ็กเกจบริการที่ทำงานเป็นระยะๆ นอกจากนี้ บันเดิลที่ใช้รันไทม์แบบอะซิงโครนัสสามารถใช้การตรวจสอบความพร้อมใช้งานเพื่อพิสูจน์ว่าพูลเธรดไม่ได้ถูกใช้จนหมด
รูปที่ 1 ขั้นตอนการตรวจสอบการทำงานของ HM
การกำหนดค่า
หากต้องการเปิดใช้ HB ความพร้อมใช้งานในอินสแตนซ์แพ็กเกจบริการ ให้เพิ่มอินสแตนซ์ของ HealthConfiguration ลงในช่อง health_config ในการกำหนดค่าแพ็กเกจ
การกำหนดค่าฮาร์ตบีตของความพร้อมใช้งานจะกำหนดชุดพารามิเตอร์ที่กำหนดไว้ล่วงหน้าซึ่งสร้างเกณฑ์สำหรับการประเมินสัญญาณฮาร์ตบีตเป็นระยะของบริการ หากลักษณะของฮาร์ตบีตของบริการเบี่ยงเบนไปจากพารามิเตอร์เหล่านี้ ระบบจะจัดประเภทฮาร์ตบีตเป็นล่าช้าและแพ็กเกจบริการที่เกี่ยวข้องเป็นไม่สมบูรณ์ ซึ่งอาจบ่งชี้ถึงสถานะการทำงานที่ไม่เหมาะสม
ระบบจะถือว่าแพ็กเกจบริการทำงานได้ดีเมื่อรายงานฮาร์ตบีตตรงเวลาตามการกำหนดค่าประสิทธิภาพการทำงาน ในกรณีที่เกิดข้อขัดข้องหรือระบบมีโหลดสูง สัญญาณฮาร์ตบีตอาจหายไปหรือล่าช้า ซึ่งทำให้ระบบทำเครื่องหมายแพ็กเกจบริการว่ามีสถานะไม่ดี ในกรณีนี้ การละเมิดจะปรากฏในรายงาน VmHealth
นักพัฒนาแพ็กเกจบริการควรกำหนดค่าความสมบูรณ์ของแพ็กเกจบริการในข้อมูลเมตา APEX ที่เกี่ยวข้อง การกำหนดค่าประสิทธิภาพจะกำหนดเกณฑ์ต่อไปนี้
ความล่าช้าสูงสุดที่อนุญาตในช่วงเริ่มต้นระหว่างการเริ่มบริการและการตรวจจับฮาร์ตบีตครั้งแรก
ระยะเวลาที่แพ็กเกจบริการ SDV ดำเนินการตรรกะทางธุรกิจ ซึ่งสอดคล้องกับระยะเวลาของการเผยแพร่ฮาร์ตบีตของบริการ
จำนวนระยะเวลาที่ขาดหายไปก่อนที่ HM จะพิจารณาว่าแพ็กเกจบริการไม่สมบูรณ์
เวลาในการดำเนินการคือระยะเวลาที่แพ็กเกจบริการ SDV ต้องใช้ในการดำเนินการตามตรรกะทางธุรกิจก่อนที่จะเผยแพร่ฮาร์ตบีตของบริการได้
แพ็กเกจบริการจะสร้างการละเมิดด้านประสิทธิภาพการทำงานหากฮาร์ตบีตของบริการล่าช้า โดยมี 2 กรณีตามเวลาของการสังเกตประสิทธิภาพ ดังนี้
กรณีที่ 1: ไม่ได้รับฮาร์ตบีตเริ่มต้น หากเวลาที่ผ่านไปนับตั้งแต่การเริ่มต้นแพ็กเกจบริการจนถึงเวลาที่สังเกตการณ์นานกว่าความล่าช้าเริ่มต้นที่อนุญาต ระบบจะถือว่าแพ็กเกจบริการไม่สมบูรณ์
กรณีที่ 2: ได้รับฮาร์ตบีตแล้ว หากเกณฑ์ผ่านไประหว่างฮาร์ตบีตล่าสุดกับเวลาที่สังเกตการณ์ ระบบจะถือว่าแพ็กเกจบริการไม่สมบูรณ์ เกณฑ์นี้คำนวณจากผลรวมของระยะเวลาการรายงาน (คูณด้วยจำนวนระยะเวลา) และระยะเวลาของงาน
รูปแบบการกำหนดค่าสถานะมีการกำหนดไว้ใน
//system/software_defined_vehicle/health_monitor/catalog/health_config.proto:
package com.android.sdv.health;
// Service Bundle's configuration for health monitoring.
message HealthConfiguration {
// Required.
// Initial delay in milliseconds is the time between the service starts and its first heartbeat.
optional uint64 initial_delay_ms = 2;
// Required.
// Period of reporting a heartbeat in milliseconds which corresponds to the periodicity of
// executing a business logic by the SDV service. This value should be larger than 0.
optional uint64 period_ms = 3;
// Required.
// The number of periods missing a heartbeat before the Health Monitor should consider the
// service as unhealthy. This value should be larger than 0.
optional uint64 num_periods = 4;
// Required.
// Duration of the business logic the SDV service bundle executes in milliseconds.
optional uint64 task_duration_ms = 5;
}
ข้อควรพิจารณาเกี่ยวกับรันไทม์
ส่วนนี้จะให้คำแนะนำในการเผยแพร่ฮาร์ตบีตของความพร้อมใช้งานและการลงทะเบียนเพื่อตรวจสอบอย่างถูกต้อง
เผยแพร่ฮาร์ตบีตของความพร้อมใช้งาน
อินสแตนซ์แพ็กเกจบริการจะสร้างข้อความฮาร์ตบีตของบริการที่มีการประทับเวลา สร้างข้อความตามปกติ โดยปกติจะสร้างทันทีหลังจากที่เรียกใช้ตรรกะทางธุรกิจหลัก ฮาร์ตบีตของบริการจะระบุว่าแพ็กเกจบริการทำงานอยู่
ออบเจ็กต์อินสแตนซ์ Bundle ที่จะตรวจสอบต้องสร้างผู้เผยแพร่ประเภท ServiceHeartbeat ซึ่งมีอยู่ในไลบรารี libhealth_api ดังนี้
message ServiceHeartbeat {
// Required.
// The timestamp.
.google.protobuf.Timestamp timestamp = 1;
}
เลือกหัวข้อสื่อเผยแพร่ตามต้องการ ตัวแทน HM จะใช้การค้นหาตามประเภทข้อความเพื่อตรวจหาการเผยแพร่
เมื่อกำหนดค่าการตรวจสอบความพร้อมใช้งานผ่านการกำหนดค่าสถานภาพที่ลิงก์ในไฟล์ Manifest ของแพ็กเกจบริการที่เกี่ยวข้อง ตัวแทน HM จะคาดหวังให้มีการเผยแพร่ HB ทันทีที่อินสแตนซ์ดำเนินการตามกิจวัตร on_start เสร็จสิ้น เราขอแนะนำให้ใช้ on_start แบบสั้นๆ เพื่อหลีกเลี่ยงการบล็อกการเริ่มต้นระบบ ดังนั้นให้เผยแพร่ฮาร์ตบีตในงานแบบอะซิงโครนัสที่เริ่มต้นใน on_start
นักพัฒนาซอฟต์แวร์ Bundle สามารถปรับแต่งเวลาที่คาดว่าจะได้รับฮาร์ตบีตแรกได้โดยใช้รายการการกำหนดค่า initial_delay_ms
อินสแตนซ์ Bundle ควรเผยแพร่ฮาร์ตบีตต่อไปจนกว่าจะหยุดทำงาน ระบบจะถือว่าอินสแตนซ์หยุดทำงานเมื่อกิจวัตร on_stop เสร็จสิ้น
กรณีการใช้งานพิเศษ: ลงทะเบียนเพื่อตรวจสอบฮาร์ตบีตอย่างชัดแจ้ง
ลักษณะการทำงานที่อธิบายไว้ในการตรวจสอบฮาร์ตบีตเพื่อดูความพร้อมใช้งาน ซึ่งคาดว่าจะมีฮาร์ตบีตระหว่าง on_start และ on_stop เรียกว่าการตรวจสอบความพร้อมใช้งานโดยนัย วิธีนี้เป็นวิธีที่แนะนำในการใช้ฟีเจอร์นี้ เนื่องจากจะช่วยลดความซับซ้อนของตรรกะทางธุรกิจของแพ็กเกจและช่วยให้มั่นใจว่าแพ็กเกจจะได้รับการตรวจสอบอยู่เสมอ
อย่างไรก็ตาม อาจมีบางกรณีการใช้งานที่ระยะเวลาการตรวจสอบเริ่มต้นเป็นข้อจำกัด ดังนี้
- อินสแตนซ์แพ็กเกจบริการมีตรรกะทางธุรกิจที่เกิดขึ้นเป็นระยะๆ ในช่วงเวลาที่ไม่เชื่อมโยงกับเหตุการณ์
startและstopการตรวจสอบการทำงานอาจจำเป็นเฉพาะในช่วงเวลาที่กำหนดเองนี้เท่านั้น - HM จะติดตาม HB อย่างถูกต้องตลอดระยะเวลาที่ระงับและกลับมาทำงานอีกครั้ง ดังนั้น แพ็กเกจอาจต้องการให้ตรวจสอบต่อไปหลังวันที่
on_stop - ตัวแทน OEM ที่กำหนดเองอาจไม่ได้ติดตั้งใช้งานเป็นแพ็กเกจบริการ ดังนั้นจึงไม่สามารถใช้ประโยชน์จากการตรวจสอบความพร้อมใช้งานโดยนัยได้ อย่างไรก็ตาม คุณอาจยังต้องตรวจสอบความพร้อมใช้งานอยู่
ในกรณีเหล่านี้ HM จะช่วยให้คุณข้ามการลงทะเบียนโดยนัยเพื่อตรวจสอบความพร้อมใช้งานได้โดยใช้การลงทะเบียนอย่างชัดแจ้ง หากต้องการใช้การลงทะเบียนที่ชัดเจน อินสแตนซ์ Bundle ต้องเลือกไม่ใช้การลงทะเบียนโดยนัยโดยไม่รวมรายการประเภท HealthConfiguration สำหรับอินสแตนซ์นั้นๆ ในไฟล์ Manifest ของ Bundle จากนั้นในรันไทม์ อินสแตนซ์ Bundle ควรใช้ RPC API ที่กำหนดไว้ใน //system/software_defined_vehicle/health_monitor/catalog/health_monitor_registration_service.proto เพื่อลงทะเบียนและยกเลิกการลงทะเบียนจากการตรวจสอบด้วยตนเอง ระบบจะคาดหวังฮาร์ตบีตที่เผยแพร่ทันทีที่การเรียกใช้ RPC ของการลงทะเบียนสำเร็จ
ดูตัวอย่างการใช้งานได้ที่ //system/software_defined_vehicle/samples/health/stable/health_monitored_service_bundle/
การตรวจสอบ QoS
คุณภาพของการบริการ (QoS) คือการวัดผลการสื่อสาร HM จะตรวจสอบว่าข้อความที่ส่งใช้เวลาในการส่งนานเกินไปหรือไม่ หรือในกรณีของการสื่อสารเป็นระยะๆ จะตรวจสอบว่าได้รับข้อความตามความถี่ที่เลือกหรือไม่
SDV มีการสื่อสาร Pub/Sub และ RPC หลายรูปแบบ ตัวส่วนร่วมคือรูปแบบการสื่อสารทั้งหมดมีผู้ฟังอย่างน้อย 1 คน เพื่อให้ HM ตรวจสอบการสื่อสารได้ อินสแตนซ์แพ็กเกจบริการการฟังนี้ต้องเผยแพร่ฮาร์ตบีต QoS พิเศษทุกครั้งที่ได้รับข้อความที่สนใจ
การกำหนดค่า
หากต้องการเปิดใช้การตรวจสอบ QoS ของการสื่อสาร ให้ระบุ Listener การสื่อสารที่จะเผยแพร่ฮาร์ตบีต QoS ก่อน จากนั้นเพิ่มการแมปหัวข้อกับ QosMonitoringConfiguration อย่างน้อย 1 รายการในช่อง qos_config สำหรับอินสแตนซ์แพ็กเกจบริการที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่าแพ็กเกจต่อบริการ
topic คือสตริงที่กำหนดหัวข้อการเผยแพร่ที่ HM คาดหวัง QoS HB ขณะรันไทม์ อินสแตนซ์ Bundle การฟังสามารถมีส่วนร่วมในการสื่อสารหลายรายการและรายงาน QoS HB ในหลายหัวข้อได้
หัวข้อควรเป็นแบบอธิบาย เนื่องจากจะมีการรายงานกลับไปยังแพ็กเกจบริการ Listener ของ HM หากตรวจพบการละเมิด QoS ขณะรันไทม์
ประเภท QosMonitoringConfiguration กำหนดไว้ใน //system/software_defined_vehicle/health_monitor/catalog/health_config.proto ดังนี้
message QosMonitoringConfiguration {
// Optional - If absent, heartbeat frequency monitoring is disabled for this SB.
//
// The maximum allowable interval between consecutive heartbeats (in milliseconds).
// A QoS frequency violation is triggered if the time elapsed between
// two heartbeats exceeds this threshold.
optional uint64 qos_period_threshold_ms = 1;
// Optional - If absent, heartbeat latency monitoring is disabled for this SB.
//
// The maximum allowable interval between data publication and data processing timestamps (in milliseconds).
// A QoS latency violation is triggered if the time elapsed between
// data publication and data processing timestamps exceeds this threshold.
optional uint64 qos_latency_threshold_ms = 2;
}
สำหรับ Use Case เริ่มต้น ให้บังคับใช้การตรวจสอบ QoS ทั้ง 2 ประเภท qos_latency_threshold_ms จาก 30 เป็นค่าที่เหมาะสมสำหรับการสื่อสาร Pub/Sub ใน VM ภายใต้ภาระงานของระบบปกติ
ข้อควรพิจารณาเกี่ยวกับรันไทม์
เช่นเดียวกับการตรวจสอบ HB ของความพร้อมใช้งาน คาดว่าแพ็กเกจการฟังการสื่อสารจะเผยแพร่ประเภทฮาร์ตบีต ในกรณีนี้ ควรเผยแพร่ QoS HB ทุกครั้งที่ได้รับข้อความที่สนใจ แทนที่จะเผยแพร่เมื่อสิ้นสุดการดำเนินการตรรกะทางธุรกิจ
QoS HB เป็นประเภท QosHeartbeat ซึ่งกำหนดไว้ใน //system/software_defined_vehicle/health_monitor/catalog/qos_heartbeat.proto ดังนี้
message QosHeartbeat {
option (.sdv.vsidl.v1.publication) = {
message_count: 2
model: SINGLE_PUB
};
// Required.
// Current timestamp at heartbeat transmission. The heartbeat should be sent
// immediately after the listener receives the related QoS-monitored message.
.google.protobuf.Timestamp timestamp = 1;
// Required.
// Timestamp corresponding to the creation time of the underlying data. This
// implies that, in addition to the data of interest, the monitored message includes
// a data creation timestamp field. The listener is responsible for routing this
// timestamp to the QosHeartbeat upon receiving a QoS-monitored message.
.google.protobuf.Timestamp data_timestamp = 2;
}
เวลาในการลงทะเบียนและยกเลิกการลงทะเบียนการเผยแพร่ QoS HB มีความสำคัญต่อการตรวจสอบที่แม่นยำ HM คาดหวังว่าจะได้รับฮาร์ตบีต QoS ระหว่าง 2 เหตุการณ์นี้ แพ็กเกจการฟังข้อความควรลงทะเบียนการเผยแพร่ฮาร์ตบีต QoS เมื่อลงทะเบียนการสื่อสารที่ตรวจสอบกับสแต็กการสื่อสาร SDV HM สามารถใช้ API ความพร้อมใช้งานเพื่อดำเนินการนี้ได้ ดูข้อมูลเพิ่มเติมได้ที่ตรวจสอบความพร้อมให้บริการ
การตรวจสอบการกู้คืนแพ็กเกจบริการ
การกู้คืนอินสแตนซ์แพ็กเกจบริการได้รับการกำหนดค่าเป็นส่วนหนึ่งของไฟล์การกำหนดค่าตัวแทนการจัดการเรียบเรียง โปรดดูหัวข้อแพ็กเกจบริการเพื่อดูรายละเอียดทั้งหมดของหัวข้อนี้ ระบบย่อย HM จะสังเกตกระบวนการกู้คืนแบบพาสซีฟ เมื่อตรวจพบว่ากู้คืนอินสแตนซ์แพ็กเกจไม่สำเร็จ ระบบจะเพิ่มการละเมิดลงในรายงาน VMHealth การตรวจสอบการกู้คืนเป็นสิ่งที่จำเป็นและกำหนดค่าไม่ได้ ซึ่งแตกต่างจากความสามารถในการตรวจสอบอื่นๆ ของ HM
การขัดข้องของอินสแตนซ์แพ็กเกจบริการที่ไม่ได้กำหนดค่าสำหรับการกู้คืนจะสร้างการละเมิดด้านประสิทธิภาพการทำงานเมื่อเกิดการขัดข้องครั้งแรก
การกู้คืนอินสแตนซ์แพ็กเกจบริการออกแบบมาเพื่อผสานรวมกับการตรวจสอบการทำงานของฮาร์ตบีต ระบบ HM จะผ่อนปรนมากขึ้นเมื่อประเมินฮาร์ตบีตเมื่อตรวจพบว่า Bundle กำลังกู้คืน ในทางปฏิบัติ ความยืดหยุ่นนี้หมายความว่า Service Bundle ไม่จำเป็นต้องดำเนินการตรวจสอบเพิ่มเติม ขั้นตอนการยกเลิกการลงทะเบียนหรือการลงทะเบียนหากเกิดข้อขัดข้อง
การตรวจสอบข้อขัดข้องของ Agent
HM จะตรวจจับการขัดข้องที่อาจเกิดขึ้นของตัวแทน SDV โดยใช้กลไก Binder linkToDeath
คุณสามารถกำหนดค่าการตรวจสอบข้อขัดข้องเป็นส่วนหนึ่งของการกำหนดค่าประสิทธิภาพของ VM (ดูการกำหนดค่าอินสแตนซ์ SDV (VM) แต่ละรายการ) โดยเฉพาะฟิลด์ที่ซ้ำได้ monitored_agent ช่องนี้ควรมีรายการประเภท BinderServiceAgent ดังนี้
message BinderServiceAgent {
// agent_names must be unique across configuration
// used for HM internal agent identification, and naming entries in HM dumpsys report
string agent_name = 1;
// Binder interface name/identifier, e.g: "google.sdv.data_tunnel.IAgentService/default"
// HM Agent should have appropriate permissions to find the binder interface
// see also `sdv_crash_monitored_service` selinux attribute
string binder_interface_name = 2;
}
นอกจากนี้ยังตรวจสอบ Agent ที่กำหนดเองได้หาก Agent แสดงอินเทอร์เฟซ Binder หากต้องการตรวจสอบตัวแทนที่กำหนดเอง ให้ให้สิทธิ์ HM SELinux เพื่อฟังอินเทอร์เฟซ Binder ที่เหมาะสม
พร็อพเพอร์ตี้ระบบ ro.boot.sdv.health_monitor.agent_startup_timeout_sec สามารถลบล้างระยะเวลาที่ HM รอให้ Agent ลงทะเบียนอินเทอร์เฟซ Binder เมื่อ HM เริ่มทำงาน ค่าเริ่มต้น 3 วินาทีถือว่าเหมาะสม เว้นแต่ตัวแทนที่กำหนดเองจะกำหนดไว้เป็นอย่างอื่น
คู่มือนักพัฒนาซอฟต์แวร์สำหรับแพ็กเกจบริการ
ส่วนนี้จะให้คำแนะนำทีละขั้นตอนเกี่ยวกับวิธีใช้ฟีเจอร์ HM จากแพ็กเกจบริการ ซึ่งตรงกันข้ามกับการจัดการทางทฤษฎีในส่วนก่อนหน้า ตัวอย่างข้อมูลอ้างอิงล่าสุดที่ใช้เป็นพื้นฐานของคำแนะนำเหล่านี้คือตัวอย่าง qos_monitoring ทำตาม//system/software_defined_vehicle/samples/health/stable/qos_monitoring/READMEของตัวอย่างเพื่อรับประสบการณ์จริง
เพิ่มการตรวจสอบฮาร์ตบีตของความพร้อมใช้งานลงในแพ็กเกจบริการ
วิธีนี้เป็นวิธีที่ตรงที่สุดในการเปิดใช้การตรวจสอบประสิทธิภาพการทำงานสำหรับแพ็กเกจบริการ
กำหนดอินสแตนซ์ของ
ServiceBundleHealthConfigurationสำหรับอินสแตนซ์ Bundle ในไฟล์ชื่อhealth_configuration.textprotoดังนี้# health_bundle_configuration.textproto instance_config { key: "instance1" value: { health_config { initial_delay_ms: 1000 period_ms: 500 num_periods: 2 task_duration_ms: 200 } # qos_config entries irrelevant for this dev guide qos_config { ... } } }เพิ่มไฟล์การกำหนดค่าลงใน APEX ของแพ็กเกจบริการ ใน
Android.bpให้ทำดังนี้apex { name: "com.android.sdv.sample.oem.health.qos_monitoring", // ... prebuilts: [ // ... "com.android.sdv.sample.oem.health.qos_monitoring.health_config", ], } prebuilt_etc { name: "com.android.sdv.sample.oem.health.qos_monitoring.health_config", src: "health_configuration.textproto", filename: "health.textproto", // ... // Reduce prebuilt visibility to avoid adding it in another APEX. visibility: ["//system/software_defined_vehicle/samples/health/qos_monitoring/apex"], }จัดเก็บการกำหนดค่าความสมบูรณ์ใน APEX และตั้งค่า
health_config_pathในไฟล์ Manifest ดังนี้# sdv_service_bundles_manifest.textproto sdv_service_bundle_metadata { ... health_config_path: "etc/config/health_configuration.textproto" }ในคำจำกัดความ VSIDL ให้ตรวจสอบว่าแพ็กเกจเผยแพร่
com.android.sdv.health.ServiceHeartbeat:sdv_service_bundle { name: "SampleBundle" publisher { message: "com.android.sdv.health.ServiceHeartbeat" topic: "arbitrary-topic" capacity: 2 } }เพิ่มสิทธิ์ SDV ลงในแพ็กเกจเพื่อให้แพ็กเกจได้รับสิทธิ์ในการเผยแพร่ HB โดยทำดังนี้
publisher { type: "com.android.sdv.health.ServiceHeartbeat" }เผยแพร่ฮาร์ตบีตของบริการในโค้ดเป็นระยะๆ โดยเริ่มตั้งแต่
on_start:// ... fn on_start(&mut self) { // ... runtime.spawn(business_logic(self.context)) } async fn business_logic(context: ContextRef) -> SdvResult<()>{ // register HB publication let mw_comms = SdvComms { context }; let aliveness_hb_pub = create_publisher::<PublisherDescriptor<ServiceHeartbeat>>( &mw_comms, PublisherDescriptors::<ServiceHeartbeat>::ARBITRARY_TOPIC, ) .await?; loop{ // do business logic // ... // publish hb aliveness_hb_pub.publish(&ServiceHeartbeat { timestamp: MessageField(Some(Box::new(now.into()))), ..Default::default() })?; } }
กรณีการใช้งานพิเศษ: การลงทะเบียนอย่างชัดแจ้ง
สำหรับกรณีการใช้งานพิเศษอื่นๆ ที่แพ็กเกจต้องมีการตรวจสอบฮาร์ตบีตสำหรับวงจรที่กำหนดเอง (เช่น การตรวจสอบที่เริ่มต้นเร็วกว่าหรือสิ้นสุดช้ากว่าสถานะ STARTED มาตรฐาน) คุณสามารถใช้วิธีการลงทะเบียนที่ชัดเจนได้ดังนี้
เพิ่มไคลเอ็นต์
com.android.sdv.health.HealthMonitorRegistrationServiceในคำจำกัดความ VSIDL ดังนี้sdv_service_bundle { # ... client { service: "com.android.sdv.health.HealthMonitorRegistrationService" channel: "com-android-sdv-health-health-monitor-registration-service" } }เพิ่มสิทธิ์ SDV สำหรับการใช้ RPC การลงทะเบียน HB ของความพร้อมใช้งาน
# ... client { service: "com.android.sdv.health.HealthMonitorRegistrationService" channel: "com-android-sdv-health-health-monitor-registration-service" }ลงทะเบียนกับ HM ผ่าน RPC เช่น ใน
on_startหรือnewดังนี้let rpc_client = Self::new_client(comms).await?; let _ = rpc_client .RegisterConfiguration(&RegisterConfigurationRequest { config: Some(HealthConfiguration{ initial_delay_ms: 100, period_ms: 200, num_periods: 3, task_duration_ms: 40, special_fields: protobuf::SpecialFields::default(), }).into(), ..Default::default() }) .await .unwrap();เผยแพร่ HB
ยกเลิกการลงทะเบียนจากการตรวจสอบเมื่อไม่ต้องการใช้แล้ว โดยทำดังนี้
let _ = rpc_client .UnregisterConfiguration(&UnregisterConfigurationRequest { ..Default::default() }) .await .unwrap();
เพิ่มการตรวจสอบ QoS ในการสื่อสาร
ตรวจสอบว่าอินสแตนซ์แพ็กเกจบริการเป็นผู้ติดตามของหัวข้อชื่อ
fog-light-statusในแคตตาล็อก VSIDL โดยทำดังนี้subscriber { message: "QosMonitoredFogLightStatus" topic: "left-fog-light-status" }รูปแบบข้อความมีดังนี้
package com.android.sdv.sample.oem.health.qos_monitoring; import "google/protobuf/timestamp.proto"; message QosMonitoredFogLightStatus { // arbitrary fields related to business logic int32 status = 1; // A QoS-monitored message must include a timestamp field .google.protobuf.Timestamp timestamp = 2; }กำหนดอินสแตนซ์ของ
ServiceBundleHealthConfigurationสำหรับอินสแตนซ์ Bundle ในไฟล์health_configuration.textprotoที่มีการตรวจสอบ QoS ดังนี้# health_bundle_configuration.textproto instance_config { key: "instance1" value: { # aliveness HB monitoring config irrelevant for this dev guide health_config { ... } qos_config { key: "qos-hb-right-fog-light-status" value { qos_period_threshold_ms: 100 qos_latency_threshold_ms: 50 } } } }หัวข้อที่เลือกในช่อง
keyแสดงให้เห็นว่าระบบจะเผยแพร่ฮาร์ตบีต QoS ในหัวข้อนี้ ซึ่งช่วยให้ตรวจสอบหัวข้อที่ชื่อfog-light-statusได้เพิ่มไฟล์การกำหนดค่าลงใน APEX ของแพ็กเกจบริการ ใน
Android.bpให้ทำดังนี้apex { name: "com.android.sdv.sample.oem.health.qos_monitoring", // ... prebuilts: [ // ... "com.android.sdv.sample.oem.health.qos_monitoring.health_config", ], } prebuilt_etc { name: "com.android.sdv.sample.oem.health.qos_monitoring.health_config", src: "health_configuration.textproto", filename: "health.textproto", // ... // Reduce prebuilt visibility to avoid adding it in another APEX. visibility: ["//system/software_defined_vehicle/samples/health/qos_monitoring/apex"], }จัดเก็บการกำหนดค่าด้านประสิทธิภาพการทำงานใน APEX และตั้งค่า
health_config_pathในไฟล์ Manifest ดังนี้# sdv_service_bundles_manifest.textproto sdv_service_bundle_metadata { ... health_config_path: "etc/config/health_configuration.textproto" }ในคำจำกัดความ VSIDL ให้ตรวจสอบว่าแพ็กเกจเป็นผู้เผยแพร่ของ
com.android.sdv.health.QosHeartbeatดังนี้sdv_service_bundle { name: "SampleBundle" publisher { message: "com.android.sdv.health.QosHeartbeat" topic: "qos-hb-right-fog-light-status" capacity: 2 } }เพิ่มสิทธิ์ SDV ลงในแพ็กเกจเพื่อให้แพ็กเกจได้รับสิทธิ์ในการเผยแพร่ฮาร์ตบีต QoS โดยทำดังนี้
publisher { message: "com.android.sdv.health.QosHeartbeat" topic: "qos-hb-right-fog-light-status" }ลงทะเบียนการเผยแพร่ QoS HB เฉพาะเมื่อมีการลงทะเบียนการสื่อสารที่ตรวจสอบแล้วเท่านั้น ใช้ API ความพร้อมใช้งานจาก
libsdv_mw_clientlib:// Wait for monitored communication to be available let comms = SdvComms{context}; let registration_stream = create_registration_event_stream( &comms, SubscriberDescriptors::<QosMonitoredFogLightStatus>::LEFT_FOG_LIGHT_STATUS, ).await?; let mut registration_stream = Box::pin(registration_stream.filter(|e|e==Availability::Available)); registration_stream.next().await; // only when available, create QoS HB publication: let qos_hb_pub = create_publisher( &comms, PublisherDescriptors::<QosHeartbeat>::QOS_HB_LEFT_FOG_LIGHT_STATUS, ).await?; // ...เผยแพร่ฮาร์ตบีต QoS ทุกครั้งที่ได้รับข้อความ
// ... use tap::Pipe; fn flatten_mw<T: Send>( s: impl Stream<Item = SdvResult<Vec<T>>> + Send + Unpin, ) -> impl Stream<Item = SdvResult<T>> + Send + Unpin { s.flat_map(|v| match v { Ok(v) => v.into_iter().map(Ok).pipe(stream::iter).left_stream(), Err(err) => Err(err).pipe(future::ready).pipe(stream::once).right_stream(), }) } { // ... let data_stream = create_observer( &comms, SubscriberDescriptors::<QosMonitoredFogLightStatus>::LEFT_FOG_LIGHT_STATUS, SubscribeOptions::default() ) .pipe(flatten_mw) .await?; while let Some(data) = data_stream.next().await { // publish QoS HB. Note how data.timestamp is used to populate the field qos_hb_pub.publish( &QosHeartbeat { timestamp: SystemTime::now(), data_timestamp: data.timestamp, ..Default::default() } ) // use data // ... } }หากต้องการหยุดการตรวจสอบ QoS ให้วางออบเจ็กต์ผู้เผยแพร่โฆษณาโดยทำดังนี้
// ... drop(qos_hb_pub);
แก้ไขข้อบกพร่องในการตรวจสอบประสิทธิภาพการทำงาน
หากต้องการแก้ไขข้อบกพร่องและดูภาพรวมของระบบ ให้ใช้เครื่องมือ dumpsys เพื่อตรวจสอบสถานะการตรวจสอบประสิทธิภาพของ VM ดังนี้
adb shell dumpsys com.google.sdv.ISdvAgent/hm
รายงานจะแสดงรายละเอียดการกำหนดค่าการรายงานประสิทธิภาพของ VM, การกำหนดค่าแพ็กเกจ และสถานะการตรวจสอบ ต่อไปนี้คือตัวอย่างของรายงานดังกล่าว
AGENT NAME: SDV Agent dump - Health Monitor
AGENT FQIN: instance1:com.android.sdv.health.HealthMonitorServiceBundle/instance1
AGENT STATE: Started
----------------
----------------
INTERNAL STATE REPORTERS:
*NAME: VM health report period:
*REPORT:
100----------------
*NAME: Recovery monitor manager
*REPORT:
HEARTBEAT MONITORING:
NO ACTIVE MONITORS
QOS MONITORING:
NO ACTIVE MONITORS
RECOVERY MONITORING:
a. Agent monitoring:
MONITOR 0:
ID: Agent: sdv_vsidl_provider_agent
linked_binder: com.google.sdv.ISdvAgent/vsidl_provider
alive: true
MONITOR 1:
ID: Agent: sdv_someip_broker
linked_binder: com.google.sdv.ISdvAgent/someip_broker
alive: false
b. SB monitoring:
MONITOR 0:
ID: FQIN: instance1:com.android.sdv.test.orchestrator.OrchSampleInitialPowerState/sample-initial-power-state
Recovery State: Normal
Lifecycle State: Started
Health Status: Healthy
MONITOR 1:
ID: FQIN: instance1:com.android.sdv.sample.apex.provider.Provider/sample-provider-v1
Recovery State: Normal
Lifecycle State: Started
Health Status: Healthy
MONITOR 2:
ID: FQIN: instance1:com.sdv.google.display_safety.HarSdvVehicleDataPublisher/instance-1
Recovery State: Normal
Lifecycle State: Started
Health Status: Healthy
----------------
*NAME: Health monitor
*REPORT:
CURR TIMESTAMP(ns): 1775543863756836167
INTERNAL STATE:
background_thread running: true
should_run: true
----------------