> 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/workflows/hi/tutorials/integrate-with-ignition/historical-data.md).

# ऐतिहासिक डेटा

Ignition में Roboflow device के Event Store से निरीक्षण इवेंट और उनकी छवियाँ दिखाएँ, और इतिहास के लिए उन्हें डेटाबेस में कॉपी करें।

Roboflow एज डिवाइस आपके Workflow द्वारा लिखी गई हर घटना को उसकी छवियों और डेटा सहित [Event Store](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/event-store)में रखता है। Ignition इसे HTTP के ज़रिए पढ़ता है, ताकि ऑपरेटर हर निरीक्षण और मॉडल द्वारा जाँची गई छवि देख सकें।

<figure><img src="https://4229620234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-d1b94701b8ac10dd6493371ce0c9802ba3ec293e%2Fignition-events-table.png?alt=media" alt="A Perspective view with a table of recent inspections from the Roboflow Event Store and the image of the selected event"><figcaption><p>Event Store के हाल के निरीक्षण, चुनी गई घटना की छवि सहित।</p></figcaption></figure>

इस पेज में घटनाओं का उपयोग करने के दो तरीके बताए गए हैं:

* डिवाइस से सीधे Perspective टेबल में घटनाएँ दिखाएँ: हाल की घटनाएँ या किसी समयावधि की घटनाएँ, जैसे मौजूदा शिफ्ट की। Ignition कुछ भी सहेजकर नहीं रखता, इसलिए डेटाबेस की ज़रूरत नहीं है।
* रिपोर्ट और उस पुराने इतिहास के लिए, जिसे डिवाइस अब नहीं रखता, गेटवे स्क्रिप्ट की मदद से हर घटना को अपने डेटाबेस में कॉपी करें।

