ดูบันทึกโดยใช้ API

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

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

หมายเหตุ: โดยค่าเริ่มต้น การเรียก Logs API จะแสดงผลเฉพาะผลลัพธ์ที่มีรหัสสถานะ 4xx และ 5xx แต่ไม่แสดงผลลัพธ์ที่มีรหัส 2xx ซึ่งทำขึ้นเพื่อจำกัดจำนวนผลลัพธ์ เนื่องจากผลลัพธ์ส่วนใหญ่มีรหัสสถานะ 2xx หากต้องการรับผลลัพธ์ที่มีรหัสสถานะ 2xx ให้เพิ่ม status=2xx ลงในคำขอ เช่น https://apimonitoring.enterprise.apigee.com/logs?status=2xx

ส่วนต่อไปนี้จะอธิบายวิธีจัดการบันทึกโดยใช้ API

• ดาวน์โหลดบันทึกสำหรับองค์กรและสภาพแวดล้อมที่เฉพาะเจาะจง
• แสดงรายการพร็อกซีที่เชื่อมโยงกับองค์กรและสภาพแวดล้อม

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Logs API ได้ที่ Logs API

ดูข้อมูลเกี่ยวกับตัวเลือก cURL ที่ใช้ในตัวอย่างเหล่านี้ได้ที่ ดู ใช้ cURL

ดาวน์โหลดบันทึกสำหรับองค์กรและสภาพแวดล้อม

ดาวน์โหลดบันทึกสำหรับองค์กรและสภาพแวดล้อมที่เฉพาะเจาะจงโดยใช้ Logs API ดังนี้

https://apimonitoring.enterprise.apigee.com/logs

คุณต้องส่งชื่อองค์กรและสภาพแวดล้อมโดยใช้พารามิเตอร์การค้นหา org และ env

โดยค่าเริ่มต้น API จะแสดงผลรายการบันทึกล่าสุด 10 รายการสำหรับ 1 ชั่วโมงที่ผ่านมา เช่น

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

ตั้งค่า $ACCESS_TOKEN เป็นโทเค็นเพื่อการเข้าถึง OAuth 2.0 ตามที่อธิบายไว้ใน รับโทเค็นเพื่อการเข้าถึง OAuth 2.0

การตอบสนองจะเป็นอาร์เรย์ของรายการบันทึกในรูปแบบต่อไปนี้

[   
  {
"request":"GET /v1/o/myorg/z HTTP/1.1",
    "request_length":1349,
    "request_message_id":"rrt-0623eb157b650315c-c-ne-7785-16029140-1",
    "virtual_host":"api.enterprise.apigee.com",
    "response_size":144,
    "response_time":0.551,
    "response_status":"404",
    "timestamp":"2018-08-14T17:31:07Z",
    "fault_code":"messaging.adaptors.http.flow.ErrorResponseCode",
    "fault_flow":"-",
    "fault_policy":"null/null",
    "fault_proxy":
        "/organizations/myorg/environments/prod/apiproxies/myAPI/revisions/50",
    "fault_source":"target"
  },
  …
]

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

• yyyy-mm-ddThh:mm:ssZ
• yyyy-mm-ddThh:mm:ss+00:00

เช่น

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod&from=2018-08-13T14%3A04%3A00Z&to=2018-08-13T14%3A10%3A00Z" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

API มีพารามิเตอร์การค้นหาที่ไม่บังคับมากมาย เช่น หากต้องการดูบันทึกของพร็อกซีชื่อ myAPI ที่สร้างการตอบสนอง HTTP 404 ให้ทำดังนี้

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod&proxy=myAPI&status=404" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

หากต้องการแสดงผลรายการบันทึกมากกว่า 10 รายการ ให้ตั้งค่าพารามิเตอร์การค้นหา limit โดยตั้งค่าได้สูงสุด 1000

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod&proxy=myAPI&status=404&limit=200" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

ดูตัวเลือกเพิ่มเติมได้ที่ Logs API

แสดงรายการพร็อกซีที่เชื่อมโยงกับโฮสต์เสมือนและเส้นทางฐาน

โฮสต์เสมือนใน Edge Router ช่วยให้คุณระบุชื่อโดเมน โปรโตคอล เช่น HTTP/HTTPS และหมายเลขพอร์ตได้ เช่น คุณกำหนดโฮสต์เสมือนใน Edge Router ด้วยการตั้งค่าต่อไปนี้

• ชื่อแทนโฮสต์ = apis.acme.com
• พอร์ต = 443
• เปิดใช้งาน TLS แล้ว

การตั้งค่าเหล่านี้จะทำให้คำขอพร็อกซี API ที่เชื่อมโยงกับโฮสต์เสมือนนี้ใช้รูปแบบต่อไปนี้

https://apis.acme.com/proxy-base-path/resource-path

โดยที่

• proxy-base-path จะกำหนดขึ้นเมื่อคุณสร้างพร็อกซี API และไม่ซ้ำกันสำหรับพร็อกซี API แต่ละรายการ
• resource-path คือเส้นทางไปยังทรัพยากรที่เข้าถึงได้ผ่านพร็อกซี API

ดูข้อมูลเพิ่มเติมเกี่ยวกับโฮสต์เสมือนได้ที่เกี่ยวกับโฮสต์เสมือน

ดาวน์โหลดรายการพร็อกซี API ที่เชื่อมโยงกับโฮสต์เสมือนและ เส้นทางฐานที่เฉพาะเจาะจงโดยส่งคำขอ GET ไปยังทรัพยากรต่อไปนี้ของ Logs API:

https://apimonitoring.enterprise.apigee.com/logs/apiproxies

คุณต้องส่งชื่อองค์กรและสภาพแวดล้อมโดยใช้พารามิเตอร์การค้นหา org และ env รวมถึง URI ที่เชื่อมโยงกับโฮสต์เสมือนและเส้นทางฐาน

ตัวอย่างเช่น การเรียก API ต่อไปนี้จะแสดงผลพร็อกซีที่เชื่อมโยงกับโฮสต์เสมือน http://apis.acme.com และมีเส้นทางฐานเป็น /v1/perf

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs/apiproxies?org=myorg&env=prod&select=http://apis.acme.com/v1/perf" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" 

ตั้งค่า $ACCESS_TOKEN เป็นโทเค็นเพื่อการเข้าถึง OAuth 2.0 ตามที่อธิบายไว้ใน รับโทเค็นเพื่อการเข้าถึง OAuth 2.0

ดูตัวเลือกเพิ่มเติมได้ที่ Logs API