> 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/create-a-vision-event.md).

# एक Vision Event बनाएँ

अपने डिप्लॉय किए गए model से एक observation लॉग करने के लिए HTTP API के माध्यम से एक single Vision Event रिकॉर्ड करें।

## परिचय

एक [विज़न इवेंट](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events.md) आपके डिप्लॉय किए गए कंप्यूटर विज़न मॉडल द्वारा देखी गई किसी चीज़ का टाइमस्टैम्प वाला रिकॉर्ड होता है—उदाहरण के लिए, पहचाना गया दोष या इन्वेंटरी की गिनती—जिसके साथ वैकल्पिक इमेज, पूर्वानुमान और कस्टम मेटाडेटा भी हो सकते हैं। इस पेज पर बताया गया है कि एक इवेंट कैसे रिकॉर्ड करें, ताकि वह आपकी खोजी और फ़िल्टर की जा सकने वाली प्रोडक्शन हिस्ट्री का हिस्सा बन जाए। एक बार में कई इवेंट शामिल करने के लिए, इस्तेमाल करें [विज़न इवेंट्स को बैच में बनाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md)। अगर आपके डिप्लॉयमेंट से क्लाउड तक पहुँचने का कोई मार्ग नहीं है, तो देखें [विज़न इवेंट बंडल अपलोड करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-bundle.md).

## HTTP API

अपने कंप्यूटर विज़न डिप्लॉयमेंट से मिली एक ऑब्ज़र्वेशन रिकॉर्ड करने के लिए एक विज़न इवेंट बनाएँ।

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

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events" 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 %}

### इमेज मेटाडेटा

इस्तेमाल करें `metadata` इमेज ऑब्जेक्ट पर उन वैल्यू को रिकॉर्ड करने के लिए जो केवल उसी इमेज से संबंधित हों, जैसे पास/फेल का नतीजा, सीरियल नंबर या कैमरे का कोण। इवेंट के विवरण वाले दृश्य में ये वैल्यू इमेज के साथ दिखाई जाती हैं। पूरे इवेंट का वर्णन करने वाली वैल्यू जोड़ने के लिए, इसके बजाय इस्तेमाल करें `customMetadata` ।

जो कुंजियाँ `metadata` की सीमाओं का उल्लंघन करती हैं, उन्हें हटा दिया जाता है और `warnings` ऐरे में उनकी सूचना दी जाती है। इमेज का बाकी डेटा फिर भी संग्रहित रहता है।

यह देखने के लिए कि आपके इवेंट्स में कौन-सी कुंजियाँ इस्तेमाल होती हैं, कॉल करें [इमेज मेटाडेटा स्कीमा प्राप्त करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/get-image-metadata-schema.md)। इन कुंजियों के आधार पर इवेंट फ़िल्टर करने के लिए, इस्तेमाल करें `imageMetadataFilters` में [इवेंट्स क्वेरी करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#query-vision-events).

### वैलिडेशन और चेतावनियाँ

विज़न इवेंट्स API में eager ingestion का इस्तेमाल होता है। केवल चार आवश्यक फ़ील्ड (`eventId`, `eventType`, `useCaseId`, `timestamp`) का सख्ती से वैलिडेशन किया जाता है। अगर ये वैलिडेशन पास कर लेते हैं, तो इवेंट हमेशा स्वीकार और संग्रहित किया जाता है, भले ही अन्य फ़ील्ड में त्रुटियाँ हों।

गैर-आवश्यक फ़ील्ड से जुड़ी किसी भी समस्या के कारण अनुरोध अस्वीकार करने के बजाय, प्रतिक्रिया में `warnings` ऐरे के रूप में लौटाया जाता है। इसमें शामिल हैं:

* इनमें आवश्यक फ़ील्ड का मौजूद न होना: `eventData` (उदाहरण: `relatedEventId` के लिए `operator_feedback`)
* इन `eventData` फ़ील्ड की अमान्य वैल्यू (उदाहरण: `severity`)
* के लिए गलत enum वैल्यू) और ऐसी अज्ञात फ़ील्ड जो स्कीमा का हिस्सा नहीं हैं

चेतावनियाँ होने पर, अमान्य `eventData` को एक खाली ऑब्जेक्ट के रूप में संग्रहीत किया जाता है `{}`, लेकिन इवेंट फिर भी बनाया जाता है।

प्रतिक्रिया में `deprecations` ऐरे भी शामिल हो सकता है, यदि अप्रचलित फ़ील्ड नामों का उपयोग किया गया हो।

## Python SDK

अपने कंप्यूटर विज़न डिप्लॉयमेंट से मिली एक ऑब्ज़र्वेशन रिकॉर्ड करने के लिए एक विज़न इवेंट बनाएँ।

```python
import roboflow

roboflow.login()

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

ws.write_vision_event({
    "eventId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "eventType": "quality_check",
    "useCaseId": "a1b3c8e1",
    "timestamp": "2024-01-15T10:30:00Z",
    "eventData": {
        "result": "fail",
        "externalId": "batch-001",
    },
    "customMetadata": {
        "line": "A1",
        "operator": "John Doe",
        "temperature": 72.5,
    },
})
```

इवेंट पेलोड सीधे सर्वर को भेजा जाता है और क्लाइंट-साइड पर इसका कोई सत्यापन नहीं होता, इसलिए नए इवेंट प्रकार और फ़ील्ड SDK अपडेट के बिना काम करते हैं।

**आवश्यक फ़ील्ड:**

* **`eventId`** (स्ट्रिंग, अधिकतम 256 वर्ण): विश्व स्तर पर अद्वितीय पहचानकर्ता। UUID (v4) का उपयोग करें।
* **`eventType`** (स्ट्रिंग): इनमें से एक: `quality_check`, `inventory_count`, `safety_alert`, `custom`, या `operator_feedback`.
* **`useCaseId`** (स्ट्रिंग): वह उपयोग-मामला जिससे यह इवेंट संबंधित है।
* **`timestamp`** (स्ट्रिंग, ISO 8601): इवेंट कब हुआ।

**वैकल्पिक फ़ील्ड:**

* **`eventData`** (डिक्ट): इवेंट-विशिष्ट डेटा।
* **`deviceId`**, **`streamId`**, **`workflowId`** (स्ट्रिंग): संदर्भ पहचानकर्ता।
* **`images`** (लिस्ट): एनोटेशन वाले इमेज ऑब्जेक्ट। देखें [विज़न इवेंट इमेज अपलोड करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-image.md#python-sdk).
* **`videos`** (सूची): वीडियो ऑब्जेक्ट। हर एक का `sourceId` इससे [Vision Event वीडियो अपलोड करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md#http-api).
* **`customMetadata`** (डिक्शनरी): कस्टम मेटाडेटा के अधिकतम 100 कुंजी-मान युग्म।
* **`comment`** (स्ट्रिंग): इवेंट के बारे में एक टिप्पणी, जिसका मुख्य रूप से उपयोग `operator_feedback`.

इवेंट स्कीमा, प्रत्येक प्रकार के इवेंट डेटा स्ट्रक्चर और इमेज एनोटेशन फ़ॉर्मैट की पूरी जानकारी के लिए, देखें [REST API संदर्भ](#http-api).
