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

เข้าถึงบันทึกเหตุการณ์ด้วย 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 ในโปรเจ็กต์ โปรดดูเอกสารประกอบต่อไปนี้

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