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

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