दर सीमक
Workflow की उस शाखा की रन दर सीमित करता है।
डाउनस्ट्रीम वर्कफ़्लो चरणों के निष्पादनों के बीच न्यूनतम समय अंतराल लागू करें, निष्पादन आवृत्ति को सीमित करें और जुड़े हुए चरणों को निर्दिष्ट कूलडाउन अवधि से अधिक बार न चलाकर अधिक-निष्पादन को रोकें।
यह ब्लॉक कैसे काम करता है
यह ब्लॉक क्रमिक निष्पादनों के बीच कूलडाउन अवधि लागू करके वर्कफ़्लो शाखाओं की निष्पादन दर को सीमित करता है। यह ब्लॉक:
एक कूलडाउन अवधि (सेकंड में), एक
depends_onसंदर्भ, औरnext_stepsइनपुट के रूप मेंआंतरिक स्थिति चर का उपयोग करके अंतिम निष्पादन का टाइमस्टैम्प ट्रैक करता है
वर्तमान समय की गणना करता है:
वीडियो प्रोसेसिंग के लिए: वीडियो मेटाडेटा (फ़्रेम संख्या और FPS) का उपयोग करके वीडियो-समय-आधारित टाइमस्टैम्प की गणना करता है जब
video_reference_imageप्रदान किया जाता हैअन्य संदर्भों के लिए: सिस्टम घड़ी का समय (datetime.now()) का उपयोग करता है
अंतिम निष्पादन के बाद बीता समय इसकी तुलना करता है
cooldown_secondsसीमायदि पर्याप्त समय बीत चुका है (बीता समय >= cooldown_seconds):
अंतिम निष्पादन टाइमस्टैम्प अपडेट करता है
निर्दिष्ट तक निष्पादन जारी रखता है
next_stepsब्लॉक्स
जिससे डाउनस्ट्रीम प्रोसेसिंग संभव होती है
वर्तमान वर्कफ़्लो शाखा समाप्त करता है, और कूलडाउन अवधि समाप्त होने तक डाउनस्ट्रीम निष्पादन को रोकता है
फ़्लो नियंत्रण निर्देश लौटाता है जो या तो अगले चरणों तक जारी रखते हैं या शाखा समाप्त करते हैं
यह ब्लॉक वर्कफ़्लो रन के दौरान निष्पादन स्थिति बनाए रखता है, और ट्रैक करता है कि डाउनस्ट्रीम चरण अंतिम बार कब निष्पादित हुए थे। depends_on पैरामीटर एक निर्भरता संबंध स्थापित करता है, और rate limiter यह मॉनिटर करता है कि आश्रित चरण कब पूरा होता है ताकि यह निर्धारित किया जा सके कि कूलडाउन अवधि बीत चुकी है या नहीं। वीडियो वर्कफ़्लो के लिए, यह ब्लॉक दीवार-घड़ी समय के बजाय वीडियो-समय-आधारित टाइमस्टैम्प (फ़्रेम संख्या और FPS से गणना किए गए) का उपयोग कर सकता है, जो वीडियो को रियल-टाइम से तेज़ प्रोसेस करते समय उपयोगी है, और यह सुनिश्चित करता है कि थ्रॉटलिंग प्रोसेसिंग गति के बजाय वीडियो समय के सापेक्ष सही ढंग से काम करे।
आवश्यकताएँ
महत्वपूर्ण सीमा: rate limiter वर्तमान में केवल वीडियो प्रोसेसिंग संदर्भों में काम करता है। जब इसे HTTP सेवाओं (Roboflow Hosted API, Dedicated Deployment, या self-hosted inference server) के पीछे चल रहे वर्कफ़्लो में उपयोग किया जाता है, तो HTTP अनुरोधों को प्रोसेस करने पर rate limiting का कोई प्रभाव नहीं होगा, क्योंकि प्रत्येक अनुरोध स्वतंत्र होता है और निष्पादन स्थिति अनुरोधों के बीच बनाए नहीं रखी जाती।
सामान्य उपयोग मामले
महंगे ऑपरेशनों की गति सीमित करना: संसाधन-गहन डाउनस्ट्रीम ऑपरेशनों की आवृत्ति सीमित करें (जैसे, डेटा अपलोड अधिकतम हर 5 सेकंड में चलाना, यदि अधिक बार प्रयास किया जाए तो छोड़ देना), जिससे सिस्टम ओवरलोड से बचाव होता है और उपयोग-आधारित मूल्य निर्धारण वाले ऑपरेशनों की लागत कम होती है
सूचना स्पैम को रोकना: प्राप्तकर्ताओं पर बोझ डालने से बचने के लिए सूचना ब्लॉक्स की गति सीमित करें (जैसे, डिटेक्शन होने पर ईमेल अलर्ट अधिकतम प्रति मिनट एक बार भेजें, अनावश्यक सूचनाएँ छोड़ दें), ताकि अलर्ट प्रासंगिक और कार्य योग्य बने रहें
API दर सीमा अनुपालन: बाहरी API कॉल्स या सेवा एकीकरणों के लिए दर सीमाएँ लागू करें (जैसे, बाहरी सिस्टम को वेबहुक कॉल प्रति सेकंड एक बार तक सीमित करना, API कोटा पार होने से रोकना), ताकि बाहरी सेवा दर सीमाओं का पालन सुनिश्चित हो
डेटाबेस लेखन अनुकूलन: डेटाबेस या डेटा स्टोरेज सिस्टम में लेखन की आवृत्ति कम करें (जैसे, डिटेक्शन परिणाम अधिकतम हर 10 सेकंड में लॉग करना, अपडेट्स को कुशलतापूर्वक बैच करना), जिससे डेटाबेस लोड कम होता है और समग्र सिस्टम प्रदर्शन बेहतर होता है
वीडियो प्रोसेसिंग दक्षता: वीडियो वर्कफ़्लो में प्रोसेसिंग दर नियंत्रित करें, जहाँ फास्ट-फ़ॉरवर्ड प्रोसेसिंग जल्दी कई फ़्रेम उत्पन्न कर सकती है (जैसे, विश्लेषण चरणों को हर 2 सेकंड के वीडियो समय पर प्रोसेस करने के लिए सीमित करना, रियल-टाइम से तेज़ प्रोसेसिंग करते समय सही समय बनाए रखना), सटीक दर सीमांकन के लिए वीडियो-समय-आधारित थ्रॉटलिंग का उपयोग करें
संसाधन प्रबंधन: महंगे मॉडल इन्फरेंस या प्रोसेसिंग चरण कितनी बार चलते हैं, इसे सीमित करके कम्प्यूटेशनल संसाधनों का प्रबंधन करें (जैसे, महंगा विश्लेषण अधिकतम हर 3 सेकंड में एक बार चलाना, अनावश्यक प्रोसेसिंग छोड़ देना), जिससे प्रोसेसिंग गति और संसाधन सीमाओं के बीच संतुलन बना रहे
अन्य ब्लॉक्स से जोड़ना
यह ब्लॉक वर्कफ़्लो के निष्पादन प्रवाह को नियंत्रित करता है और इसे जोड़ा जा सकता है:
वर्कफ़्लो चरणों के बीच जहाँ आप निष्पादन दर सीमित करना चाहते हैं, rate limiter को स्रोत चरण (जिसका संदर्भ में दिया गया है
depends_on) और लक्ष्य चरण (में निर्दिष्टnext_stepsनिष्पादनों के बीच न्यूनतम समय अंतराल लागू करने के लिएसूचना ब्लॉक्स से पहले (उदा., Email Notification, Slack Notification, Twilio SMS Notification) ताकि यह सुनिश्चित करके सूचना स्पैम रोका जा सके कि अलर्ट कूलडाउन अवधि से अधिक बार न भेजे जाएँ, अलर्ट की प्रभावशीलता बनी रहे, और प्राप्तकर्ताओं पर बोझ न पड़े
डेटा संग्रहण ब्लॉक्स से पहले (उदा., Local File Sink, CSV Formatter, Roboflow Dataset Upload, Webhook Sink) ताकि लेखन कार्यों की गति सीमित हो और संग्रहण या नेटवर्क ओवरहेड कम हो, अपडेट्स को कुशलतापूर्वक बैच किया जा सके और अत्यधिक लेखन कार्य रोके जा सकें
बाहरी API एकीकरणों से पहले (उदा., Webhook Sink) ताकि बाहरी सेवा दर सीमाओं का पालन हो, यह सुनिश्चित करते हुए कि API कॉल अनुमत आवृत्ति से अधिक न हों और rate limit त्रुटियाँ न आएँ
वीडियो प्रोसेसिंग वर्कफ़्लो में जहाँ फास्ट-फ़ॉरवर्ड प्रोसेसिंग तेज़ी से फ़्रेम उत्पन्न करती है, उपयोग करते हुए
video_reference_imageताकि वीडियो-समय-आधारित थ्रॉटलिंग सक्षम हो, जो वीडियो को रियल-टाइम से तेज़ प्रोसेस करने पर भी सही ढंग से काम करे, और वीडियो प्लेबैक समय के सापेक्ष सही निष्पादन समय बनाए रखेडिटेक्शन या विश्लेषण ब्लॉक्स के बाद (उदा., Object Detection, Classification, Line Counter) ताकि बार-बार होने वाली डिटेक्शनों या घटनाओं से ट्रिगर होने वाली डाउनस्ट्रीम प्रोसेसिंग की गति सीमित की जा सके, और यह सुनिश्चित किया जा सके कि महंगे ऑपरेशन बहुत अधिक बार न चलें, भले ही डिटेक्शन हर फ़्रेम पर हो
प्रकार पहचानकर्ता
चरण में निम्नलिखित पहचानकर्ता का उपयोग करें "type" फ़ील्ड: roboflow_core/rate_limiter@v1 अपने वर्कफ़्लो में ब्लॉक को एक चरण के रूप में जोड़ने के लिए।
गुण
नाम
प्रकार
विवरण
संदर्भ
name
str
इस चरण के लिए एक अद्वितीय पहचानकर्ता दर्ज करें..
❌
cooldown_seconds
float
दो लगातार next_steps ब्लॉक्स के निष्पादनों के बीच बीतने वाले सेकंडों की न्यूनतम संख्या। rate limiter अंतिम निष्पादन टाइमस्टैम्प को ट्रैक करता है और केवल तभी निष्पादन जारी रखने देता है जब पिछली निष्पादन के बाद कम से कम इतने सेकंड बीत चुके हों। यह 0.0 से बड़ा या उसके बराबर होना चाहिए। वीडियो वर्कफ़्लो के लिए, जब video_reference_image प्रदान किया जाता है, तो यह कूलडाउन अवधि सिस्टम घड़ी समय के बजाय वीडियो समय (फ़्रेम संख्या और FPS से गणना) के आधार पर लागू की जाती है।
❌
यह संदर्भ कॉलम यह दर्शाता है कि गुण को में उपलब्ध गतिशील मानों के साथ पैरामीटराइज़ किया जा सकता है वर्कफ़्लो रनटाइम में। देखें बाइंडिंग्स अधिक जानकारी के लिए।
रनटाइम संगतता
सॉफ्ट - रनटाइम hosted_serverless, dedicated_deployment; निष्पादन रिमोट : कूलडाउन / rate-limit टाइमर प्रोसेस मेमोरी में संग्रहीत होता है। स्टेटलेस या मल्टी-रेप्लिका HTTP रनटाइम पर रिमोट चरण निष्पादन के साथ हर अनुरोध को एक नया वर्कर मिलता है, इसलिए कूलडाउन थ्रॉटल नहीं करता। कूलडाउन केवल InferencePipeline के अंदर स्थानीय चरण निष्पादन के साथ ही दस्तावेज़ित तरीके से व्यवहार करता है।
इनपुट और आउटपुट बाइंडिंग्स
उपलब्ध कनेक्शन उसके बाइंडिंग प्रकारों पर निर्भर करते हैं। जाँचें कि कौन-से बाइंडिंग प्रकार रेट लिमिटर संस्करण v1 हैं।
अंतिम अपडेट
क्या यह उपयोगी था?