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

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

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

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

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

Cloud-to-cloud projects support the following events in Cloud Logging:

ทรัพยากร Cloud Logging	เหตุการณ์
โปรเจ็กต์การดำเนินการของ Google Assistant	ข้อผิดพลาดของ Intent ของ SYNC
	ข้อผิดพลาดของ Intent QUERY
	ข้อผิดพลาดของ Intent EXECUTE
	ข้อผิดพลาดการแจ้งเตือน
	ข้อผิดพลาดในการลิงก์บัญชี
	SDK ของ Home ในพื้นที่ 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 โปรเจ็กต์ได้รับการตั้งค่าให้รับบันทึกข้อผิดพลาดโดยค่าเริ่มต้น และนักพัฒนาแอปสามารถเลือกรับบันทึกความสําเร็จได้เช่นกัน ซึ่งจะเป็นประโยชน์อย่างยิ่งในช่วงพัฒนาเมื่อวางแผนที่จะเก็บบันทึกทั้งหมดจากตัวแทนบางราย อาจมีค่าใช้จ่ายเพิ่มเติมสําหรับโปรเจ็กต์ของคุณหากมีโควต้าการบันทึกเกิน

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

1. ใน Actions on Google Console , go to the Projects page.

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

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

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

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

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

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

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

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

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

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

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

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

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