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

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

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

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

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

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

इन उदाहरणों में इस्तेमाल किए गए 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"

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

ISO फ़ॉर्मैट में समयसीमा तय करने के लिए, 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 देखें.

वर्चुअल होस्ट और बेस पाथ से जुड़ी प्रॉक्सी की सूची बनाना

एज राउटर पर वर्चुअल होस्ट की मदद से, डोमेन नेम, प्रोटोकॉल (जैसे, एचटीटीपी/एचटीटीपीएस) और पोर्ट नंबर तय किया जा सकता है. उदाहरण के लिए, किसी एज राऊटर पर वर्चुअल होस्ट को इन सेटिंग के साथ तय किया जाता है:

  • होस्ट का दूसरा नाम = apis.acme.com
  • port = 443
  • TLS चालू है

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

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

कहां:

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

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

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

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" 

$ACCESS_TOKEN को अपने OAuth 2.0 ऐक्सेस टोकन पर सेट करें, जैसा कि OAuth 2.0 ऐक्सेस टोकन पाना में बताया गया है.

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