Cloud Logging สำหรับระบบนิเวศของ Google Home

Cloud-to-cloud    Matter

คุณเข้าถึงบันทึกเหตุการณ์สําหรับการผสานรวมได้จาก Google Cloud Logging ใช้ Cloud Logging เพื่อสํารวจบันทึก สร้างเมตริกและการแจ้งเตือน หรือ ส่งออกบันทึกไปยังแอปพลิเคชันอื่นๆ โดยใช้ Google Cloud Pub/Sub

การเข้าถึง Logging

หากต้องการเข้าถึง Cloud Logging จาก Google Cloud Console, ให้คลิก สินค้าทั้งหมด แล้วไปที่ การดำเนินการ > การบันทึก

ไปที่ Cloud Logging

ระบบจะจัดการการเข้าถึงข้อมูล Logging ผ่าน Identity and Access Management (IAM) สําหรับผู้ใช้โปรเจ็กต์ Actions ดูรายละเอียดเพิ่มเติมเกี่ยวกับบทบาทและสิทธิ์สําหรับ ข้อมูล Logging ได้ที่Cloud Logging การควบคุมการเข้าถึง

ระบบจะเก็บรายการบันทึกไว้เป็นเวลา 30 วันตามนโยบายการเก็บรักษา Cloud Logging แล้วกำหนดเวลาให้ลบ นอกจากนี้ คุณยังลบรายการตามต้องการได้โดยใช้อินเทอร์เฟซ Logs Explorer

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

Cloud Logging มีทรัพยากรประเภทต่อไปนี้

ประเภททรัพยากร	ชื่อที่แสดง	คำอธิบาย	ป้ายกำกับ
assistant_action_project	โปรเจ็กต์การดำเนินการของ Google Assistant	คอนเทนเนอร์สําหรับโปรเจ็กต์ Google Cloud ที่เชื่อมโยงกับการดำเนินการของ Assistant Action	project_id: ตัวระบุโปรเจ็กต์ปัจจุบันที่เชื่อมโยงกับทรัพยากรนี้ เช่น my-project

บันทึกเหตุการณ์

Cloud-to-cloud โปรเจ็กต์รองรับเหตุการณ์ต่อไปนี้ใน Cloud Logging:

ทรัพยากร Cloud Logging	กิจกรรม
โปรเจ็กต์การดำเนินการของ Google Assistant	ข้อผิดพลาดของ Intent SYNC
	ข้อผิดพลาดของ IntentQUERY
	EXECUTEEXECUTE
	ข้อผิดพลาด ของการแจ้งเตือน
	ข้อผิดพลาด ในการลิงก์บัญชี
	Local Home SDK HandlerError

บันทึกการซิงค์

ตารางด้านล่างแสดงสคีมาของรายการ syncLog

พร็อพเพอร์ตี้	คำอธิบาย
requestId	รหัสคําขอ Intent สมาร์ทโฮม
httpLatencyMsec	เวลาที่ผ่านไปก่อนที่จะได้รับคําตอบ
status	ระบุสถานะของการตอบกลับ Intent

บันทึกการดำเนินการ

ตารางด้านล่างแสดงสคีมาของรายการ executionLog

พร็อพเพอร์ตี้	คำอธิบาย
requestId	รหัสคําขอที่ไม่ซ้ำกัน เช่น 5325511189174727525
latencyMsec	เวลาที่ผ่านไปก่อนที่จะได้รับคําตอบ เช่น 6000
executionType	การขนส่งที่ใช้สําหรับคําขอ เช่น CLOUD หรือ MATTER ทั้งนี้ขึ้นอยู่กับการผสานรวม
actionType	ตัวบ่งชี้การดำเนินการของผู้ใช้ที่เลือกได้ เช่น QUERY หรือ EXECUTE. สําหรับการดำเนินการ EXECUTE จะรวมถึงคําสั่งที่ส่งไปยังการดำเนินการตามคําสั่งสําหรับลักษณะที่รองรับ เช่น ONOFF_OFF
trait	ลักษณะที่เลือกได้ซึ่งเชื่อมโยงกับการดำเนินการของผู้ใช้รายนี้
deviceTypes	รายการประเภทอุปกรณ์ที่ได้รับผลกระทบจากเหตุการณ์ เช่น LIGHT.
isSuccess	คําขอได้รับการตอบกลับที่สําเร็จหรือไม่
fallbackToCloud	คําขอถูกส่งไปยังการดำเนินการตามคําสั่งบนระบบคลาวด์หลังจากเกิดข้อผิดพลาด จากการดำเนินการตามคําสั่งในเครื่องหรือไม่
statusType	ระบุสถานะของการตอบกลับ Intent เช่น SUCCESS, PENDING, หรือ OFFLINE. สําหรับการตอบกลับ ERROR พร็อพเพอร์ตี้นี้จะมี errorCode ที่การดำเนินการตามคําสั่งระบุ
externalDebugString	ข้อความการแก้ไขข้อบกพร่องโดยละเอียดที่เลือกได้ซึ่งเชื่อมโยงกับการดำเนินการของผู้ใช้รายนี้
locale	รหัสภาษาที่เชื่อมโยงกับคําขอ

