> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/query-events.md).

# इवेंट्स क्वेरी करें

dashboard में Vision Events खोजें, फ़िल्टर करें, और ब्राउज़ करें, Agent से प्राकृतिक भाषा में पूछें, या API के माध्यम से query करें

## परिचय

यह पेज बताता है कि विशिष्ट [विज़न इवेंट्स](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events.md) (आपके डिप्लॉय किए गए मॉडल ने क्या देखा, इसका टाइमस्टैम्प सहित रिकॉर्ड) को विज़न इवेंट्स डैशबोर्ड में फ़िल्टर और खोजकर या REST API के ज़रिए कैसे ढूँढ़ें। प्रोडक्शन में व्यवहार का ऑडिट करने और रिपोर्ट बनाने के लिए तारीख की अवधि, इवेंट का प्रकार, डिवाइस, स्ट्रीम, वर्कफ़्लो, पहचानी गई क्लास या फ़ीडबैक स्थिति के अनुसार नतीजों को सीमित करें। आप अपने इवेंट्स के बारे में सामान्य भाषा में सवाल पूछने के लिए [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) से भी पूछ सकते हैं।

### सेव किए गए फ़िल्टर

सेव किया गया फ़िल्टर अपने Use Case से जुड़ा होता है, इसलिए Workspace में हर कोई उसे खोल सकता है। सापेक्ष तारीखें सापेक्ष ही रहती हैं: पिछले 7 दिनों के लिए सेव किया गया फ़िल्टर हमेशा सबसे हाल के 7 दिन दिखाता है। Vision Events बनाने की अनुमति वाला कोई भी व्यक्ति किसी फ़िल्टर पर अपनी सेटिंग सेव कर सकता है। केवल उसे सेव करने वाला व्यक्ति या Vision Events प्रबंधित करने की अनुमति वाला कोई व्यक्ति उसका नाम बदल या उसे मिटा सकता है।

### अपने-आप अंतिम किए गए इवेंट्स

