การตรวจสอบ Google Maps Platform

Cloud Monitoring จะรวบรวมเมตริกสำหรับ API และบริการของคุณ รวมถึงทรัพยากร Google Cloud Platform ที่คุณใช้ หัวข้อนี้จะอธิบายวิธีกำหนดค่า Cloud Monitoring และวิธีใช้งานเพื่อตรวจสอบการใช้งาน API, สร้างหน้าแดชบอร์ด และสร้างการแจ้งเตือน

Cloud Monitoring มีฟีเจอร์และตัวเลือกมากมาย หัวข้อนี้จะอธิบาย Cloud Monitoring และยกตัวอย่างเบื้องต้น ดูข้อมูลเกี่ยวกับฟีเจอร์ทั้งหมดรวมถึงตัวอย่างอื่นๆ ได้ในเอกสารประกอบของ Cloud Monitoring

กำหนดค่า Cloud Monitoring

การตรวจสอบช่วยให้คุณดูและจัดการเมตริกต่างๆ ได้ดังนี้

  • สำหรับโปรเจ็กต์เดียว
  • สำหรับหลายโปรเจ็กต์ภายในองค์กรเดียว
  • สำหรับหลายโปรเจ็กต์ในหลายองค์กร

ในการตรวจสอบว่าเมตริกสำหรับโปรเจ็กต์พร้อมใช้งาน ให้ทำดังนี้

  1. ใน Google Cloud Console ให้เลือกการตรวจสอบ ดังนี้

    ไปที่ Monitoring

  2. โปรดตรวจสอบว่าคุณได้เลือกโปรเจ็กต์ที่ถูกต้อง
  3. ในแผงการนำทางของการตรวจสอบ ให้คลิก > ทางด้านขวาของขอบเขตเมตริก ภาพหน้าจอต่อไปนี้แสดงหน้าที่ปรากฏขึ้นเมื่อเลือกโปรเจ็กต์ AllEnvironments

    ภาพหน้าจอของเมตริกที่มีการตรวจสอบสำหรับโปรเจ็กต์ แต่ละโปรเจ็กต์ รวมถึงรหัสโปรเจ็กต์และบทบาทจะแสดงรายการอยู่

ตารางที่มีป้ายกำกับเมตริกที่โปรเจ็กต์นี้ตรวจสอบจะแสดงโปรเจ็กต์ซึ่งมีเมตริกที่เข้าถึงได้ในขอบเขตเมตริกปัจจุบัน แต่ละแถวในตารางจะแสดงโปรเจ็กต์และบทบาทของโปรเจ็กต์นั้น

  • โปรเจ็กต์ที่กำหนดขอบเขต: โปรเจ็กต์นี้จะจัดเก็บการตรวจสอบระยะเวลาทำงาน นโยบายการแจ้งเตือน กลุ่ม และแดชบอร์ดที่คุณกำหนดค่าไว้ ขอบเขตของเมตริกและโปรเจ็กต์ที่กำหนดขอบเขตมีความสัมพันธ์แบบ 1:1 สำหรับตัวอย่างนี้ โปรเจ็กต์ AllEnvironments เป็นโปรเจ็กต์ที่กำหนดขอบเขต
  • โปรเจ็กต์ที่ตรวจสอบ: ขอบเขตเมตริกปัจจุบันจะแสดงเมตริกของโปรเจ็กต์ ในตัวอย่างนี้ โปรเจ็กต์ทดลองใช้และโปรเจ็กต์ที่ใช้งานจริงเป็นโปรเจ็กต์ที่มีการตรวจสอบ

ตารางที่ติดป้ายกำกับ โปรเจ็กต์ที่แสดงด้านล่างจะดูเมตริกของโปรเจ็กต์นี้จะแสดงโปรเจ็กต์ที่มีขอบเขตเมตริกรวมถึงโปรเจ็กต์ปัจจุบันได้ ภาพหน้าจอก่อนหน้าแสดงให้เห็นว่าไม่มีโปรเจ็กต์อื่นๆ ที่เข้าถึงเมตริกที่โปรเจ็กต์ AllEnvironments จัดเก็บไว้ได้

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเพิ่มและนำโปรเจ็กต์ออกที่หัวข้อกำหนดค่า Cloud Monitoring

