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

ระบบคลาวด์สู่ระบบคลาวด์    Matter

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

การบันทึกการเข้าถึง

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

ไปที่ Cloud Logging

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

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

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

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

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

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

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

ทรัพยากร Cloud Logging	กิจกรรม
โปรเจ็กต์การดำเนินการของ Google Assistant	ข้อผิดพลาดเกี่ยวกับ Intent SYNC
	ข้อผิดพลาดเกี่ยวกับความตั้งใจของ QUERY
	ข้อผิดพลาดของ Intent EXECUTE
	ข้อผิดพลาด ในการแจ้งเตือน
	ข้อผิดพลาดเกี่ยวกับการลิงก์บัญชี
	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	ระบุสถานะของการตอบสนองต่อความตั้งใจ เช่น SUCCESS, PENDING หรือ OFFLINE สำหรับการตอบกลับ ERROR พร็อพเพอร์ตี้นี้จะมี errorCode ที่ได้จากการดำเนินการตามคำขอ
externalDebugString	ข้อความการแก้ไขข้อบกพร่องโดยละเอียด (ไม่บังคับ) ที่เชื่อมโยงกับการดำเนินการของผู้ใช้นี้
locale	รหัสภาษาที่เชื่อมโยงกับคำขอ

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

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

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

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

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

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

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

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

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

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

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

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

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

คุณสามารถทำตามขั้นตอนการสร้างตัวกรอง "ยกเว้น" ได้ที่คู่มือนี้ (กำหนดค่าตัวกรอง "ยกเว้น" สำหรับซิงก์ _Default)

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

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

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

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

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

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