एपीआई का इस्तेमाल करके लॉग देखें

यहां Apigee Edge के दस्तावेज़ देखे जा रहे हैं.
पर जाएं Apigee X दस्तावेज़. info

एपीआई मॉनिटरिंग डैशबोर्ड में दिखने वाली मेट्रिक का हिसाब लगाने के लिए इस्तेमाल किया गया रॉ डेटा देखने के लिए, एपीआई मॉनिटरिंग के लॉग डाउनलोड करें. आपके पास, पसंद के मुताबिक तय की गई समयावधि, चुनिंदा प्रॉक्सी, चुनिंदा स्टेटस कोड, और कई अन्य वैरिएबल के लॉग डाउनलोड करने का विकल्प होता है.

ध्यान दें: डिफ़ॉल्ट रूप से, Logs API को किए गए कॉल से सिर्फ़ 4xx और 5xx स्टेटस कोड वाले नतीजे मिलते हैं. 2xx कोड वाले नतीजे नहीं मिलते. ऐसा इसलिए किया जाता है, ताकि नतीजों की संख्या सीमित रहे. इसकी वजह यह है कि ज़्यादातर नतीजों का स्टेटस कोड 2xx होता है. 2xx स्टेटस कोड वाले नतीजे पाने के लिए, अनुरोध में status=2xx जोड़ें. उदाहरण के लिए: https://apimonitoring.enterprise.apigee.com/logs?status=2xx.

यहां दिए गए सेक्शन में, एपीआई का इस्तेमाल करके लॉग मैनेज करने का तरीका बताया गया है:

लॉग एपीआई के बारे में ज़्यादा जानने के लिए, Logs API देखें.

इन उदाहरणों में इस्तेमाल किए गए cURL विकल्पों के बारे में जानने के लिए, देखें cURL का इस्तेमाल करना.

किसी संगठन और एनवायरमेंट के लॉग डाउनलोड करना

Logs API का इस्तेमाल करके, किसी खास संगठन और एनवायरमेंट के लॉग डाउनलोड करें:

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

आपको org और env क्वेरी पैरामीटर का इस्तेमाल करके, संगठन और एनवायरमेंट का नाम पास करना होगा.

डिफ़ॉल्ट रूप से, एपीआई पिछले एक घंटे के सबसे नए 10 लॉग एंट्री दिखाता है. उदाहरण के लिए:

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

OAuth 2.0 का ऐक्सेस टोकन हासिल करना लेख में बताए गए तरीके से, $ACCESS_TOKEN को अपने 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 क्वेरी पैरामीटर का इस्तेमाल करें. तारीख का फ़ॉर्मैट इनमें से कोई एक हो सकता है:

  • 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"

एपीआई में, क्वेरी के कई ऐसे पैरामीटर होते हैं जिन्हें इस्तेमाल करना ज़रूरी नहीं है. उदाहरण के लिए, myAPI नाम की किसी प्रॉक्सी के लॉग देखने के लिए, जो एचटीटीपी 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 पर मौजूद वर्चुअल होस्ट की मदद से, डोमेन नेम, एचटीटीपी/एचटीटीपीएस जैसे प्रोटोकॉल, और पोर्ट नंबर तय किया जा सकता है. उदाहरण के लिए, Edge Router पर वर्चुअल होस्ट को इन सेटिंग के साथ तय किया जाता है:

  • होस्ट एलियास = apis.acme.com
  • पोर्ट = 443
  • TLS चालू

इन सेटिंग के आधार पर, इस वर्चुअल होस्ट से जुड़ी किसी एपीआई प्रॉक्सी के लिए किया गया अनुरोध, इस फ़ॉर्म का इस्तेमाल करता है:

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

कहां:

  • proxy-base-path , एपीआई प्रॉक्सी बनाते समय तय किया जाता है. यह हर एपीआई प्रॉक्सी के लिए यूनीक होता है.
  • resource-path , एपीआई प्रॉक्सी के ज़रिए ऐक्सेस किए जा सकने वाले किसी संसाधन का पाथ होता है.

वर्चुअल होस्ट के बारे में ज़्यादा जानने के लिए, वर्चुअल होस्ट के बारे में जानकारी लेख पढ़ें.

किसी खास वर्चुअल होस्ट और बेस पाथ से जुड़ी एपीआई प्रॉक्सी की सूची डाउनलोड करने के लिए, Logs API के इस संसाधन को जीईटी अनुरोध भेजें:

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

आपको org और env क्वेरी पैरामीटर के साथ-साथ, वर्चुअल होस्ट और बेस पाथ से जुड़ा यूआरआई इस्तेमाल करके, संगठन और एनवायरमेंट का नाम पास करना होगा.

उदाहरण के लिए, यहां दिया गया एपीआई कॉल, 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"

OAuth 2.0 का ऐक्सेस टोकन हासिल करना लेख में बताए गए तरीके से, $ACCESS_TOKEN को अपने OAuth 2.0 ऐक्सेस टोकन पर सेट करें.

ज़्यादा विकल्पों के लिए, Logs API देखें.