สำรวจเมตริก

หากต้องการสำรวจข้อมูลเมตริก ให้สร้างแผนภูมิโดยใช้เครื่องมือสำรวจเมตริก ซึ่งรวมอยู่ใน Cloud Monitoring เช่น หากต้องการดูการใช้งานโควต้าของ API คุณสามารถใช้เครื่องมือสำรวจเมตริกเพื่อสร้างแผนภูมิที่แสดงข้อมูลล่าสุด

รูปภาพต่อไปนี้แสดงแผนภูมิที่มีรายละเอียดการใช้โควต้าสำหรับ Maps API

ภาพหน้าจอของข้อมูลเมตริกโควต้าสำหรับ Maps API ทั้งหมด โดยจะแสดงแผนภูมิแท่งซึ่งแต่ละส่วนของแท่ง HTE สอดคล้องกับ API ต่างๆ

ตัวอย่างนี้แสดงแผนภูมิแท่งแบบซ้อนที่ API แต่ละรายการแสดงด้วยส่วนของแท่งแผนภูมิ คุณสามารถสร้างแผนภูมิประเภทต่างๆ เช่น แผนภูมิเส้น แผนภูมิแท่ง และฮีตแมป คุณยังสร้างแผนภูมิเดียวที่แสดงเมตริกต่างๆ ได้สูงสุด 10 รายการ

ในภาพนี้:

  • ช่องประเภททรัพยากรและเมตริกทางด้านซ้ายของแผนภูมิจะกำหนดข้อมูลเมตริกที่แสดงในแผนภูมิ
  • คุณสามารถเลือกประเภทแผนภูมิได้จากเมนูแบบเลื่อนลงของประเภทแผนภูมิที่อยู่เหนือแผนภูมิ ในตัวอย่างนี้มีการตั้งค่าเป็นแผนภูมิแท่งแบบซ้อน
  • ช่วงเวลาเหนือแผนภูมิตั้งค่าไว้เป็น 1W (1 สัปดาห์)
  • ด้านล่างแผนภูมิเป็นรายการ service, quota_metric, method ของ API และ value ของเมตริกซึ่งเป็นตัวกำหนดข้อมูลของแผนภูมิ เลือกเพิ่มตัวกรองเพื่อใช้ข้อมูลนี้ในการปรับแต่งข้อมูลที่แสดง

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

แสดงแผนภูมิเมตริกเดียว

