Xem nhật ký bằng API

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Tải nhật ký giám sát API xuống để xem dữ liệu thô dùng để tính toán các chỉ số hiển thị trên trang tổng quan Giám sát API. Bạn có thể tải nhật ký xuống cho các phạm vi thời gian tuỳ chỉnh, proxy cụ thể, mã trạng thái cụ thể và cho nhiều biến khác.

Lưu ý: Theo mặc định, các lệnh gọi đến API Nhật ký chỉ trả về kết quả với mã trạng thái 4xx và 5xx, chứ không trả về kết quả với mã 2xx. Việc này nhằm giới hạn số lượng kết quả, vì hầu hết kết quả đều có mã trạng thái 2xx. Để nhận kết quả có mã trạng thái 2xx, hãy thêm status=2xx vào yêu cầu. Ví dụ: https://apimonitoring.enterprise.apigee.com/logs?status=2xx.

Các phần sau đây mô tả cách quản lý nhật ký bằng API:

Hãy xem API Nhật ký để biết thêm thông tin về API nhật ký.

Để biết thông tin về các tuỳ chọn cURL được sử dụng trong những ví dụ này, hãy xem phần Sử dụng cURL.

Tải nhật ký xuống cho tổ chức và môi trường

Tải nhật ký xuống cho một tổ chức và môi trường cụ thể bằng cách sử dụng Logs API:

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

Bạn phải truyền tên của tổ chức và môi trường bằng cách sử dụng các tham số truy vấn orgenv.

Theo mặc định, API trả về 10 mục nhập nhật ký gần đây nhất cho một giờ trước đó. Ví dụ:

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

Đặt $ACCESS_TOKEN thành mã truy cập OAuth 2.0, như mô tả trong bài viết Lấy mã truy cập OAuth 2.0.

Phản hồi là một mảng các mục nhập nhật ký theo biểu mẫu:

[   
  {
"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"
  },
  …
]

Sử dụng các tham số truy vấn fromto để chỉ định phạm vi thời gian theo định dạng ISO. Định dạng ngày có thể là:

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

Ví dụ:

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 có nhiều tham số truy vấn không bắt buộc. Ví dụ: để xem nhật ký của một proxy có tên myAPI đang tạo phản hồi 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"

Để trả về hơn 10 mục nhập nhật ký, hãy đặt tham số truy vấn limit. Bạn có thể đặt giá trị tối đa là 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"

Để biết thêm các lựa chọn khác, hãy xem bài viết Logs API.

Liệt kê các proxy được liên kết với máy chủ ảo và đường dẫn cơ sở

Máy chủ ảo trên Bộ định tuyến cạnh cho phép bạn chỉ định tên miền, giao thức như HTTP/HTTPS và số cổng. Ví dụ: bạn xác định một máy chủ ảo trên Bộ định tuyến cạnh bằng các chế độ cài đặt sau:

  • bí danh máy chủ = apis.acme.com
  • cổng = 443
  • Đã bật TLS

Dựa trên những chế độ cài đặt này, yêu cầu tới proxy API được liên kết với máy chủ ảo này sẽ sử dụng biểu mẫu sau:

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

Trong trường hợp:

  • proxy-base-path được định nghĩa khi bạn tạo proxy API và là giá trị duy nhất cho mỗi proxy API.
  • resource-path là đường dẫn đến một tài nguyên có thể truy cập được thông qua proxy API.

Để biết thêm thông tin về máy chủ ảo, hãy xem phần Giới thiệu về máy chủ ảo.

Tải danh sách các proxy API xuống được liên kết với một máy chủ ảo và đường dẫn cơ sở cụ thể bằng cách gửi yêu cầu GET tới tài nguyên sau của Logs API:

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

Bạn phải truyền tên của tổ chức và môi trường bằng cách sử dụng tham số truy vấn orgenv cũng như URI được liên kết với đường dẫn cơ sở và máy chủ ảo.

Ví dụ: lệnh gọi API sau đây trả về các proxy liên kết với máy chủ ảo http://apis.acme.com và với đường dẫn cơ sở là /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" 

Đặt $ACCESS_TOKEN thành mã truy cập OAuth 2.0, như mô tả trong bài viết Lấy mã truy cập OAuth 2.0.

Để biết thêm các lựa chọn khác, hãy xem bài viết Logs API.