การตรวจสอบ 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

สำรวจเมตริก

หากต้องการสำรวจข้อมูลเมตริก ให้สร้างแผนภูมิโดยใช้ Metrics Explorer ซึ่งมีอยู่ใน 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. ระบุข้อมูลที่จะปรากฏในแผนภูมิ หากต้องการใช้อินเทอร์เฟซที่ขับเคลื่อนโดยเมนูหรือป้อนตัวกรอง ให้เลือกแท็บการกำหนดค่า หากต้องการใช้ภาษาการค้นหาสำหรับการตรวจสอบ (MQL) ให้เลือกแท็บ MQL
    1. หากต้องการแสดงแผนภูมิการใช้โควต้า ให้เลือกโควต้าผู้บริโภคเป็นประเภททรัพยากร หรือหากคุณต้องการสร้างแผนภูมิ สำหรับการใช้ API ให้เลือก API ที่ใช้ หรือ Google Maps API (ดูส่วนเมตริกการใช้งาน สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับเมตริกการใช้งานที่มีสำหรับ Google Maps Platform API) วางเมาส์เหนือทรัพยากรแต่ละประเภทเพื่อดูคำอธิบาย
    2. สำหรับเมตริก ให้เลือกอัตราการใช้โควต้า แผนภูมิจะอัปเดตโดยอัตโนมัติเพื่อแสดงข้อมูลเมตริก โปรดสังเกตว่ามีตัวเลือกโควต้าอื่นๆ สำหรับเมตริก วางเมาส์เหนือเมตริกแต่ละรายการเพื่อดูคำอธิบาย ดูข้อมูลเพิ่มเติมเกี่ยวกับช่องต่างๆ ของโปรแกรมสำรวจเมตริกได้ที่การเลือกเมตริกและการเลือกวิธีแสดงข้อมูลในแผนภูมิ
  6. (ไม่บังคับ) ใช้ตัวเลือกต่อไปนี้เพื่อปรับแต่งการแสดงผล
    1. หากต้องการระบุชุดย่อยของข้อมูลที่จะแสดง ให้เพิ่มตัวกรอง หากต้องการเพิ่มตัวกรอง ให้เลือกเพิ่มตัวกรองและกรอกข้อมูลในกล่องโต้ตอบ ดูข้อมูลเพิ่มเติมได้ในกรองข้อมูลในแผนภูมิ เช่น หากต้องการดูข้อมูลของ API เดียว ให้ทำดังนี้
      1. ในช่องป้ายกำกับ ให้เลือกเมธอด
      2. ในช่องการเปรียบเทียบ ให้เลือก = (เท่ากับ)
      3. ในช่องค่า ให้เลือกชื่อเมธอดที่ต้องการ ระบบจะแจ้งให้เลือกชื่อเมธอดพร้อมข้อมูลที่จะแสดง
      4. เลือกเสร็จสิ้น เพื่ออัปเดตแผนภูมิ
    2. หากต้องการจัดกลุ่มอนุกรมเวลาตามป้ายกำกับ ให้ใช้ช่องจัดกลุ่มตาม การเลือกค่าสำหรับช่องนี้จะเลือกค่าสำหรับช่องผู้รวบรวมข้อมูลโดยอัตโนมัติ
    3. หากต้องการระบุวิธีรวมอนุกรมเวลา ให้ตั้งค่าช่องผู้รวบรวมข้อมูล ตัวอย่างเช่น หากช่องจัดกลุ่มตามว่างเปล่าและตั้งค่าช่องผู้รวบรวมข้อมูลเป็นค่าเฉลี่ย แผนภูมิก็จะแสดงค่าเฉลี่ยของอนุกรมเวลา
    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 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 ที่ตอบกลับคำขอ API แพลตฟอร์ม Google Maps และป้ายกำกับโค้ดตอบกลับที่มีอยู่ใน 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)
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/2/2 หรือ {1/2/2 API: การรายงานรหัสข้อผิดพลาด, Google Maps Platform: 1) จากรหัสการตอบกลับ HTTP/ระดับ 200/2xx จาก {3/2} {1/2/2 หรือ {1/2/3) API จาก {3/2/3) API จาก {3/2/3) API จาก {3/2/3) จาก {3/2/2 สำหรับ API ของ Google Maps: {3/2/2 สำหรับ API: {3/2/2 สำหรับ API: {3/2} จาก {3/2/2 สำหรับ API: {3/2} จาก {3/2/2 สำหรับ API จาก {3/2/2 } สำหรับ Maps: DATA_NOT_AVAILABLE, NOT_FOUND, {11/class} - สถานะ API ไปยัง 200/class}, {3/2} {3/2/22002002002xx2xx2xx2xx4044xx4xx4xx4xx4xx4xx4xx0OK5NOT_FOUNDZERO_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:

    ไปที่ Monitoring

  2. เลือกการแจ้งเตือน
  3. เลือกแก้ไขช่องทางการแจ้งเตือนเพื่อกำหนดวิธีที่การแจ้งเตือนออกการแจ้งเตือน ในตัวอย่างนี้ คุณจะใช้อีเมลของคุณ
    1. สำหรับช่องทางอีเมล ให้เลือกเพิ่มใหม่
    2. ป้อนอีเมลและชื่อที่แสดง
    3. เลือกบันทึก
  4. เลือกการแจ้งเตือน
  5. เลือกสร้างนโยบาย
  6. เลือกช่วงเวลา เช่น 7 วัน
  7. ในส่วนเงื่อนไขในการแจ้งเตือน ให้เลือกเงื่อนไขใหม่ ดังนี้
    1. คลิกเลือกเมตริก แล้วเลือก API ที่ใช้ไปเป็นทรัพยากร และเลือกจำนวนคำขอเป็นเมตริก จากนั้นเลือกใช้
    2. (ไม่บังคับ) ใต้แผนภูมิจะแสดงรายการ service, quota_metrics, API method และ 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. คลิกชื่อการแจ้งเตือนเพื่อดูข้อมูลเกี่ยวกับการแจ้งเตือน รวมถึงแผนภูมิที่แสดงเหตุการณ์ที่ทำให้เกิดการแจ้งเตือน

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