หากต้องการกำหนดค่าแผนภูมิโดยใช้เครื่องมือสำรวจเมตริก ให้ทำดังนี้

  1. ใน Cloud Console ให้เลือกการตรวจสอบ ดังนี้

    ไปที่ Monitoring

  2. ในแผงการนำทาง ให้เลือกเครื่องมือสำรวจเมตริก
  3. ในแถบเครื่องมือ ให้เลือกแผนภูมิแท่งแบบซ้อนจากเมนูแบบเลื่อนลงประเภทแผนภูมิเพื่อดูข้อมูลเมตริกเป็นแผนภูมิแท่ง
  4. เลือกช่วงเวลา เช่น 1W (1 สัปดาห์)
  5. ระบุข้อมูลที่จะปรากฏในแผนภูมิ หากต้องการใช้อินเทอร์เฟซที่ขับเคลื่อนโดยเมนูหรือป้อนตัวกรอง ให้เลือกแท็บการกำหนดค่า หากต้องการใช้ภาษาในการค้นหาของ Monitoring (MQL) ให้เลือกแท็บ MQL
    1. หากต้องการแผนภูมิการใช้งานโควต้า ให้เลือกโควต้าผู้บริโภคเป็นประเภททรัพยากร หรือหากคุณต้องการสร้างแผนภูมิสำหรับการใช้งาน API ให้เลือก API ที่ใช้แล้วหรือ Google Maps API (ดูส่วนเมตริกการใช้งานสำหรับรายละเอียดเพิ่มเติมเกี่ยวกับเมตริกการใช้งานที่ใช้ได้กับ Google Maps Platform API) วางเมาส์เหนือทรัพยากรแต่ละประเภทเพื่อดูคำอธิบาย
    2. สำหรับเมตริก ให้เลือกการใช้โควต้าอัตรา แผนภูมิจะอัปเดตโดยอัตโนมัติเพื่อแสดงข้อมูลเมตริก โปรดทราบว่ามีตัวเลือกโควต้าอื่นๆ สำหรับเมตริก วางเมาส์เหนือเมตริกแต่ละรายการเพื่อดูคำอธิบาย ดูข้อมูลเพิ่มเติมเกี่ยวกับช่องเครื่องมือสำรวจเมตริกได้ที่การเลือกเมตริกและการเลือกวิธีแสดงข้อมูลในแผนภูมิ
  6. (ไม่บังคับ) ใช้ตัวเลือกต่อไปนี้เพื่อปรับแต่งการแสดงผล
    1. หากต้องการระบุชุดย่อยของข้อมูลที่จะแสดง ให้เพิ่มตัวกรอง หากต้องการเพิ่ม ตัวกรอง ให้เลือกเพิ่มตัวกรอง แล้วสร้างกล่องโต้ตอบให้เสร็จสมบูรณ์ ดูข้อมูลเพิ่มเติมได้ที่กรองข้อมูลในแผนภูมิ เช่น หากต้องการดูข้อมูลของ API รายการเดียว ให้ทำดังนี้
      1. ในช่องป้ายกำกับ ให้เลือกเมธอด
      2. ในช่องการเปรียบเทียบ ให้เลือก = (เท่ากับ)
      3. ในช่องค่า ให้เลือกชื่อเมธอดที่ต้องการ คุณจะได้รับแจ้งให้เลือกชื่อเมธอดที่มีข้อมูลที่จะแสดง
      4. เลือกเสร็จสิ้น เพื่ออัปเดตแผนภูมิ
    2. หากต้องการจัดกลุ่มอนุกรมเวลาตามป้ายกำกับ ให้ใช้ช่องจัดกลุ่มตาม การเลือกค่าสำหรับช่องนี้จะเป็นการเลือกค่าสำหรับช่องผู้รวบรวมข้อมูลโดยอัตโนมัติ
    3. หากต้องการระบุวิธีรวมอนุกรมเวลา ให้ตั้งค่าช่อง Aggregator เช่น หากช่อง Group by ว่างเปล่าและมีการตั้งค่าช่อง Aggregator เป็นค่าเฉลี่ย แผนภูมิจะแสดงค่าเฉลี่ยของอนุกรมเวลา
    4. หากต้องการกำหนดค่าวิธีประมวลผลอนุกรมเวลาแต่ละรายการ ให้เลือกตัวเลือกขั้นสูง ดูข้อมูลเพิ่มเติมได้ที่การเลือกเมตริกเมื่อใช้เครื่องมือสำรวจเมตริก

  7. (ไม่บังคับ) เพิ่มลงในหน้าแดชบอร์ด

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

แผนภูมิที่มีเมตริกหลายรายการ

ในบางสถานการณ์ คุณอาจต้องการแสดงเมตริกหลายรายการในแผนภูมิเดียวกัน เช่น คุณอาจต้องการแสดงขีดจำกัดโควต้าในแผนภูมิเดียวกันกับที่แสดงการใช้งานโควต้า แผนภูมิจะแสดงเมตริกได้สูงสุด 10 รายการ

วิธีเพิ่มเมตริกลงในแผนภูมิที่มีอยู่

  1. ในแผนภูมิที่มีอยู่ ให้เลือกเพิ่มเมตริกอื่นที่ด้านล่างของหน้าจอ
  2. เลือกเมตริก จากนั้นระบุวิธีแสดงอนุกรมเวลาของเมตริกนั้นในลักษณะเดียวกับที่คุณกำหนดค่าเมตริกเดิมด้านบน

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสำรวจเมตริกได้ที่

สร้างหน้าแดชบอร์ด

