การตรวจสอบ 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. ในแผงการนำทางของ Monitoring ให้คลิก > ทางด้านขวาของขอบเขตเมตริก ภาพหน้าจอต่อไปนี้แสดงหน้าที่ปรากฏเมื่อเลือกโปรเจ็กต์ AllEnvironments

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

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

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

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

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

สำรวจเมตริก

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

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

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

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

ในภาพนี้:

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

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

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

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

  1. เลือก Monitoring ใน 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 ตัวอย่างเช่น หากช่องจัดกลุ่มตามว่างเปล่าและมีการตั้งช่องผู้รวบรวมข้อมูลเป็นค่าเฉลี่ย แผนภูมิจะแสดงค่าเฉลี่ยของอนุกรมเวลา
    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 ให้ใช้อินเทอร์เฟซที่ขับเคลื่อนด้วยเมนูของเครื่องมือสำรวจเมตริกเพื่อกำหนดค่าแผนภูมิ หลังจากเลือกเมตริกและตัวกรองแล้ว ให้เปลี่ยนไปใช้โหมดตัวกรองโดยตรงเพื่อดูตัวกรอง Monitoring ที่เทียบเท่า

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

วิธีสร้างหน้าแดชบอร์ดที่กำหนดเองมีดังนี้

  1. เลือก Monitoring ใน Cloud Console ดังนี้

    ไปที่ Monitoring

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

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

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

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

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

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

ดูแดชบอร์ด

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

  1. เลือก Monitoring ใน 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 (RESOURCE_EXHAUSTED)
UNKNOWN_ERROR 200, 500,
503
500(1),
503
5xx(1) 2 (ไม่ทราบ)/13 (ภายใน)(1),
14 (ไม่พร้อมใช้งาน)
{1 เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด Google Maps Platform API: 1) 200โค้ดตอบกลับ HTTP/คลาส/คลาส200/2xx {3/1} {1/2/3} {1/2/3}, {1/2/3}, {1/2/3} เป็น (OK) เป็น (OK) เป็น (OK) เป็น 5 (NOT_FOUND) สำหรับ สถานะ API: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - {4xx {รหัสการตอบกลับ} เป็น {1/2}{4xx}2002002002xx2xx2xx2xx4044xx4xx4xx4xx4xx04004034034037PERMISSION_DENIEDREQUEST_DENIEDREQUEST_DENIED40116UNAUTHENTICATED429OVER_QUERY_LIMITdailyLimitExceededrateLimitExceededuserRateLimitExceeded5005xx2UNKNOWN13INTERNALUNKNOWN_ERROR คุณจะเห็นโค้ดตอบกลับทั้งสองได้ในช่วงระยะเวลาการเปลี่ยนแปลง โค้ดตอบกลับที่แสดงในการตอบกลับของ 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. เลือก Monitoring ใน Cloud Console ดังนี้

    ไปที่ Monitoring

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

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