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 ได้รับการตั้งค่าให้รับบันทึกข้อผิดพลาดโดยค่าเริ่มต้น และนักพัฒนาซอฟต์แวร์สามารถเลือกรับบันทึกความสำเร็จได้ด้วย ซึ่งจะมีประโยชน์อย่างยิ่งในระยะการพัฒนาเมื่อคุณวางแผนที่จะบันทึกบันทึกทั้งหมดจากตัวแทน 2-3 ราย ระบบอาจเรียกเก็บเงินเพิ่มเติมจากโปรเจ็กต์ของคุณหากคุณ ใช้ โควต้า Logging เกิน

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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