แดชบอร์ดช่วยให้คุณดูและตรวจสอบข้อมูลอนุกรมเวลาเป็นคอลเล็กชันแผนภูมิได้ Cloud Monitoring จะรองรับแดชบอร์ดที่กำหนดไว้ล่วงหน้าและหน้าแดชบอร์ดที่กำหนดเอง ดังนี้

  • หน้าแดชบอร์ดที่กำหนดไว้ล่วงหน้าจะติดตั้งโดยอัตโนมัติสำหรับบริการ Google Cloud Platform ที่คุณใช้ หน้าแดชบอร์ดเหล่านี้กำหนดค่าไม่ได้
  • แดชบอร์ดที่กำหนดเองคือหน้าแดชบอร์ดที่คุณสร้าง แดชบอร์ดที่กำหนดเองช่วยให้คุณกำหนดข้อมูลที่ต้องการดูและวิธีดูข้อมูลนั้นได้ เช่น คุณแสดงข้อมูลเมตริก นโยบายการแจ้งเตือน และบันทึกที่จัดเก็บไว้ในโปรเจ็กต์ได้ คุณแสดงข้อมูลอนุกรมเวลาในแผนภูมิได้ โดยมีมาตรวัดหรือตารางสรุปสถิติ หรือในรูปแบบตาราง

หากต้องการสร้างหน้าแดชบอร์ดที่กำหนดเอง คุณจะใช้ Cloud Console หรือ Cloud Monitoring API ก็ได้ รูปภาพต่อไปนี้แสดงแดชบอร์ดที่กำหนดเองซึ่งมีแผนภูมิ 2 รายการ

  • แผนภูมิโควต้าทางด้านซ้าย
  • แผนภูมิจำนวน API ทางด้านขวา

ภาพหน้าจอของแดชบอร์ดที่กําหนดเองซึ่งแสดงแผนภูมิ 2 รายการ แผนภูมิด้านซ้ายคือแผนภูมิโควต้า ส่วนแผนภูมิด้านขวาคือแผนภูมิการใช้งาน API ทั้ง 2 แผนภูมิจะแสดงจุดเวลาบนแกนแนวนอน

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

หากคุณเลือกที่จะจัดการแดชบอร์ดที่กำหนดเองโดยใช้ Cloud Monitoring API เครื่องมือสำรวจเมตริกจะให้ยูทิลิตีที่มีประโยชน์ 2 รายการดังนี้

  • หากต้องการสร้างการแสดง JSON สำหรับแผนภูมิที่วางแผนจะเพิ่มลงในแดชบอร์ด ให้กำหนดค่าแผนภูมิด้วยเครื่องมือสำรวจเมตริก จากนั้นคุณจะเข้าถึงการแสดง JSON ได้จากรายการในเมนูตัวเลือกเพิ่มเติมของ ในแถบเครื่องมือเครื่องมือสำรวจเมตริก
  • หากต้องการระบุไวยากรณ์สำหรับตัวกรอง Monitoring ซึ่งใช้กับ Cloud Monitoring API ให้ใช้อินเทอร์เฟซที่ขับเคลื่อนด้วยเมนูของ Metrics Explorer เพื่อกำหนดค่าแผนภูมิ หลังจากเลือกเมตริกและตัวกรองแล้ว ให้เปลี่ยนเป็นโหมดตัวกรองโดยตรงเพื่อดูตัวกรอง Monitoring ที่เทียบเท่า

สร้างแดชบอร์ดที่กำหนดเอง

หากต้องการสร้างแดชบอร์ดที่กำหนดเอง ให้ทำดังนี้

  1. ใน Cloud Console ให้เลือกการตรวจสอบ ดังนี้

    ไปที่ Monitoring

  2. ในแผงการนำทาง ให้เลือกแดชบอร์ด
  3. ในหน้าภาพรวมของหน้าแดชบอร์ด ให้คลิกสร้างหน้าแดชบอร์ด
  4. สำหรับแผนภูมิแต่ละรายการที่ต้องการเพิ่มไปยังแดชบอร์ด ให้ทำดังนี้

    1. เลือกประเภทแผนภูมิจากเพิ่มแผนภูมิ หรือลากแผนภูมิจากไลบรารีไปยังพื้นที่กราฟ

      ระบบจะแสดงแผนภูมิที่กำหนดค่าล่วงหน้าของประเภทที่เลือก ตัวอย่างต่อไปนี้แสดงแผนภูมิเส้นและแผงการกำหนดค่า

      ภาพหน้าจอของเครื่องมือสำรวจเมตริกที่คุณใช้สร้างแผนภูมิเพื่อเพิ่มลงในหน้าแดชบอร์ด

    2. เลือกประเภททรัพยากรและเมตริก แล้วใช้ตัวกรองเช่นเดียวกับที่ทำด้านบนเมื่อสร้างแผนภูมิ

      ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกของคุณได้ที่เพิ่มวิดเจ็ตหน้าแดชบอร์ด

  5. (ไม่บังคับ) ในแถบเครื่องมือหน้าแดชบอร์ด ให้คลิกเพิ่มแผนภูมิเพื่อเพิ่มแผนภูมิอื่น จากนั้นทำซ้ำขั้นตอนก่อนหน้าเพื่อปรับแต่งแผนภูมิ
  6. เมื่อแก้ไขเสร็จแล้ว ให้เลือกลูกศรซ้ายเพื่อออกจากหน้าแดชบอร์ด หรือเลือกรายการในเมนูการตรวจสอบอื่นๆ ระบบจะบันทึกหน้าแดชบอร์ดโดยอัตโนมัติ

