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 ดูรายละเอียดเพิ่มเติมเกี่ยวกับบทบาทและสิทธิ์ในการบันทึกข้อมูลได้ที่การควบคุมการเข้าถึงการบันทึกในระบบคลาวด์

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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