ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ

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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

คุณเข้าถึงบันทึกเหตุการณ์สําหรับการผสานรวมได้จาก Google Cloud Logging ใช้ Cloud Logging เพื่อสํารวจบันทึก สร้างเมตริกและการแจ้งเตือน หรือส่งออกบันทึกไปยังแอปพลิเคชันอื่นๆ โดยใช้ Google Cloud Pub/Sub

การบันทึกการเข้าถึง

หากต้องการเข้าถึง Cloud Logging จาก Google Cloud Platform 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 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 ระบุสถานะของการแจ้งเตือน

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

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

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

  1. ไปที่หน้าโปรเจ็กต์ในคอนโซลการดําเนินการ

    เปิดคอนโซล Actions

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

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

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

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

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

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

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

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

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

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

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