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