แดชบอร์ดและการบันทึกการตรวจสอบ GraphQL (ตัวอย่าง)

โน้ต

การตรวจสอบแดชบอร์ดและการบันทึกคุณลักษณะสําหรับ Fabric API สําหรับ GraphQL อยู่ใน แสดงตัวอย่าง

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

ข้อกําหนดเบื้องต้น

• การตรวจสอบพื้นที่ทํางานที่เปิดใช้งาน สําหรับข้อมูลเพิ่มเติม โปรดดูภาพรวมการตรวจสอบพื้นที่ทํางานและทําตามขั้นตอนเพื่อ เปิดใช้งานการตรวจสอบพื้นที่ทํางาน
• ก่อนที่คุณจะเริ่มใช้ความสามารถในการตรวจสอบและการบันทึก คุณต้องมี API สําหรับ GraphQL ใน Fabric สําหรับข้อมูลเพิ่มเติม ดู สร้าง API สําหรับ GraphQL ใน Fabric และเพิ่มข้อมูล

โน้ต

• การตรวจสอบคุณลักษณะที่เกิด ค่าใช้จ่ายเพิ่มเติม กับความจุของคุณ
• การตรวจสอบพื้นที่ทํางานถูกปิดใช้งานตามค่าเริ่มต้น
• การเก็บรักษาข้อมูลสําหรับการตรวจสอบกิจกรรมถูกจํากัดไว้ที่ 30 วัน

การเปิดใช้งานการตรวจสอบ GraphQL API

ในส่วนนี้ เราจะแนะนําคุณผ่านขั้นตอนที่จําเป็นในการเปิดใช้งานการตรวจสอบ API สําหรับ GraphQL ของคุณ ตามค่าเริ่มต้น คุณลักษณะนี้จะถูกปิดใช้งาน

1. หากต้องการเปิดใช้งานเมตริก และ/หรือ ประสบการณ์การบันทึก สําหรับแต่ละ API สําหรับ GraphQL ในผู้เช่าของคุณ ให้เปิด GraphQL API ของคุณ จากนั้นเลือกไอคอนการตั้งค่า :

   

2. จากหน้าต่างการตั้งค่า API เลือกตัวเลือก การตรวจสอบ (ตัวอย่าง) จากเมนูด้านซ้าย ถ้าการตรวจสอบพื้นที่ทํางาน ยังไม่ได้เปิดใช้งาน คุณจะเห็นบันทึกย่อที่แนะนําให้คุณไปที่การตั้งค่าพื้นที่ทํางาน เปิดใช้งาน

   

3. หลังจากที่คุณเปิดใช้งานการตรวจสอบสําหรับพื้นที่ทํางาน คุณจะเห็นตัวเลือกเพื่อเปิดใช้งาน เมตริก เท่านั้น (แดชบอร์ด API) การบันทึก เท่านั้น (คําขอ API) หรือทั้งสองอย่าง เมตริกและรายการบันทึกจะถูกบันทึกเพื่อแยกตารางใน Kusto และคุณสามารถเปิดใช้งานแต่ละคุณลักษณะแยกกันขึ้นอยู่กับความต้องการของคุณ ตามค่าเริ่มต้น ตัวเลือกทั้งสองจะถูกปิด:

   

โน้ต

เมตริกและข้อมูลการบันทึกจะถูกส่งไปยังฐานข้อมูล Kusto แยกต่างหากที่เชื่อมโยงกับพื้นที่ทํางานและจะมีค่าใช้จ่ายเพิ่มเติม สําหรับข้อมูลเพิ่มเติมเกี่ยวกับค่าใช้จ่ายและปริมาณการใช้ โปรดดู ประกาศ พื้นที่ทํางานการตรวจสอบ

กิจกรรมการร้องขอ API

เมื่อเปิดใช้งานการตรวจสอบ กิจกรรมคําขอ API ตัวเลือกในริบบิ้นด้านบนจาก GraphQL API จะเปิดใช้งาน เลือกเพื่อเข้าถึงรายละเอียดการตรวจสอบ

กิจกรรมคําขอ API ประกอบด้วยมุมมองหลักสองมุมมอง:

1. แดชบอร์ด API (สําหรับเมตริก): หน้านี้แสดงตัวนับและกราฟทั้งหมดสําหรับช่วงเวลาที่ระบุ
2. API requests (สําหรับการบันทึก): หน้านี้แสดงรายการ API requests ภายในช่วงเวลาที่ระบุ

ในส่วนต่อไปนี้ เราอธิบายการทํางานของแต่ละตัวเลือก

เมตริก (แดชบอร์ด API)

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

