การตรวจสอบ 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 คือโปรเจ็กต์กำหนดขอบเขต
  • โปรเจ็กต์ที่ตรวจสอบแล้ว: เมตริกสำหรับ อยู่ในขอบเขตเมตริกปัจจุบัน ในตัวอย่างนี้ โปรเจ็กต์เวอร์ชันทดลองใช้และเวอร์ชันที่ใช้งานจริงเป็นโปรเจ็กต์ที่มีการตรวจสอบ

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

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

สำรวจเมตริก

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

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

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

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

ในรูปภาพนี้:

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

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

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

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

  1. ใน Cloud Console ให้เลือก Monitoring:

    ไปที่ Monitoring

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. ใน Cloud Console ให้เลือก Monitoring:

    ไปที่ Monitoring

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

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

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

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

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

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

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

ดูแดชบอร์ด

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

  1. ใน Cloud Console ให้เลือก Monitoring:

    ไปที่ Monitoring

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

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

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

กลุ่มเมตริก 2 กลุ่มมีไว้เพื่อตรวจสอบการใช้งาน Google Maps Platform API ได้แก่ เมตริก Serviceruntime (ประเภททรัพยากร consumed_api) ใช้ได้กับ Google Cloud APIs ส่วนใหญ่ และเมตริก 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 (ตกลง)
ไม่มีข้อมูล
ไม่พบ
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
แหล่งข้อมูลที่ส่งออกแล้ว
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) จากโค้ดตอบกลับ 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 จะเปิดขึ้นเมื่อเป็นไปตามเงื่อนไขของนโยบายการแจ้งเตือน การแจ้งเตือนเหตุการณ์และปัญหา:

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

    ไปที่ Monitoring

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

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