ดูบันทึกโดยใช้ 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 คุณตั้งค่าได้สูงสุด 1,000 รายการ ดังนี้

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 ด้วยการตั้งค่าต่อไปนี้

• host alias = apis.acme.com
• port = 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