ดูแดชบอร์ด

หากต้องการดูแดชบอร์ด ให้ทำดังนี้

  1. ใน Cloud Console ให้เลือกการตรวจสอบ ดังนี้

    ไปที่ Monitoring

  2. ในแผงการนำทาง ให้เลือกแดชบอร์ด
  3. เลือกแดชบอร์ดที่กำหนดเองหรือแดชบอร์ดที่กำหนดไว้ล่วงหน้าจากรายการ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างหน้าแดชบอร์ดได้ที่

เมตริกการใช้งาน

เมตริก 2 กลุ่มสำหรับตรวจสอบการใช้งาน Google Maps Platform API ได้แก่ เมตริก Serviceruntime (ประเภททรัพยากร consumed_api) ใช้ได้กับ Google Cloud API และเมตริก Google Maps Platform ส่วนใหญ่ เมตริกเฉพาะของ Google Maps Platform API (ประเภททรัพยากร maps.googleapis.com/Api)

เมตริกทั้ง 2 รายการรองรับป้ายกำกับทรัพยากรชุดเดียวกันสำหรับการแยกการรับส่งข้อมูลการใช้งาน API ซึ่งได้แก่ project_id, service, method, version, location และ credential_id ดูคำอธิบายป้ายกำกับทรัพยากรในเอกสารประกอบสำหรับทรัพยากรเมตริกที่เกี่ยวข้อง

กลุ่มเมตริกแต่ละกลุ่มมีเมตริก 2 ประเภทสำหรับการตรวจสอบการใช้งาน ได้แก่ จำนวนคำขอและเวลาในการตอบสนองของคำขอ

ในเมตริกจำนวนคำขอ คุณสามารถแบ่งการเข้าชมการใช้งานตามป้ายกำกับเมตริก protocol, grpc_status_code, response_code และ response_code_class นอกจากนี้ คุณยังแยกตาม platform_type ในเมตริก Google Maps Platform ได้ด้วย

ในเมตริกขอเวลาในการตอบสนอง คุณสามารถแบ่งการเข้าชมการใช้งานตามป้ายกำกับเมตริก protocol, platform_type, response_code และ response_code_class ในเมตริก Google Maps Platform เท่านั้น

ดูรายละเอียดเพิ่มเติมเกี่ยวกับประเภทเมตริกและป้ายกำกับในเอกสารประกอบสำหรับกลุ่มเมตริกที่เกี่ยวข้อง

สถานะการตอบกลับและการแมปป้ายกำกับโค้ดตอบกลับ

ตารางด้านล่างแสดงการแมประหว่างรหัสสถานะการตอบกลับและโค้ดตอบกลับ HTTP ที่ตอบกลับคำขอ Google Maps Platform API และป้ายกำกับการตอบกลับที่มีอยู่ใน Cloud Monitoring: โค้ดตอบกลับ HTTP, คลาสโค้ดตอบกลับ HTTP และรหัสสถานะ GRPC รหัสสถานะ GRPC คือรหัสการตอบสนอง gRPC ที่เป็นตัวเลขสำหรับคำขอ gRPC หรือโค้ดที่เทียบเท่าของ gRPC สำหรับคำขอ HTTP

