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

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

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

กำหนดค่า Cloud Monitoring

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

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

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

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

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

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

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

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

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

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

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

สำรวจเมตริก

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

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

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

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

ในรูปภาพนี้

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

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

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

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

  1. ใน Cloud Console ให้เลือกการตรวจสอบ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. ใน Cloud Console ให้เลือกการตรวจสอบ

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

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

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

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

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

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

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

ดูแดชบอร์ด

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

  1. ใน Cloud Console ให้เลือกการตรวจสอบ

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

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

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

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

เมตริก 2 กลุ่มมีไว้สําหรับตรวจสอบการใช้งาน Google Maps Platform API ได้แก่ เมตริกรันไทม์ของบริการ (ประเภททรัพยากร 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 และป้ายกํากับรหัสการตอบกลับที่มีให้ใช้งานในการตรวจสอบระบบคลาวด์ ได้แก่ รหัสการตอบกลับ HTTP, คลาสรหัสการตอบกลับ HTTP และรหัสสถานะ GRPC รหัสสถานะ GRPC เป็นรหัสการตอบกลับ gRPC แบบตัวเลขสําหรับคําขอ gRPC หรือรหัสเทียบเท่า gRPC สําหรับคําขอ HTTP

โค้ดตอบกลับที่แสดงในการตอบกลับของ API โค้ดตอบกลับที่รายงานไปยังการตรวจสอบ
สถานะ 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 (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 (ไม่ทราบ)/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 - status, 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 จะไม่เปลี่ยนแปลง คุณสามารถดูรายละเอียดของโค้ดตอบกลับที่รายงานในช่วงระยะเวลาหนึ่งได้ในเครื่องมือสํารวจเมตริก

สร้างการแจ้งเตือน

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

นโยบายการแจ้งเตือนอาจเรียบง่ายหรือซับซ้อน นโยบายการแจ้งเตือนช่วยให้คุณกำหนดค่าได้ว่าอนุกรมเวลาเดียวจะทำให้เป็นไปตามเงื่อนไขหรือไม่ หรืออนุกรมเวลาหลายรายการต้องเป็นไปตามเงื่อนไขก่อนจึงจะเป็นไปตามเงื่อนไขหรือไม่ เช่น

  • แจ้งเตือนฉันเมื่อจํานวนคําขอสําหรับ API ที่เฉพาะเจาะจงเกิน 1,000 คําขอต่อกรอบเวลา 5 นาที
  • แจ้งให้ทีมที่คอยให้บริการทราบเมื่อเปอร์เซ็นต์ไทล์ที่ 90 ของการตอบกลับ HTTP 200 นานกว่าเวลาในการตอบสนอง 100 มิลลิวินาทีสําหรับ API อย่างน้อย 3 รายการ

รูปภาพต่อไปนี้แสดงคําจํากัดความของการแจ้งเตือนเพื่อสร้างการแจ้งเตือนเมื่อจํานวนคําขอสําหรับ API มากกว่า 20 คําขอในกรอบเวลา 5 นาที

ภาพหน้าจอของคําจํากัดความการแจ้งเตือนที่แสดงจํานวนคําขอ API สําหรับ Maps API ทั้งหมดเป็นเส้นแยกต่างหาก และเกณฑ์การแจ้งเตือนเป็นเส้นแนวนอน

ในรูปภาพนี้

  • แผนภูมิแสดงจํานวนการเรียก API ในช่วงระยะเวลาหนึ่งสําหรับ API ต่างๆ
  • เส้นสีแดงแสดงเกณฑ์การแจ้งเตือน การเรียก API ที่เกินเกณฑ์นี้ในกรอบเวลา 5 นาทีจะทริกเกอร์การแจ้งเตือน ในตัวอย่างนี้ คุณจะเห็นว่ามี API 1 รายการใช้เกินขีดจํากัด

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

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

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

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

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

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

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

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

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

สิ่งที่จะเกิดขึ้นเมื่อคุณสร้างการแจ้งเตือนมีดังนี้

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

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

วิธีสร้างการแจ้งเตือนมีดังนี้

  1. ใน Cloud Console ให้เลือกการตรวจสอบ

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

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

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