เข้าถึงบันทึกเหตุการณ์ด้วย 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 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 บ่งบอกสถานะของการตอบสนองความตั้งใจ เช่น SUCCESS, PENDING หรือ OFFLINE สําหรับการตอบกลับ ERROR พร็อพเพอร์ตี้นี้มี errorCode ที่ได้จากการดําเนินการตามคําสั่งซื้อ
externalDebugString ข้อความการแก้ไขข้อบกพร่องโดยละเอียดที่ไม่บังคับซึ่งเชื่อมโยงกับการดําเนินการของผู้ใช้รายนี้
locale รหัสภาษาที่เชื่อมโยงกับคําขอ

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

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

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

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

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

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

  1. ไปที่หน้าโครงการใน Actions on Google Console

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

  2. เลือกโปรเจ็กต์บ้านอัจฉริยะ

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

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

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

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

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

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

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

หากต้องการเริ่มใช้เมตริกตามบันทึกสําหรับบ้านอัจฉริยะ โปรดดูการสร้างคู่มือเมตริกตามบันทึก

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

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