การบันทึกในระบบคลาวด์สําหรับระบบคลาวด์สู่ระบบคลาวด์

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

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