• ดัชนีสุขภาพ GraphQL API โดยรวมที่ประกอบด้วย:

  • คําขอ/วินาทีของ API
  • อัตราความสําเร็จ
  • สถานะสุขภาพ

• จํานวนคําขอ API

• ศักยภาพ

• จํานวนคําขอในแผนภูมิแท่งแสดงจํานวนความสําเร็จและข้อผิดพลาด

เมื่อวางเมาส์เหนือกราฟ คุณสามารถดูข้อมูลโดยละเอียดสําหรับจุดข้อมูลเฉพาะในคําแนะนําเครื่องมือได้

คุณลักษณะหลักของเมตริก :

• การเลือกช่วงเวลา: คุณสามารถเลือกช่วงเวลาที่แตกต่างกันสําหรับข้อมูลที่แสดงในกราฟการตรวจสอบ โปรดทราบว่า เนื่องจาก การตรวจสอบพื้นที่ทํางาน ขีดจํากัด การเก็บข้อมูลจะพร้อมใช้งานสําหรับ 30 วันเท่านั้น

  

• API Request/sec: คุณสามารถดูจํานวนคําขอ API ที่ทําในแต่ละวินาทีในช่วงเวลาที่เลือกได้

  

• อัตราความสําเร็จ: คุณสามารถดูอัตราความสําเร็จซึ่งเป็นจํานวนคําขอที่สําเร็จตามจํานวนคําขอทั้งหมดในช่วงเวลาที่เลือก

  

• ดัชนีสุขภาพ GraphQL API โดยรวมขึ้นอยู่กับอัตราความสําเร็จต่อ API:

  • สีเขียว: คําขอประสบความสําเร็จ 75 -100% (สุขภาพดี)

  • สีเหลือง: 50 - 74% ของคําขอสําเร็จ (ต้องให้ความสนใจ)

  • สีแดง: Bellow 50% คําขอที่สําเร็จ (ไม่แข็งแรง)

    

• จํานวนคําขอ API ทั้งหมด: คุณสามารถดูจํานวนคําขอ API ทั้งหมดในช่วงเวลาที่เลือกได้

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

  

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

  

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

การบันทึก (คําขอ API)

หน้าคําขอ API ให้ข้อมูลโดยละเอียดเกี่ยวกับคําขอ API ทั้งหมดที่เกิดขึ้นในกรอบเวลาที่ระบุ หากต้องการเข้าถึง ให้เลือกหน้า คําขอ API ของ จากหน้า ร้องขอ API

คุณลักษณะสําคัญสําหรับการบันทึก:

• การเลือกช่วงเวลา: คุณสามารถเลือกช่วงเวลาที่แตกต่างกันสําหรับข้อมูลที่แสดงในรายการคําขอ (ชั่วโมง/วัน/สัปดาห์/เดือน) โปรดทราบว่ามีขีดจํากัดการเก็บข้อมูล 30 วัน

• ดูรายการคําขอ API ล่าสุดและคําขอที่ผ่านมาที่แสดงด้วย รหัสคําขอ
• ดูชนิดของการดําเนินการ (การสอบถามหรือการกลายพันธุ์)
• ดูโพรโทคอลการขนส่งที่ใช้โดยคําขอ (HTTP)
• ดูเวลาของคําขอ
• เรียงลําดับรายการคําขอตามเวลาจากน้อยไปหามาก/จากมากไปหาน้อย
• ดูระยะเวลาของคําขอ
• เรียงลําดับรายการคําขอตามระยะเวลา จากน้อยไปหามาก/จากมากไปหาน้อย
• ดูขนาดการตอบกลับ
• ดูสถานะ (สําเร็จหรือล้มเหลว)
• ดูรายละเอียดของคําขอ รวมถึงข้อความตอบกลับ/คําเตือน/ข้อผิดพลาดที่เฉพาะเจาะจง
• กรองและค้นหาสตริงหรือประโยคที่เฉพาะเจาะจง
• ปรับขนาดคอลัมน์และเรียงลําดับคอลัมน์ (จากน้อยไปหามาก/มากไปหาน้อย) จากตารางรายงาน

เนื้อหาที่เกี่ยวข้อง

• Microsoft Fabric API สําหรับ GraphQL
• ประกาศการตรวจสอบพื้นที่ทํางานของ
• ภาพรวมของการตรวจสอบพื้นที่ทํางาน
• API สําหรับ GraphQL ใน ผ้า
• Fabric API สําหรับ ตัวแก้ไข GraphQL
• Fabric API สําหรับมุมมอง Schema ของ GraphQL และ Explorer