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

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

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

กำหนดค่า Cloud Monitoring

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

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

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

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

    ไปที่การตรวจสอบ

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

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

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

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

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

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

สำรวจเมตริก

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

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

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

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

ในรูปภาพนี้

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

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

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

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

  1. ในคอนโซล Cloud ให้เลือก Monitoring ดังนี้

    ไปที่การตรวจสอบ

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

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

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

สร้างแผนภูมิเมตริกหลายรายการ

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

หากต้องการเพิ่มเมตริกลงในแผนภูมิที่มีอยู่ ให้ทำดังนี้

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. ในคอนโซล Cloud ให้เลือก Monitoring ดังนี้

    ไปที่การตรวจสอบ

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

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

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

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

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

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

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

ดูแดชบอร์ด

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

  1. ในคอนโซล Cloud ให้เลือก 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 โค้ดตอบกลับที่รายงานไปยังการตรวจสอบ
สถานะ Maps API โค้ดตอบกลับ HTTP โค้ดตอบกลับ HTTP คลาสโค้ดตอบกลับ HTTP รหัสสถานะ GRPC
ตกลง 200,
204,
302		 200,
204,
302		 2xx,
3xx		 0 (OK)
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS		 200 200, 404(1) 2xx,
4xx(1)		 5 (NOT_FOUND)(1)
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
ฯลฯ		 200,
400		 400 4xx 3 (INVALID_ARGUMENT)
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง/ขาดหายไป, ข้อผิดพลาดในการแยกวิเคราะห์คำขอ) 200,
400		 400 4xx 3 (INVALID_ARGUMENT)
REQUEST_DENIED 200, 403,
200, 400		 403,
401(1)		 4xx(1) 7 (PERMISSION_DENIED),
16 (UNAUTHENTICATED)
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 (UNKNOWN)/13 (INTERNAL)(1),
14 (UNAVAILABLE)
1 เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด API ของ Google Maps Platform กำลังย้ายข้อมูลดังนี้ 1) จากรหัส/คลาสการตอบกลับ HTTP 200/2xx ไปเป็น 404/4xx (และรหัสสถานะ GRPC จาก 0 (OK) ไปเป็น 5 (NOT_FOUND)) สำหรับสถานะ Maps API: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - สถานะ, 2) จากรหัส/คลาสการตอบกลับ HTTP 200/2xx,400/4xx ไปเป็น 403/4xx (และรหัสสถานะ GRPC 7 (PERMISSION_DENIED)) สำหรับสถานะ Maps API: REQUEST_DENIED, 3) จากรหัส/คลาสการตอบกลับ HTTP 200/2xx,403/4xx ไปเป็น 401/4xx (รหัสสถานะ GRPC 16 (UNAUTHENTICATED)) สำหรับสถานะ Maps API: REQUEST_DENIED, 4) จากรหัส/คลาสการตอบกลับ HTTP 200/2xx,403/4xx ไปเป็น 429/4xx สำหรับสถานะ Maps API: OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 5) จากรหัส/คลาสการตอบกลับ HTTP 200/2xx ไปเป็น 500/5xx (และรหัสสถานะ GRPC 2 (UNKNOWN), 13 (INTERNAL)) สำหรับสถานะ Maps API: UNKNOWN_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 หนึ่งที่เกินขีดจำกัด

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

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

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

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

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

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

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

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

สร้างข้อความแจ้งเตือน

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

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

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

หากต้องการสร้างการแจ้งเตือน ให้ทำดังนี้

  1. ในคอนโซล Cloud ให้เลือก Monitoring ดังนี้

    ไปที่การตรวจสอบ

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

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