โค้ดตอบกลับที่แสดงผลในการตอบ API รายงานโค้ดตอบกลับไปยัง Monitoring แล้ว
สถานะ Maps API รหัสการตอบกลับ HTTP รหัสการตอบกลับ HTTP คลาสของโค้ดตอบกลับ HTTP รหัสสถานะ GRPC
ตกลง 200,
204,
302		 200,
204,
302		 2xx,
3xx		 0 (ดี)
DATA_NOT_AVAILABLE,
ไม่พบ
ZERO_RESULTS		 200 200, 404(1) 2xx,
4xx(1)		 5 (ไม่พบ)(1)
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง)
MAX_ROUTE_LENGTH_EXCEEDED
MAX_WAYPOINTS_EXCEEDED
ฯลฯ		 200,
400		 400 4xx 3 (ไม่ถูกต้อง)
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง/ขาดหายไป ขอข้อผิดพลาดในการแยกวิเคราะห์) 200,
400		 400 4xx 3 (ไม่ถูกต้อง)
REQUEST_DENIED 200, 403,
200, 400		 403,
401(1)		 4xx(1) 7 (PERMISSION_DENIED),
16 (ไม่ได้ตรวจสอบสิทธิ์)
OVER_DAILY_LIMIT
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
DailyLimitExceeded,
RateLimitExceeded,
userRateLimitExceeded 		200,
403,
429		 429(1) 4xx(1) 8 (ยกเว้นทรัพยากรแล้ว)
UNKNOWN_ERROR 200, 500,
503		 500(1),
503		 5xx(1) 2 (ไม่ทราบ)/13 (ภายใน)(1),
14 (ไม่พร้อมใช้งาน)
1 {1 สถานะการตอบสนองของ Maps API/3/5} 2002002002002002xx2xx2xx2xx2xx4044xx4xx4xx4xx4xx4xx4xx0OK5NOT_FOUNDNOT_FOUNDDATA_NOT_AVAILABLEZERO_RESULTS4004034034037PERMISSION_DENIEDREQUEST_DENIEDREQUEST_DENIED40116UNAUTHENTICATED429OVER_QUERY_LIMITdailyLimitExceededrateLimitExceededuserRateLimitExceeded5005xx2UNKNOWN13INTERNALUNKNOWN_ERROR คุณจะเห็นโค้ดตอบกลับทั้ง 2 รหัสได้ในช่วงเปลี่ยนผ่าน โค้ดตอบกลับที่แสดงผลในคำตอบของ Maps API จะไม่มีการเปลี่ยนแปลง ดูรายละเอียดของโค้ดตอบกลับที่รายงานในช่วงที่ผ่านมาได้ในเครื่องมือสำรวจเมตริก

สร้างการแจ้งเตือน

การแจ้งเตือนช่วยให้ทราบถึงปัญหาในแอปพลิเคชันของคุณอย่างทันท่วงทีเพื่อให้คุณแก้ไขปัญหาได้อย่างรวดเร็ว ใน Cloud Monitoring นโยบายการแจ้งเตือนจะอธิบายสถานการณ์ที่คุณต้องการรับการแจ้งเตือนและวิธีที่คุณต้องการรับการแจ้งเตือน

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

  • แจ้งเตือนฉันเมื่อจำนวนคำขอสำหรับ API ที่เฉพาะเจาะจงเกิน 1,000 คำขอต่อกรอบเวลา 5 นาที
  • แจ้งเตือนทีมที่พร้อมให้บริการเมื่อเปอร์เซ็นไทล์ที่ 90 ของการตอบกลับ HTTP 200 เกินเวลาในการตอบสนอง 100 มิลลิวินาทีสำหรับ API อย่างน้อย 3 รายการ

รูปภาพต่อไปนี้แสดงคำจำกัดความของการแจ้งเตือนเพื่อสร้างการแจ้งเตือนเมื่อจำนวนคำขอสำหรับ API เกิน 20 รายการในกรอบเวลา 5 นาที

ภาพหน้าจอของคําจํากัดความการแจ้งเตือนที่แสดงจํานวนคําขอ API สําหรับ Maps API ทั้งหมดเป็นบรรทัดเดียว และเกณฑ์การแจ้งเตือนเป็นเส้นแนวนอน

