लॉगिंग और डिबगिंग

विस्तृत logging सक्षम करें, HTTP अनुरोधों का निरीक्षण करें, और सामान्य SDK त्रुटियों का निदान करें।

जब SDK कुछ अप्रत्याशित करता है, तो इसका कारण पता करने का सबसे तेज़ तरीका आमतौर पर अंतर्निहित HTTP अनुरोध और प्रतिक्रिया को देखना होता है।

विस्तृत अनुरोध लॉगिंग सक्षम करें

SDK Python के मानक logging मॉड्यूल और requests लाइब्रेरी का उपयोग नीचे से करता है। SDK द्वारा किए गए हर HTTP अनुरोध को देखने के लिए:

import logging
import http.client as http_client

http_client.HTTPConnection.debuglevel = 1
logging.basicConfig(level=logging.DEBUG)
logging.getLogger("urllib3").setLevel(logging.DEBUG)
logging.getLogger("urllib3").propagate = True

यह प्रत्येक अनुरोध पंक्ति, हेडर (जहाँ SDK उन्हें छिपाता है, वहाँ उन्हें छिपाए हुए), और प्रतिक्रिया की स्थिति प्रिंट करता है। इस सक्षम सेटिंग के साथ एक एकल SDK कॉल चलाएँ और आपको ठीक-ठीक दिखेगा कि क्या भेजा जा रहा है।

एकल विफल कॉल की जाँच करें

यदि आप वैश्विक लॉगिंग सक्षम किए बिना एक कॉल की जाँच करना चाहते हैं, तो सीधे adapter में जाएँ। वर्कस्पेस / प्रोजेक्ट / संस्करण अंततः roboflow.adapters.rfapi (या deploymentapi, vision_events_api); उन्हें सीधे कॉल करने पर कच्ची प्रतिक्रिया लौटती है और उच्च-स्तरीय method द्वारा किए जाने वाले किसी भी post-processing को छोड़ देती है:

from roboflow.adapters import rfapi

response = rfapi.get_workflow("YOUR_API_KEY", workspace_url="my-workspace", workflow_url="slow-webhooks")
print(response)

यदि उच्च-स्तरीय कॉल ने अपवाद उत्पन्न किया, तो वही adapter कॉल आमतौर पर एक RoboflowError उत्पन्न करती है, जिसका string सर्वर की हूबहू response body होती है - जो उन bad-request errors के निदान में उपयोगी है जिन्हें उच्च-स्तरीय method wrap कर सकता है।

सामान्य त्रुटियाँ

RoboflowError: 401

प्रमाणीकरण विफलता। इनमें से एक कारण हो सकता है:

• ROBOFLOW_API_KEY सेट नहीं है, या

• को पास की गई कुंजी Roboflow(api_key=...) गलत है, या

• कुंजी मान्य है लेकिन ऑपरेशन के लिए आवश्यक scope नहीं रखती। देखें स्कोप्ड API कुंजियाँ.

RoboflowError: 404

संसाधन नहीं मिला। जाँचें कि workspace / project / version slug वेब ऐप के URL bar में दिए गए slug से मेल खाता है - slug हमेशा display name से मेल नहीं खाते, और SDK पूरे समय slugs का उपयोग करता है।

RoboflowError: 423 Locked

Workspace बिलिंग-रोक स्थिति में है। वेब ऐप के billing पेज में इसे हल करें या सहायता से संपर्क करें।

RuntimeError से restore()

आइटम वर्तमान में Trash में नहीं है। या तो 30-दिन की अवधारण अवधि के बाद इसे पहले ही स्थायी रूप से साफ़ कर दिया गया था, या यह अभी भी workspace में सक्रिय है।

धीमे अपलोड

Workspace.upload_dataset() डिफ़ॉल्ट रूप से num_workers=10. बड़े datasets के लिए, इसे बढ़ाएँ (लगभग 25 तक - उससे आगे आपको throttled responses मिलने लगते हैं)। विपरीत स्थिति में (सीमित networks या साझा infra), इसे घटाएँ।

ImportError पर roboflow-slim

roboflow-slim Pillow, NumPy, OpenCV, और Matplotlib को शामिल नहीं करता। यदि आप roboflow.models.* से import करते हैं या एक .predict(...).save(...)-style visualization helper कॉल करते हैं, तो इसके बजाय पूर्ण roboflow पैकेज इंस्टॉल करें।

स्रोत में कहाँ देखें

यदि stack trace इशारा करता है roboflow.core.workspace.py या roboflow.adapters.rfapi, तो GitHub स्रोत खोजा जा सकता है और methods छोटे हैं। किसी method के सटीक signature के लिए, adapter docstrings ही प्रामाणिक स्रोत हैं।

बग की रिपोर्ट करना

पर issue खोलते समय github.com/roboflow/roboflow-python, शामिल करें:

• roboflow.__version__

• आप जिस Python version का उपयोग कर रहे हैं

• न्यूनतम reproduction (API key को redacted करके)

• पूरा traceback या ऊपर वर्णित verbose-logging output

जिन issues में HTTP request / response शामिल होता है, वे आमतौर पर एक ही round-trip में ठीक किए जा सकते हैं; जिनमें नहीं होता, उनमें अक्सर उन्हें जुटाने के लिए follow-up की जरूरत पड़ती है।