เข้าถึงบันทึกเหตุการณ์ด้วย Cloud Logging

คุณเข้าถึงบันทึกเหตุการณ์สำหรับการผสานรวมได้จาก 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

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

ซิงค์บันทึก

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

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

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

ตารางด้านล่างแสดงสคีมาของรายการ 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 ในโปรเจ็กต์ โปรดดูเอกสารประกอบต่อไปนี้

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