ในภาพนี้:

  • แผนภูมินี้จะแสดงจำนวนการเรียก API สำหรับ API ต่างๆ เมื่อเวลาผ่านไป
  • เส้นสีแดงจะแสดงเกณฑ์การแจ้งเตือน การเรียก API ที่เกินเกณฑ์นี้ในช่วงเวลา 5 นาทีจะทำให้มีการแจ้งเตือน ในตัวอย่างนี้ คุณจะเห็นว่า API จำนวน 1 รายการเกินขีดจำกัด

เมื่อเป็นไปตามเงื่อนไขของนโยบายการแจ้งเตือน Cloud Monitoring จะเปิดเหตุการณ์และการแจ้งเตือนปัญหา

  • เหตุการณ์คือระเบียนถาวรที่จัดเก็บข้อมูลเกี่ยวกับทรัพยากรที่มีการตรวจสอบเมื่อตรงตามเงื่อนไข เมื่อไม่เป็นไปตามเงื่อนไขแล้ว ระบบจะปิดเหตุการณ์โดยอัตโนมัติ คุณจะดูเหตุการณ์ทั้งหมดทั้งแบบเปิดและปิดได้โดยใช้หน้าแดชบอร์ดการแจ้งเตือน
  • คุณจะระบุบุคคลที่ได้รับการแจ้งเตือนเมื่อกำหนดค่านโยบายการแจ้งเตือน Monitoring จะรองรับช่องทางการแจ้งเตือนทั่วไป ซึ่งรวมถึงอีเมล, Cloud Mobile App และบริการต่างๆ เช่น PagerDuty หรือ Slack ดูรายการช่องทางการแจ้งเตือนทั้งหมดได้ที่ตัวเลือกการแจ้งเตือน

ประเภทการแจ้งเตือน

Cloud Monitoring รองรับการแจ้งเตือนหลายประเภท เช่น คุณสามารถกำหนดสิ่งต่อไปนี้

  • การแจ้งเตือนเกณฑ์ของเมตริก: เรียกให้แสดงการแจ้งเตือนหากเมตริกสูงขึ้นหรือลดลงจากค่าหนึ่งๆ ในกรอบเวลาระยะเวลาหนึ่งๆ หรือเมตริกเพิ่มขึ้นหรือลดลงตามเปอร์เซ็นต์ที่กำหนดไว้ล่วงหน้า
  • การแจ้งเตือนงบประมาณ: ตั้งกฎเกณฑ์เพื่อทริกเกอร์การแจ้งเตือนเมื่อค่าใช้จ่าย (ค่าใช้จ่ายจริงหรือค่าใช้จ่ายที่คาดการณ์ไว้) เกินเปอร์เซ็นต์ของงบประมาณ (ตามกฎที่คุณตั้งไว้) การแจ้งเตือนไม่ได้จำกัดการใช้งาน API แต่จะแจ้งเตือนเมื่อค่าใช้จ่ายของคุณใกล้ถึงจำนวนที่ระบุเท่านั้น
  • การแจ้งเตือนโควต้า: Google Cloud Platform สร้างโควต้าต่างๆ ที่คุณใช้ติดตามและจำกัดทรัพยากรที่โปรเจ็กต์หรือองค์กรใช้ได้ ใช้การแจ้งเตือนเพื่อส่งการแจ้งเตือนเมื่อการใช้งานใกล้ถึงขีดจำกัดโควต้า

ดูข้อมูลเพิ่มเติมได้ที่ประเภทของนโยบายการแจ้งเตือน

จัดการนโยบายการแจ้งเตือน

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

สร้างการแจ้งเตือน

เมื่อสร้างการแจ้งเตือน คุณจะทำสิ่งต่อไปนี้ได้

  • กำหนดเงื่อนไขที่จะทริกเกอร์การแจ้งเตือนโดยอิงตามข้อมูลเมตริก
  • กำหนดช่องทางการแจ้งเตือนที่จะใช้ส่งการแจ้งเตือน

