नेटवर्क प्रोटोकॉल डिबगिंग के लिए एक स्क्रिप्ट या किसी एप्लिकेशन का सबसिस्टम होने के बाद, यह देखने के लिए वांछित है कि क्या अनुरोध-प्रतिक्रिया जोड़े वास्तव में प्रभावी URL, हेडर, पेलोड और स्थिति सहित हैं। और यह आम तौर पर सभी स्थानों पर व्यक्तिगत अनुरोधों को लागू करने के लिए अव्यावहारिक है। एक ही समय में प्रदर्शन के विचार हैं जो एकल (या कुछ विशेष) का उपयोग करने का सुझाव देते हैं requests.Session
, इसलिए निम्नलिखित मानते हैं कि सुझाव का पालन किया जाता है।
requests
तथाकथित ईवेंट हुक का समर्थन करता है (2.23 के रूप में वास्तव में केवल response
हुक है)। यह मूल रूप से एक घटना श्रोता है, और इस घटना को नियंत्रण से लौटने से पहले उत्सर्जित किया जाता है requests.request
। इस समय अनुरोध और प्रतिक्रिया दोनों पूरी तरह से परिभाषित हैं, इसलिए लॉग इन किया जा सकता है।
import logging
import requests
logger = logging.getLogger('httplogger')
def logRoundtrip(response, *args, **kwargs):
extra = {'req': response.request, 'res': response}
logger.debug('HTTP roundtrip', extra=extra)
session = requests.Session()
session.hooks['response'].append(logRoundtrip)
यह मूल रूप से सत्र के सभी HTTP राउंड-ट्रिप को लॉग करने का तरीका है।
HTTP राउंड-ट्रिप लॉग रिकॉर्ड्स फ़ॉर्मेट करना
ऊपर लॉगिंग उपयोगी होने के लिए लॉगिंग रिकॉर्ड्स पर समझने और एक्स्ट्रा करने वाले विशेष लॉगिंग फॉर्मेटर हो सकते हैं । यह इस तरह दिख सकता है:req
res
import textwrap
class HttpFormatter(logging.Formatter):
def _formatHeaders(self, d):
return '\n'.join(f'{k}: {v}' for k, v in d.items())
def formatMessage(self, record):
result = super().formatMessage(record)
if record.name == 'httplogger':
result += textwrap.dedent('''
---------------- request ----------------
{req.method} {req.url}
{reqhdrs}
{req.body}
---------------- response ----------------
{res.status_code} {res.reason} {res.url}
{reshdrs}
{res.text}
''').format(
req=record.req,
res=record.res,
reqhdrs=self._formatHeaders(record.req.headers),
reshdrs=self._formatHeaders(record.res.headers),
)
return result
formatter = HttpFormatter('{asctime} {levelname} {name} {message}', style='{')
handler = logging.StreamHandler()
handler.setFormatter(formatter)
logging.basicConfig(level=logging.DEBUG, handlers=[handler])
अब यदि आप कुछ अनुरोधों का उपयोग करते हैं session
, जैसे:
session.get('https://httpbin.org/user-agent')
session.get('https://httpbin.org/status/200')
आउटपुट stderr
निम्नानुसार दिखेगा।
2020-05-14 22:10:13,224 DEBUG urllib3.connectionpool Starting new HTTPS connection (1): httpbin.org:443
2020-05-14 22:10:13,695 DEBUG urllib3.connectionpool https://httpbin.org:443 "GET /user-agent HTTP/1.1" 200 45
2020-05-14 22:10:13,698 DEBUG httplogger HTTP roundtrip
---------------- request ----------------
GET https://httpbin.org/user-agent
User-Agent: python-requests/2.23.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
None
---------------- response ----------------
200 OK https://httpbin.org/user-agent
Date: Thu, 14 May 2020 20:10:13 GMT
Content-Type: application/json
Content-Length: 45
Connection: keep-alive
Server: gunicorn/19.9.0
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true
{
"user-agent": "python-requests/2.23.0"
}
2020-05-14 22:10:13,814 DEBUG urllib3.connectionpool https://httpbin.org:443 "GET /status/200 HTTP/1.1" 200 0
2020-05-14 22:10:13,818 DEBUG httplogger HTTP roundtrip
---------------- request ----------------
GET https://httpbin.org/status/200
User-Agent: python-requests/2.23.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
None
---------------- response ----------------
200 OK https://httpbin.org/status/200
Date: Thu, 14 May 2020 20:10:13 GMT
Content-Type: text/html; charset=utf-8
Content-Length: 0
Connection: keep-alive
Server: gunicorn/19.9.0
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true
एक जीयूआई रास्ता
जब आपके पास बहुत सारी क्वेरीज़ होती हैं, तो एक साधारण UI और रिकॉर्ड्स को फ़िल्टर करने का एक तरीका काम में आता है। मैं उसके लिए क्रोनोलोगर (जो मैं लेखक हूं) का उपयोग करके दिखाऊंगा ।
सबसे पहले, हुक को उन रिकॉर्ड का उत्पादन करने के लिए फिर से लिखा logging
गया है जो तार पर भेजते समय धारावाहिक कर सकते हैं। यह इस तरह दिख सकता है:
def logRoundtrip(response, *args, **kwargs):
extra = {
'req': {
'method': response.request.method,
'url': response.request.url,
'headers': response.request.headers,
'body': response.request.body,
},
'res': {
'code': response.status_code,
'reason': response.reason,
'url': response.url,
'headers': response.headers,
'body': response.text
},
}
logger.debug('HTTP roundtrip', extra=extra)
session = requests.Session()
session.hooks['response'].append(logRoundtrip)
दूसरा, लॉगिंग कॉन्फ़िगरेशन को उपयोग करने के लिए अनुकूलित किया जाना है logging.handlers.HTTPHandler
(जिसे क्रोनोलॉजर समझता है)।
import logging.handlers
chrono = logging.handlers.HTTPHandler(
'localhost:8080', '/api/v1/record', 'POST', credentials=('logger', ''))
handlers = [logging.StreamHandler(), chrono]
logging.basicConfig(level=logging.DEBUG, handlers=handlers)
अंत में, क्रोनोलॉजर उदाहरण चलाएं। जैसे डॉकर का उपयोग करना:
docker run --rm -it -p 8080:8080 -v /tmp/db \
-e CHRONOLOGER_STORAGE_DSN=sqlite:////tmp/db/chrono.sqlite \
-e CHRONOLOGER_SECRET=example \
-e CHRONOLOGER_ROLES="basic-reader query-reader writer" \
saaj/chronologer \
python -m chronologer -e production serve -u www-data -g www-data -m
और फिर से अनुरोध करें:
session.get('https://httpbin.org/user-agent')
session.get('https://httpbin.org/status/200')
स्ट्रीम हैंडलर उत्पादन करेगा:
DEBUG:urllib3.connectionpool:Starting new HTTPS connection (1): httpbin.org:443
DEBUG:urllib3.connectionpool:https://httpbin.org:443 "GET /user-agent HTTP/1.1" 200 45
DEBUG:httplogger:HTTP roundtrip
DEBUG:urllib3.connectionpool:https://httpbin.org:443 "GET /status/200 HTTP/1.1" 200 0
DEBUG:httplogger:HTTP roundtrip
अब यदि आप http: // localhost: 8080 / (यूज़रनेम के लिए "लकड़हारा" और बेसिक कोरपॉप पॉपअप के लिए पासवर्ड का उपयोग करते हैं) खोलें और "ओपन" बटन पर क्लिक करें, आपको कुछ इस तरह देखना चाहिए: