การตรวจสอบแพลตฟอร์ม Google Maps

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

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

กำหนดค่า Cloud Monitoring

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

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

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

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

    ไปที่ 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 เมธอด API และค่าเมตริกซึ่งระบุข้อมูลของแผนภูมิ เลือกเพิ่มตัวกรองเพื่อใช้ข้อมูลนี้ในการปรับแต่งข้อมูลที่แสดง

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • หากต้องการสร้างการแสดงแทน JSON สำหรับแผนภูมิที่มีแผนจะเพิ่มลงในหน้าแดชบอร์ด ให้กำหนดค่าแผนภูมิด้วยเครื่องมือสำรวจเมตริก จากนั้นคุณจะเข้าถึงการแสดง JSON ได้จากรายการในเมนูตัวเลือกเพิ่มเติมของ ในแถบเครื่องมือเครื่องมือสำรวจเมตริก
  • หากต้องการระบุไวยากรณ์สำหรับตัวกรอง Monitoring ที่ใช้กับ 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 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,
NOT_FOUND,
ZERO_RESULTS		 200 200/404(1) 2xx/4xx(1) 5 (ไม่พบ)(1)
NOT_FOUND (API แบบคงที่ของ Street View, ตำแหน่งทางภูมิศาสตร์ และถนน)
ZERO_RESULTS (Street View Static API)		 404 404 4xx 5 (ไม่พบ)
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง)
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
ฯลฯ		 200/400 400 4xx 3 (ไม่ถูกต้อง)
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง/ไม่มีพารามิเตอร์ ข้อผิดพลาดในการแยกวิเคราะห์คําขอ) 200/400 400 4xx 3 (ไม่ถูกต้อง)
ส่งคำขอถูกปฏิเสธ 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 (เปิดใช้ทรัพยากรแล้ว)
ข้อผิดพลาดที่ไม่ทราบสาเหตุ 200/500,
503		 500(1),
503		 5xx(1) 2 (ไม่ทราบ)/13 (ภายใน)(1),
14 (ไม่พร้อมให้บริการ)
1 {1 {1: สถานะการตอบสนองของ Maps API / สถานะ API (3} 200: สถานะ Maps API/3: 200: 2003: 200: สถานะการตอบสนองของ Maps/3 / 200: {1: สถานะการตอบสนองของ Maps / API/3} ({1:} {4: API/5: สถานะ API/3} {1: และ: , 200, สถานะการตอบสนองของ Maps/คลาส} 200/3} (และ , 4xx: {1:}, NOT_FOUND, ZERO_RESULTS - {4xx รหัสการตอบสนอง เป็น {1/12} เป็น 2xx2xx2xx2xx2xx4044xx4xx4xx4xx4xx0OK5NOT_FOUNDDATA_NOT_AVAILABLE4004034034037PERMISSION_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. ใน Cloud Console ให้เลือก Monitoring:

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

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