अगर इसके बजाय नवीनतम नतीजे को Ignition टैग के रूप में पाना हो (उदा.: पिछला नतीजा या अस्वीकृत वस्तुओं की गिनती), तो देखें [Live Data](https://docs.roboflow.com/workflows/hi/tutorials/integrate-with-ignition/live-data.md).

## आवश्यकताएँ

* डिवाइस पर स्ट्रीम के रूप में चल रहा एक Workflow, जिसमें [Roboflow Vision Events](https://docs.roboflow.com/workflows/hi/blocks/blocks/data-storage/roboflow-vision-events.md) ब्लॉक का "Write to Local Event Store" विकल्प चालू हो। इस मोड में, ब्लॉक हर घटना को डिवाइस के Event Store में यहाँ लिखता है: `http://localhost:8001` और इसके लिए Roboflow API key की ज़रूरत नहीं होती।
* Ignition गेटवे को पोर्ट `8001`.
* डेटाबेस वाले विकल्प के लिए, Ignition में डेटाबेस कनेक्शन होना चाहिए।

{% hint style="info" %}
ये चरण और स्क्रीनशॉट Ignition 8.1 (Designer 8.1.55) के हैं। अन्य संस्करणों, जिनमें 8.3 भी शामिल है, में मेनू के नाम, डायलॉग और प्रॉपर्टी के नाम अलग हो सकते हैं।
{% endhint %}

## अपनी घटनाएँ देखें

ब्राउज़र में खोलें `http://<device-ip>:8001/v2/events?limit=5` । जवाब में घटनाएँ नवीनतम से पुरानी के क्रम में दिखाई जाती हैं:

```json
{
  "events": [
    {
      "id": "3714e263-8159-4748-83db-ad804dde25cc",
      "stream_id": "bottle-line-1",
      "event_schema": "quality_check",
      "event_data": {"result": "fail", "externalId": "CASE-20437"},
      "custom_metadata": {"bottleCount": 11, "line": "Line 1"},
      "images": [{"file_id": "a1f0c2...", "label": "workflow"}],
      "created_at": "2026-11-13T15:42:10.512Z"
    }
  ],
  "count": 1,
  "next_timestamp": "2026-11-13T15:42:10.512Z"
}
```

`event_data` में ब्लॉक में चुने गए इवेंट प्रकार के फ़ील्ड होते हैं (उदा.: Quality Check के लिए "Result" और "External ID"), और `custom_metadata` में ब्लॉक का "Custom Metadata" होता है। हर छवि यहाँ उपलब्ध होती है: `http://<device-ip>:8001/images/<file_id>`। इसके बारे में और जानें: [Event Store REST API](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/event-store/rest-api).

## Perspective में हाल की घटनाएँ दिखाएँ

1. Perspective व्यू में "Table" कंपोनेंट जोड़ें।
2. टेबल के `props.data` के बगल में बाइंडिंग आइकन पर क्लिक करें और "HTTP" चुनें:
   * URL: `"http://<device-ip>:8001/v2/events?limit=20"`, उद्धरण चिह्नों सहित, क्योंकि URL एक एक्सप्रेशन है।
   * विधि: `GET`.
   * "Polling" चालू करें और इसे इस पर सेट करें `5` सेकंड।
   * "कैश और शेयर" चालू करें, ताकि एक अनुरोध उस दृश्य को दिखाने वाले हर सत्र के लिए काम करे।

<figure><img src="https://4229620234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-a642b31e56d24007c5f9e72da1b151e9a1c64fcc%2Fignition-designer-http-binding.png?alt=media" alt="The Edit Binding dialog for Events.props.data with an HTTP binding: a URL expression to port 8001, Method GET, Cache and Share and Polling every 5 seconds turned on, and a binding preview of the response"><figcaption><p>HTTP बाइंडिंग। प्रीव्यू में Event Store का जवाब और ट्रांसफ़ॉर्म द्वारा बनाई गई पंक्तियाँ दिखाई देती हैं।</p></figcaption></figure>

3. "ट्रांसफ़ॉर्म जोड़ें" पर क्लिक करें, "स्क्रिप्ट" चुनें और हर इवेंट को एक पंक्ति में बदलने वाली स्क्रिप्ट पेस्ट करें:

```python
def transform(self, value, quality, timestamp):
    if value is None:
        return []
    return [
        {
            "time": e["created_at"][11:19],
            "case": e["event_data"].get("externalId"),
            "result": e["event_data"].get("result"),
            "bottles": e["custom_metadata"].get("bottleCount"),
            "image_id": e["images"][0]["file_id"] if e["images"] else None,
        }
        for e in value["events"]
    ]
```

<figure><img src="https://4229620234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-4899a888613e6b261ba8ebc58f27bb7bec1caed7%2Fignition-designer-http-transform.png?alt=media" alt="The Script transform in the HTTP binding dialog, with the transform function that maps each event to time, case, result, bottles and image_id"><figcaption><p>बाइंडिंग डायलॉग में Script ट्रांसफ़ॉर्म।</p></figcaption></figure>

फ़ील्ड को अपने इवेंट के अनुसार बदलें। `event_data` में इवेंट प्रकार के फ़ील्ड होते हैं, और `custom_metadata` में आपका अपना डेटा होता है (जैसे: `bottleCount`). `created_at` UTC में होता है।

बाइंडिंग गेटवे पर चलती है, इसलिए पोर्ट तक पहुँच केवल गेटवे को चाहिए `8001` टेबल के लिए। इनके बारे में और जानें: [HTTP बाइंडिंग](https://docs.inductiveautomation.com/docs/8.3/ignition-modules/perspective/working-with-perspective-components/bindings-in-perspective/http-bindings-in-perspective).

### समयावधि दिखाएँ

किसी समय-बिंदु (जैसे: शिफ़्ट की शुरुआत) के बाद के इवेंट दिखाने के लिए, बाइंडिंग के URL में `start_time` जोड़ें:

```
"http://<device-ip>:8001/v2/events?limit=1000&start_time="
  + replace(dateFormat(setTime(now(60000), 6, 0, 0), "yyyy-MM-dd'T'HH:mm:ssXXX"), "+", "%2B")
```

`setTime(now(60000), 6, 0, 0)` गेटवे के टाइमज़ोन में आज सुबह 6:00 बजे का समय है, और यह एक्सप्रेशन हर मिनट फिर से चलता है। बदलती रहने वाली समयावधि के लिए इसके बजाय `addHours(now(60000), -8)` का उपयोग करें। समयावधि समाप्त करने के लिए इसी तरह `end_time` जोड़ें।

फ़ॉर्मैट में `XXX` को बनाए रखें। इससे टाइमज़ोन ऑफ़सेट जुड़ता है (जैसे: `-05:00`), और Event Store बिना ऑफ़सेट वाले समय को डिवाइस के टाइमज़ोन में पढ़ता है। `replace` फ़ंक्शन सकारात्मक ऑफ़सेट के `+` को एन्कोड करता है, जिसे URL अन्यथा स्पेस में बदल देगा।

हर अनुरोध में नवीनतम इवेंट पहले रखते हुए अधिकतम 1,000 इवेंट लौटते हैं। अगर समयावधि में इससे ज़्यादा इवेंट हों, तो इसे छोटा करें या इवेंट को डेटाबेस में कॉपी करें।

### किसी इवेंट की इमेज दिखाएँ

ऑपरेटर द्वारा क्लिक की गई पंक्ति की इमेज दिखाएँ:

1. दृश्य में नाम की एक कस्टम प्रॉपर्टी जोड़ें `selectedImage`, जिसका मान एक खाली स्ट्रिंग है।
2. टेबल पर राइट-क्लिक करें और "इवेंट कॉन्फ़िगर करें..." चुनें। "कंपोनेंट इवेंट्स" के अंतर्गत, "onRowClick" चुनें, "Script" ऐक्शन जोड़ें और उसकी बॉडी में यह पंक्ति जोड़ें:

```python
self.view.custom.selectedImage = event.value.image_id
```

<figure><img src="https://4229620234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-0c018ca1c9d3983aee10fedac27701663ec506b9%2Fignition-designer-onrowclick.png?alt=media" alt="The Event Configuration dialog on the Events table with onRowClick selected and a Script action that sets self.view.custom.selectedImage"><figcaption><p>टेबल पर मौजूद <code>onRowClick</code> स्क्रिप्ट।</p></figcaption></figure>

3. "Image" कंपोनेंट जोड़ें और `props.source` को किसी एक्सप्रेशन से बाइंड करें:

```
if({view.custom.selectedImage} = "", "", "http://<device-ip>:8001/images/" + {view.custom.selectedImage})
```

image\_id `कॉलम छिपाने के लिए, उसे टेबल के` में जोड़ें: `props.columns` और `visible` का मान `false`.

पर सेट करें। स्क्रिप्ट, अगले पोल में नई पंक्तियाँ जुड़ने पर भी इमेज को यथावत रखती है। टेबल के `props.selection` पर बाइंडिंग लगाने से चयन हट जाएगा, क्योंकि नया डेटा उसे साफ़ कर देता है।

इमेज ऑपरेटर के ब्राउज़र में लोड होती है, इसलिए ऑपरेटर के कंप्यूटर को पोर्ट `8001`.

## इवेंट्स को डेटाबेस में कॉपी करें

लाइव क्वेरी में केवल वही डेटा दिखता है जो अभी डिवाइस पर मौजूद है; स्टोरेज भरने पर पुराने इवेंट हट जाते हैं। इतिहास को अधिक समय तक बनाए रखने या कई डिवाइसों की रिपोर्ट बनाने के लिए, इवेंट्स को डेटाबेस में कॉपी करें। गेटवे टाइमर स्क्रिप्ट तब भी चलती है, जब किसी का सेशन खुला न हो। इसका उपयोग नए इवेंट्स को आपकी बनाई टेबल में कॉपी करने के लिए करें, फिर उस टेबल पर रिपोर्ट बनाएँ।

### टेबल बनाएँ

इस उदाहरण में PostgreSQL का उपयोग किया गया है। अपने डेटाबेस के अनुसार डेटा प्रकारों में बदलाव करें:

```sql
CREATE TABLE roboflow_events (
  id TEXT PRIMARY KEY,
  created_at TIMESTAMPTZ NOT NULL,
  stream_id TEXT,
  event_schema TEXT,
  event_data TEXT,
  image_id TEXT
);
```

इवेंट का `id` प्राइमरी की है, इसलिए स्क्रिप्ट द्वारा दो बार पढ़ा गया इवेंट केवल एक बार संग्रहीत होता है।

### कर्सर टैग बनाएँ

String प्रकार का मेमोरी टैग बनाएँ (उदाहरण: `[default]Roboflow/EventCursor`)। स्क्रिप्ट वहाँ कॉपी किए गए सबसे नए इवेंट का समय संग्रहीत करती है।

### टाइमर स्क्रिप्ट जोड़ें

1. Designer में, Project Browser के "Scripting" > "Gateway Events" खोलें और "Timer" चुनें।
2. टाइमर स्क्रिप्ट जोड़ें। "Choose Timer Settings" में, उसे एक नाम दें, "Delay (ms)" को `5000`पर सेट करें और "Fixed Delay" को वैसे ही रहने दें।

<figure><img src="https://4229620234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-9f84be3b9062822351af742ae2b4e9a82d271073%2Fignition-designer-timer-settings.png?alt=media" alt="The Choose Timer Settings dialog with the name Copy Roboflow Events, Delay 5,000 ms, Enabled, Fixed Delay and Shared threading"><figcaption><p>टाइमर सेटिंग्स।</p></figcaption></figure>

3. यह स्क्रिप्ट पेस्ट करें और डिवाइस का पता तथा डेटाबेस कनेक्शन का नाम बदलें:

```python
DEVICE = "http://192.168.1.50:8001"
DB = "MyDatabase"
CURSOR_TAG = "[default]Roboflow/EventCursor"

client = system.net.httpClient(timeout=10000, version="HTTP_1_1")
cursor = system.tag.readBlocking([CURSOR_TAG])[0].value or "1970-01-01T00:00:00Z"

response = client.get(DEVICE + "/v2/events", params={
    "start_time": cursor,
    "sort_direction": "asc",
    "limit": 1000,
})

if response.good:
    body = response.json
    for event in body["events"]:
        if system.db.runScalarPrepQuery("SELECT 1 FROM roboflow_events WHERE id = ?", [event["id"]], DB):
            continue
        images = event["images"]
        system.db.runPrepUpdate(
            "INSERT INTO roboflow_events (id, created_at, stream_id, event_schema, event_data, image_id) "
            "VALUES (?, CAST(? AS TIMESTAMPTZ), ?, ?, ?, ?)",
            [event["id"], event["created_at"], event["stream_id"], event["event_schema"],
             system.util.jsonEncode(event["event_data"]), images[0]["file_id"] if images else None],
            DB)
    if body["events"]:
        system.tag.writeBlocking([CURSOR_TAG], [body["next_timestamp"]])
else:
    system.util.getLogger("Roboflow").warn("Event Store returned %s" % response.statusCode)
```

<figure><img src="https://4229620234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-bbfd9fb20f6bb1e2bd6bb6ecc30a2118477be1d2%2Fignition-designer-gateway-timer-script.png?alt=media" alt="The Gateway Event Scripts window with the Timer section selected, a timer named Copy Roboflow Events at 5,000 ms, and the script that copies events into the roboflow_events table"><figcaption><p>"Gateway Event Scripts" में टाइमर स्क्रिप्ट।</p></figcaption></figure>

हर बार स्क्रिप्ट कर्सर समय से शुरू करके सबसे पुराने इवेंट पहले माँगती है, और एक बार में अधिकतम 1,000 इवेंट लेती है। यह नए इवेंट संग्रहित करती है और कर्सर को सबसे नए इवेंट तक आगे बढ़ाती है। यदि 1,000 से अधिक इवेंट आए हों, तो अगली बार बाकी इवेंट कॉपी हो जाते हैं। कर्सर समय वाला इवेंट हर बार फिर मिलता है, और `SELECT` उसे छोड़ देता है।

केवल कुछ इवेंट कॉपी करने के लिए, इसमें फ़िल्टर जोड़ें `params` (उदा.: `"event_schema": "quality_check"` या `"metadata_filter": "line:eq:Line 1"`).

{% hint style="warning" %}
डिवाइस का स्टोरेज भरने पर वह पुरानी इमेज हटाता रहता है। उससे पुरानी पंक्तियों का डेटा बना रहता है, लेकिन उनकी इमेज अब लोड नहीं होती। इमेज को अधिक समय तक रखने के लिए, स्क्रिप्ट में उन्हें इस तरीके से डाउनलोड करें `client.get(DEVICE + "/images/" + file_id).body` और बाइट्स को अपने डेटाबेस में संग्रहित करें।
{% endhint %}

## यदि Event Store को कुंजी की आवश्यकता हो

जब तक सेवा पर `API_KEY` सेट न हो, Event Store बिना कुंजी के अनुरोध स्वीकार करता है। यदि यह सेट है, तो कुंजी को इस `X-API-Key` हेडर में भेजें: `headers={"X-API-Key": key}` को `client.get(...)`में जोड़ें, या HTTP बाइंडिंग में हेडर जोड़ें। कुंजी को व्यू में न रखें; उदाहरण के लिए, टैग में वह रखें जिसे बाइंडिंग पढ़ती है।

## समस्या निवारण

<table data-search="false"><thead><tr><th>समस्या</th><th>समाधान</th></tr></thead><tbody><tr><td>स्थिति <code>401</code></td><td>Event Store में एक <code>API_KEY</code>। भेजें <code>X-API-Key</code>.</td></tr><tr><td>तालिका खाली रहती है</td><td>गेटवे के होस्ट से, यह चलाएँ <code>curl http://&#x3C;device-ip>:8001/health</code>। अगर यह विफल होता है, तो गेटवे डिवाइस तक नहीं पहुँच सकता।</td></tr><tr><td>डेटाबेस में पंक्तियाँ आना बंद हो जाती हैं</td><td>कर्सर टैग जाँचें। अगर उसमें भविष्य का समय है, तो उसे साफ़ करें।</td></tr><tr><td>नई घटनाओं के लिए छवि लोड नहीं होती</td><td>ऑपरेटर का कंप्यूटर पोर्ट तक नहीं पहुँच सकता <code>8001</code>, या सेशन HTTPS का उपयोग करता है। देखें <a href="https://docs.roboflow.com/workflows/hi/tutorials/integrate-with-ignition/live-video.md#perspective-over-https">HTTPS पर पर्सपेक्टिव</a>.</td></tr><tr><td>पुरानी घटनाओं के लिए छवि लोड नहीं होती</td><td>डिवाइस ने इसे हटा दिया। डेटाबेस में इवेंट कॉपी करने के अंतर्गत दी गई चेतावनी देखें।</td></tr></tbody></table>

## संबंधित

* [लाइव वीडियो](https://docs.roboflow.com/workflows/hi/tutorials/integrate-with-ignition/live-video.md)
* [लाइव डेटा](https://docs.roboflow.com/workflows/hi/tutorials/integrate-with-ignition/live-data.md)
