सामग्री पर जाएं
For the complete documentation index, see llms.txt. This page is also available as Markdown.

दर सीमक

Workflow की उस शाखा की रन दर सीमित करता है।

डाउनस्ट्रीम वर्कफ़्लो चरणों के निष्पादनों के बीच न्यूनतम समय अंतराल लागू करें, निष्पादन आवृत्ति को सीमित करें और जुड़े हुए चरणों को निर्दिष्ट कूलडाउन अवधि से अधिक बार न चलाकर अधिक-निष्पादन को रोकें।

यह ब्लॉक कैसे काम करता है

यह ब्लॉक क्रमिक निष्पादनों के बीच कूलडाउन अवधि लागू करके वर्कफ़्लो शाखाओं की निष्पादन दर को सीमित करता है। यह ब्लॉक:

  1. एक कूलडाउन अवधि (सेकंड में), एक depends_on संदर्भ, और next_steps इनपुट के रूप में

  2. आंतरिक स्थिति चर का उपयोग करके अंतिम निष्पादन का टाइमस्टैम्प ट्रैक करता है

  3. वर्तमान समय की गणना करता है:

    • वीडियो प्रोसेसिंग के लिए: वीडियो मेटाडेटा (फ़्रेम संख्या और FPS) का उपयोग करके वीडियो-समय-आधारित टाइमस्टैम्प की गणना करता है जब video_reference_image प्रदान किया जाता है

    • अन्य संदर्भों के लिए: सिस्टम घड़ी का समय (datetime.now()) का उपयोग करता है

  4. अंतिम निष्पादन के बाद बीता समय इसकी तुलना करता है cooldown_seconds सीमा

  5. यदि पर्याप्त समय बीत चुका है (बीता समय >= cooldown_seconds):

    • अंतिम निष्पादन टाइमस्टैम्प अपडेट करता है

    • निर्दिष्ट तक निष्पादन जारी रखता है next_steps ब्लॉक्स

  6. जिससे डाउनस्ट्रीम प्रोसेसिंग संभव होती है

    • वर्तमान वर्कफ़्लो शाखा समाप्त करता है, और कूलडाउन अवधि समाप्त होने तक डाउनस्ट्रीम निष्पादन को रोकता है

  7. फ़्लो नियंत्रण निर्देश लौटाता है जो या तो अगले चरणों तक जारी रखते हैं या शाखा समाप्त करते हैं

यह ब्लॉक वर्कफ़्लो रन के दौरान निष्पादन स्थिति बनाए रखता है, और ट्रैक करता है कि डाउनस्ट्रीम चरण अंतिम बार कब निष्पादित हुए थे। 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 हैं।

इनपुट और आउटपुट बाइंडिंग्स
  • इनपुट

    • depends_on (*): उस वर्कफ़्लो चरण का संदर्भ जो इस rate limiter ब्लॉक से ठीक पहले आता है। यह निर्भरता संबंध स्थापित करता है - rate limiter यह मॉनिटर करता है कि यह चरण कब पूरा होता है ताकि यह निर्धारित किया जा सके कि अंतिम निष्पादन के बाद कूलडाउन अवधि बीत चुकी है या नहीं। depends_on चरण कोई भी ऐसा वर्कफ़्लो ब्लॉक हो सकता है जिसका आउटपुट rate-limited डाउनस्ट्रीम प्रोसेसिंग को ट्रिगर करता है..

    • next_steps (चरण): जिन वर्कफ़्लो चरणों को execute करना है यदि rate limit अनुमति देता है (अर्थात, अंतिम निष्पादन के बाद पर्याप्त समय बीत चुका है)। ये चरण केवल तभी control flow प्राप्त करते हैं जब कूलडाउन अवधि बीत चुकी हो, जिससे throttled डाउनस्ट्रीम प्रोसेसिंग सक्षम होती है। यदि कूलडाउन अवधि नहीं बीती है, तो शाखा समाप्त होने के कारण ये चरण execute नहीं होंगे। प्रत्येक step selector उस workflow के ब्लॉक को संदर्भित करता है जिसे rate limiting अनुमति देने पर execute किया जाना चाहिए..

    • video_reference_image (image): वीडियो-समय-आधारित टाइमस्टैम्प जनरेशन के लिए उपयोग करने हेतु वीडियो फ़्रेम छवि का वैकल्पिक संदर्भ। प्रदान किए जाने पर, rate limiter सिस्टम घड़ी समय के बजाय वीडियो मेटाडेटा (फ़्रेम संख्या और FPS) के आधार पर टाइमस्टैम्प की गणना करता है। यह तब उपयोगी होता है जब वीडियो को रियल-टाइम से तेज़ प्रोसेस किया जा रहा हो, क्योंकि यह सुनिश्चित करता है कि rate limiting प्रोसेसिंग गति के बजाय वीडियो प्लेबैक समय के सापेक्ष सही ढंग से काम करे। यदि प्रदान नहीं किया गया (None), तो ब्लॉक सिस्टम घड़ी समय (datetime.now()) का उपयोग करता है। यह केवल वीडियो प्रोसेसिंग वर्कफ़्लो पर लागू होता है..

  • आउटपुट

उदाहरण JSON परिभाषा

अंतिम अपडेट

क्या यह उपयोगी था?