บันทึกการแจ้งเตือน

ตารางด้านล่างแสดงสคีมาของรายการ notificationLog

พร็อพเพอร์ตี้	คำอธิบาย
requestId	รหัสคําขอการแจ้งเตือน
structName	ชื่อโครงสร้างการแจ้งเตือน เช่น "ObjectDetection"
status	ระบุสถานะของการแจ้งเตือน

การตั้งค่าระดับการบันทึก

โปรเจ็กต์ Cloud-to-cloud ได้รับการตั้งค่าให้รับบันทึกข้อผิดพลาดโดยค่าเริ่มต้น และนักพัฒนาซอฟต์แวร์สามารถเลือกรับบันทึกความสําเร็จได้ด้วย ซึ่งจะมีประโยชน์อย่างยิ่งในระยะการพัฒนาเมื่อคุณวางแผนที่จะบันทึกบันทึกทั้งหมดจากเอเจนต์บางราย โปรเจ็กต์ของคุณอาจมีค่าใช้จ่ายเพิ่มเติมหากคุณ ใช้ โควต้า Logging เกิน

คุณสามารถควบคุมระดับการบันทึกสําหรับโปรเจ็กต์ได้โดยทําดังนี้

1. ใน Actions on Google Console ให้ไปที่หน้าโปรเจ็กต์

   ไปที่คอนโซล Actions on Google

2. เลือกโปรเจ็กต์สมาร์ทโฮม

3. เลือกแท็บพัฒนา แล้วคลิกการดำเนินการ ในแถบด้านข้าง

4. เลือกทั้งหมด ในรายการแบบเลื่อนลงการควบคุมการนำเข้าบันทึก

การยกเว้นบันทึก

นักพัฒนาซอฟต์แวร์สามารถสร้าง การยกเว้นบันทึก โดยใช้ ภาษาการค้นหา Logging เพื่อปรับแต่งบันทึกเพิ่มเติมด้วยวิธีที่ยืดหยุ่นมากขึ้น นอกจากนี้ Logs Explorer ยังใช้ภาษาการค้นหา Logging ด้วย คุณจึงใช้ Logs Explorer เพื่อช่วยสร้างการค้นหาได้

คุณสามารถทําตามขั้นตอนในการสร้างตัวกรองการยกเว้นได้ที่ คู่มือนี้ (กําหนดค่าตัวกรองการยกเว้นสําหรับ _Default Sink)

เมตริกตามบันทึก

นักพัฒนาซอฟต์แวร์สามารถใช้ เมตริกตามบันทึก เพื่อติดตามและวิเคราะห์รูปแบบภายในบันทึกได้ นอกจากนี้ คุณยังสร้างแผนภูมิที่กําหนดเอง และ ตั้งค่าการแจ้งเตือน เกี่ยวกับเมตริกตามบันทึกได้ด้วย

หากต้องการเริ่มใช้เมตริกตามบันทึกสำหรับสมาร์ทโฮม โปรดดู คู่มือการสร้างเมตริกตามบันทึกแบบเคาน์เตอร์

แหล่งข้อมูลที่เกี่ยวข้อง

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Cloud Logging ในโปรเจ็กต์ได้ใน เอกสารประกอบต่อไปนี้:

• การกําหนดราคา: รายละเอียดเกี่ยวกับการจัดสรรและค่าใช้จ่ายส่วนเกิน
• โควต้าและขีดจํากัด: รายละเอียดเกี่ยวกับขีดจํากัดและนโยบายการเก็บรักษาสำหรับการใช้งาน Logging
• การค้นหาบันทึกขั้นสูง: คู่มือการใช้นิพจน์ขั้นสูงเพื่อค้นหาและวิเคราะห์ข้อมูลบันทึก