अपने-आप अंतिम किया गया इवेंट एज डिवाइस पर स्वतः बंद कर दिया गया था, क्योंकि पाइपलाइन उसे समय पर (डिफ़ॉल्ट रूप से 1 घंटे में) अंतिम नहीं कर पाई। पाइपलाइन जिस वीडियो को जोड़ना चाहती थी, वह शायद मौजूद न हो। इवेंट में फिर भी उसका परिणाम और स्थिर चित्र मौजूद रहते हैं। यह केवल इनके ज़रिए सिंक किए गए इवेंट्स पर लागू होता है [Edge Device Backup](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/send-events.md#edge-device-backup).

### Agent से पूछे गए सवाल

Agent से इवेंट्स के बारे में पूछने के लिए "View Vision Events" [अनुमति](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control)ज़रूरी है। अगर कोई सवाल आपके Workspace की [डेटा-रखने की अवधि](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events.md#data-retention)से पहले के समय के बारे में पूछता है, तो Agent शून्य इवेंट्स बताने के बजाय वह सबसे पुरानी तारीख बताता है जिसके लिए वह खोज कर सकता है। तारीख की सीमाएँ और समय के खंड UTC का उपयोग करते हैं।

## वेब ऐप

### इवेंट्स फ़िल्टर करें

"Vision Events" खोलें और उसके इवेंट्स देखने के लिए किसी Use Case पर क्लिक करें। इवेंट्स सबसे नए पहले दिखेंगे।

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-95c770d9d0c869e1e12457c562341ea39479ffd2%2Fimage%20(457).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

नतीजों को तारीख, इवेंट ID, इवेंट का प्रकार, डिवाइस, स्ट्रीम, Workflow, पहचान (वैकल्पिक confidence सीमा सहित), फ़ीडबैक, कस्टम मेटाडेटा, वीडियो की संख्या या डेटा ग्रहण करने संबंधी चेतावनियों के अनुसार सीमित करने के लिए फ़िल्टर बार का उपयोग करें। शुरू या समाप्ति की तारीख "Relative" (जैसे, 7 दिन पहले) या "Absolute" (एक निश्चित तारीख और समय) हो सकती है।

टेक्स्ट फ़िल्टर (जैसे, डिवाइस, स्ट्रीम, कस्टम मेटाडेटा) "Contains", "Starts With" या "Ends With" से किसी मान के कुछ हिस्से का मिलान भी कर सकते हैं। ये मिलान बड़े और छोटे अक्षरों में अंतर करते हैं। ज़्यादातर फ़िल्टर यह भी जाँच सकते हैं कि कोई फ़ील्ड "Is Set" है या नहीं। उलटा मिलान करने के लिए "is / is not" टॉगल का उपयोग करें।

ऐसे इवेंट्स ढूँढ़ने के लिए जो फ़िल्टर के एक सेट या दूसरे सेट से मेल खाते हों, फ़िल्टर की एक पंक्ति जोड़ने के लिए "OR" पर क्लिक करें। कोई इवेंट तब दिखता है जब वह कम-से-कम एक पंक्ति के सभी फ़िल्टर से मेल खाता हो। तारीखें सभी पंक्तियों पर लागू होती हैं।

इवेंट विवरण साइडबार में किसी मान (जैसे, डिवाइस ID या कस्टम मेटाडेटा का मान) पर क्लिक करके उसे फ़िल्टर के रूप में जोड़ें। उसका मान या ऑपरेटर बदलने के लिए किसी सक्रिय फ़िल्टर चिप पर क्लिक करें।

मिलान करने वाले इवेंट्स की कुल संख्या नतीजों के ऊपर दिखाई देती है, भले ही सूची अभी लोड हो रही हो। यदि Use Case में [इवेंट मान](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#event-value)हैं, तो मिलान करने वाले इवेंट्स का कुल मान भी दिखाई देता है।

फ़िल्टर दोबारा इस्तेमाल करने के लिए, फ़िल्टर बार की शुरुआत में "Saved Filters" खोलें और "Save Current Filters" पर क्लिक करें। फ़िल्टर साझा करने के लिए "Copy Link" का उपयोग करें। फ़िल्टर कौन बदल सकता है, यह जानने के लिए [Saved Filters](#saved-filters) देखें।

किसी इवेंट को सहेजने के लिए उसे खोलें और हेडर में स्टार पर क्लिक करें, या `S`दबाएँ। आपके स्टार केवल आपको और Use Case को दिखाई देते हैं। उन्हें देखने के लिए, "Saved Filters" के पास "Lists" मेनू खोलें और "Starred" चुनें। स्टार किया गया इवेंट [डेटा-रखने की अवधि](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events.md#data-retention)बीत जाने के बाद भी दिखाई देता रहता है। हर Use Case में आप अधिकतम 1,000 इवेंट्स को स्टार कर सकते हैं।

अपनी सूची बनाने के लिए, "Lists" खोलें और एक सूची बनाएँ—या तो निजी, या Workspace के साथ साझा की गई। स्टार के पास मौजूद सूची बटन से उसमें कोई इवेंट जोड़ें। Vision Events बनाने की अनुमति वाला कोई भी व्यक्ति साझा सूची में इवेंट जोड़ सकता है, लेकिन केवल उसका निर्माता या Vision Events प्रबंधित करने की अनुमति वाला कोई व्यक्ति उसका नाम बदल या उसे मिटा सकता है।

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-6dd0ace6246d420942f5311802af38fd5988065d%2Fimage%20(458).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

### इवेंट का विवरण देखें

किसी इवेंट पर क्लिक करके उसके चित्र, वीडियो क्लिप, स्रोत मेटाडेटा, पूर्वानुमान, इवेंट डेटा, कस्टम मेटाडेटा और [मान](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#event-value).

पर क्लिक करें। यदि इवेंट में पहचानें, सेगमेंटेशन या कीपॉइंट्स हैं, तो उन्हें स्रोत चित्र पर दिखाने के लिए "Draw Detections" चुनें। यह तब मददगार होता है जब आपकी पाइपलाइन केवल इनपुट चित्र सहेजती है। आपका ब्राउज़र सभी इवेंट्स और फ़ुलस्क्रीन दृश्य के लिए यह विकल्प याद रखता है। आउटपुट चित्रों पर यह चेकबॉक्स छिपा रहता है, क्योंकि उनमें पहचानें पहले से दिखाई जाती हैं।

इवेंट कार्ड पर प्ले आइकन का मतलब है कि उसमें [वीडियो क्लिप](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md)हैं। क्लिप चित्रों के बाद "Media" पट्टी में चलती हैं; जो क्लिप अभी प्रोसेस हो रही है, वह तैयार होने पर चलती है। पहचान ओवरले और फ़ुलस्क्रीन केवल चित्रों पर काम करते हैं, और आप [क्लिप को प्रशिक्षण के लिए नहीं जोड़ सकते](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/add-images-for-training.md).

काटे हुए वीडियो आइकन से [अपने-आप अंतिम किया गया इवेंट](#auto-finalized-events)चिह्नित होता है। उसके विवरण दृश्य में दिखता है कि उसे कब अंतिम किया गया था।

### विज़ुअल लुकअप

किसी Use Case में "Visual Lookup" टैब का उपयोग करके फ़्रेम में दिखाई देने वाली चीज़ों के आधार पर उन्हें खोजें। कोई विवरण लिखें (जैसे, रात में फोर्कलिफ्ट) और "Search" पर क्लिक करें। अपने पास मौजूद किसी फ़्रेम जैसे फ़्रेम खोजने के लिए, किसी फ़्रेम पर या इवेंट के विवरण दृश्य में "Find similar frames" पर क्लिक करें। नतीजे समानता के आधार पर क्रमबद्ध होते हैं, सबसे मिलते-जुलते पहले दिखते हैं, और ये सभी मिलानों की पूरी सूची नहीं होते।

खोज को सीमित करने के लिए समयावधि चुनें। किसी फ़्रेम पर क्लिक करके उसका इवेंट नए टैब में खोलें। आप नतीजों से इवेंट्स को स्टार भी कर सकते हैं और [प्रशिक्षण के लिए फ़्रेम जोड़ सकते हैं](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/add-images-for-training.md) । इस टैब को देखने के लिए आपके पास Search Workspace Images अनुमति होनी चाहिए। अपलोड किए गए नए फ़्रेम कुछ मिनट बाद खोजे जा सकते हैं।

### एजेंट से पूछें

बाईं साइडबार में "एजेंट" पर क्लिक करें और [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) से किसी उपयोग के मामले के बारे में पूछें (उदाहरण: "पिछले हफ़्ते assembly-line-qa में कितनी विफलताएँ हुईं?")। यह आपके इवेंट डेटा को क्वेरी करके जवाब देता है। यह इवेंट गिन सकता है, समय के साथ पास और फ़ेल दरों का हिसाब रख सकता है, संख्यात्मक फ़ील्ड के योग, औसत, न्यूनतम, अधिकतम और विशिष्ट मानों की संख्या निकाल सकता है, फ़ील्ड, कस्टम मेटाडेटा, दिन या सप्ताह के अनुसार कुल संख्या को समूहित कर सकता है, और स्वयं इवेंट की सूची दे सकता है (उदाहरण: "मुझे डिवाइस X के इवेंट दिखाएँ")। इवेंट का अगला पृष्ठ देखने के लिए और पूछें।

किसी उपयोग के मामले के Overview या Search टैब में "AI से विश्लेषण करें" पर क्लिक करने से Agent एक नए टैब में खुलता है और उसमें भेजने के लिए एक प्रश्न तैयार रहता है। Search टैब से पूछे जाने पर प्रश्न में आपके मौजूदा फ़िल्टर शामिल होते हैं।

नियमित रूप से ईमेल से भेजी जाने वाली जानकारी के लिए देखें [सारांश रिपोर्ट](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/summary-reports.md).

## HTTP API

### विज़न इवेंट क्वेरी करें

फ़िल्टर, समय-सीमा और पृष्ठांकन के साथ विज़न इवेंट क्वेरी करें। यह एंडपॉइंट इवेंट प्रकार, डिवाइस संदर्भ, पहचान वर्गों, कस्टम मेटाडेटा, इमेज मेटाडेटा और इवेंट-विशिष्ट फ़ील्ड के आधार पर फ़िल्टर करने का समर्थन करता है।

**आवश्यक स्कोप:** `vision-events:read` या `device:read`

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/query" method="post" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% hint style="info" %}
फ़िल्टर `detection` का पुराना नाम `detectionClass`था। अब पुराना नाम स्वीकार नहीं किया जाता।
{% endhint %}

नतीजों में हर वीडियो के लिए केवल उसका `sourceId` और `label`दिखाया जाता है। उसे चलाने या डाउनलोड करने के लिए, [प्लेबैक URL प्राप्त करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md#get-a-playback-url) उसके `sourceId`.

फ़िल्टर के एक सेट या दूसरे सेट से मेल खाने के लिए, उन्हें इस रूप में भेजें: `filterGroup`। सेव किया हुआ फ़िल्टर चलाने के लिए, उसकी ID इस रूप में भेजें: `savedFilterId`आपको वही इवेंट मिलते हैं जो उस फ़िल्टर के लिए Search टैब में दिखते हैं।

### सेव किए गए फ़िल्टर

सेव किए हुए फ़िल्टर वही हैं जो Search टैब में दिखते हैं, इसलिए API के ज़रिए सेव किया गया फ़िल्टर वेब ऐप में भी दिखाई देता है। रॉ API key वर्कस्पेस की ओर से काम करती है और किसी फ़िल्टर की मालिक नहीं होती। किसी भी फ़िल्टर का नाम बदलने या उसे हटाने के लिए, इसके पास यह स्कोप होना चाहिए: `vision-events:manage` । OAuth टोकन अपने उपयोगकर्ता की ओर से काम करता है, इसलिए वह उपयोगकर्ता अपने फ़िल्टर का नाम बदल और उन्हें हटा सकता है: `vision-events:write`। किसी अन्य व्यक्ति के फ़िल्टर में किए गए बदलाव वर्कस्पेस के ऑडिट लॉग में दर्ज होते हैं।

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}/saved-filters" method="get" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}/saved-filters/{savedFilterId}" method="get" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}/saved-filters" method="post" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}/saved-filters/{savedFilterId}" method="patch" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}/saved-filters/{savedFilterId}" method="delete" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

## Python SDK

फ़िल्टर, समय-सीमा और पृष्ठांकन के साथ विज़न इवेंट क्वेरी करें।

### एकल पृष्ठ क्वेरी

इस्तेमाल करें `query_vision_events()` नतीजों का एक पृष्ठ प्राप्त करने के लिए:

```python
import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

page = ws.query_vision_events(
    "a1b3c8e1",                          # use case ID (required)
    event_type="quality_check",          # filter by single event type
    start_time="2024-01-14T00:00:00Z",   # ISO 8601 start time
    end_time="2024-01-15T23:59:59Z",     # ISO 8601 end time
    limit=50,                            # प्रति पेज अधिकतम इवेंट
)

for evt in page["events"]:
    print(evt["eventId"], evt["eventData"])
```

आप अतिरिक्त फ़िल्टर कीवर्ड आर्ग्युमेंट के रूप में भी पास कर सकते हैं। इन्हें सीधे API को भेजा जाता है:

```python
page = ws.query_vision_events(
    "a1b3c8e1",
    event_types=["quality_check", "safety_alert"],
    deviceId={"operator": "eq", "value": "camera-node-5"},
    customMetadataFilters=[
        {"field": "temperature", "operator": "gt", "value": 70, "type": "number"}
    ],
    eventFieldFilters=[
        {"column": "result", "operator": "eq", "value": "fail"}
    ],
)
```

मैन्युअल पेजिनेशन के लिए, `cursor` पैरामीटर के साथ पिछले रिस्पॉन्स से मिला `nextCursor` मान इस्तेमाल करें:

```python
all_events = []
page = ws.query_vision_events("a1b3c8e1", limit=100)
all_events.extend(page.get("events", []))

while page.get("hasMore"):
    page = ws.query_vision_events("a1b3c8e1", cursor=page["nextCursor"], limit=100)
    all_events.extend(page.get("events", []))
```

### सभी नतीजों में पेजिनेशन करें

सभी मेल खाते इवेंट में अपने-आप पेजिनेशन करने के लिए `query_all_vision_events()` का इस्तेमाल करें। यह एक बार में इवेंट का एक पेज देता है:

```python
all_events = []

for page in ws.query_all_vision_events(
    "a1b3c8e1",
    event_type="quality_check",
    start_time="2024-01-14T00:00:00Z",
    end_time="2024-01-15T23:59:59Z",
):
    all_events.extend(page)

print(f"Found {len(all_events)} events")
```

उपलब्ध फ़िल्टर, ऑपरेटर और रिस्पॉन्स फ़ॉर्मैट के पूरे विवरण के लिए देखें [REST API संदर्भ](#http-api).

## MCP सर्वर

अपने AI एजेंट को [MCP Server](https://docs.roboflow.com/agents/mcp-server) से कनेक्ट करें, ताकि वह इन टूल की मदद से आपके इवेंट के बारे में सवालों के जवाब दे सके:

<table data-search="false"><thead><tr><th width="290">टूल</th><th>विवरण</th></tr></thead><tbody><tr><td><code>vision_events_query</code></td><td>फ़िल्टर और पेजिनेशन के साथ प्रोडक्शन विज़न इवेंट क्वेरी करें।</td></tr><tr><td><code>vision_events_use_cases_list</code></td><td>वर्कस्पेस में विज़न इवेंट के उपयोग के मामले सूचीबद्ध करें।</td></tr><tr><td><code>vision_events_custom_metadata_schema_get</code></td><td>किसी उपयोग के मामले के लिए खोजी गई कस्टम मेटाडेटा स्कीमा प्राप्त करें।</td></tr></tbody></table>