ตัวอย่างด้านล่างแสดงวิธีตั้งค่าการทริกเกอร์การแจ้งเตือนเมื่ออัตราการใช้บริการ Google Maps Platform สำหรับ API เกิน 2 คำขอในช่วงเวลา 5 นาที

วิธีสร้างการแจ้งเตือนมีดังนี้

  1. ใน Cloud Console ให้เลือกการตรวจสอบ ดังนี้

    ไปที่ Monitoring

  2. เลือกแจ้งเตือน
  3. เลือกแก้ไขช่องทางการแจ้งเตือนเพื่อกำหนดว่าจะให้การแจ้งเตือนออกอย่างไร ในตัวอย่างนี้ คุณจะใช้ที่อยู่อีเมลของคุณ
    1. สำหรับแชแนลอีเมล ให้เลือกเพิ่มใหม่
    2. ป้อนอีเมลและชื่อที่แสดง
    3. เลือกบันทึก
  4. เลือกแจ้งเตือน
  5. เลือกสร้างนโยบาย
  6. เลือกช่วงเวลา เช่น 7 วัน
  7. ในส่วนเงื่อนไขการแจ้งเตือน ให้เลือกเงื่อนไขใหม่ ดังนี้
    1. คลิกเลือกเมตริก แล้วเลือก API ที่ใช้แล้วเป็นทรัพยากร และคลิกจำนวนคำขอเป็นเมตริก จากนั้นเลือกใช้
    2. (ไม่บังคับ) ด้านล่างแผนภูมิเป็นรายการของบริการ, quota_metric, เมธอด API และค่าเมตริก เลือกเพิ่มตัวกรองเพื่อกรองข้อมูลตามข้อมูลนี้ เช่น คุณใช้ตัวกรองเพื่อระบุว่าวิธีการต้องเท่ากับ google.places.Autocomplete.http จึงจะทริกเกอร์การแจ้งเตือนได้
    3. ในส่วนข้อมูลการเปลี่ยนรูปแบบ ให้เลือก 5 นาทีสำหรับกรอบเวลาเลื่อน และค่าเฉลี่ยสำหรับฟังก์ชันหน้าต่างเลื่อน
    4. เลือกถัดไป
  8. ในส่วนกำหนดค่าทริกเกอร์การแจ้งเตือน ให้ตั้งค่าเกณฑ์เป็น 2 เพื่อระบุให้เริ่มการแจ้งเตือนเมื่อมีคำขอมากกว่า 2 รายการในหน้าต่าง 5 นาที โปรดทราบว่าตอนนี้แผนภูมิจะแสดงเส้นสีแดงที่ระบุขีดจำกัดการแจ้งเตือนสำหรับช่วงเวลาที่เลือก คุณจะเห็นตำแหน่งที่จะมีการทริกเกอร์การแจ้งเตือนจากแผนภูมิ คุณใช้แผนภูมินี้เพื่อช่วยปรับขีดจํากัดได้ตามความจำเป็น
  9. คลิกถัดไป
  10. ในหน้ากำหนดค่าการแจ้งเตือนและสรุปผลการแจ้งเตือน ให้ทำดังนี้
    1. เลือกอีเมลที่คุณสร้างขึ้นสำหรับช่องทางการแจ้งเตือน
    2. ในส่วนตั้งชื่อการแจ้งเตือน ให้ป้อน My Test Alert
    3. เลือกสร้างนโยบาย
  11. สร้างคำขอ API ตรวจสอบว่าคุณได้ส่งคำขอ API มากกว่า 2 รายการภายใน 5 นาทีเพื่อสร้างอีเมลแจ้งเตือน
  12. หลังจากได้รับอีเมลสำหรับการแจ้งเตือน ให้ไปที่หน้าการแจ้งเตือน
    1. ในตารางที่แสดงการแจ้งเตือน ให้คลิกการแจ้งเตือนเพื่อดูข้อมูลเพิ่มเติม
    2. คลิกชื่อการแจ้งเตือนเพื่อดูข้อมูลเกี่ยวกับการแจ้งเตือน ซึ่งรวมถึงแผนภูมิที่แสดงเหตุการณ์ที่ทริกเกอร์การแจ้งเตือน

ดูข้อมูลเพิ่มเติมเกี่ยวกับการแจ้งเตือนได้ที่