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

ระบบคลาวด์สู่ระบบคลาวด์    กรณี

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

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

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

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

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

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

ทรัพยากรการบันทึกระบบคลาวด์	เหตุการณ์
โปรเจ็กต์การดำเนินการของ Google Assistant	ซิงค์ข้อผิดพลาดเกี่ยวกับ Intent
	ข้อผิดพลาดเกี่ยวกับ Intent QUERY
	EXECUTE ข้อผิดพลาดเกี่ยวกับ Intent
	ข้อผิดพลาดการแจ้งเตือน
	ข้อผิดพลาดการลิงก์บัญชี
	Local Home SDK HandlerError

ซิงค์บันทึก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เมตริกที่อิงตามบันทึก

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

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

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

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

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