Data Points
Table of Contents
- Overview
- Shared Left Pane — Tag Tree Panel
- Stream Screen (
/stream/index) - Trend Screen (
/storage/index) - Snapshot Screen (
/snapshot/index) - Data Export Screen (
/data/index) - Usage Scenarios
- FAQ
- Related Screens
Overview
The Data group bundles four screens that let you query and analyze collected time series data from four different perspectives.
| Submenu | Internal URL | Purpose |
|---|---|---|
| Stream | /stream/index | Displays incoming real-time data for the selected tags as a line chart |
| Trend | /storage/index | Analyzes tag data for a selected period in charts and tables |
| Snapshot | /snapshot/index | Displays representative values sampled at fixed intervals in table form |
| Data Export | /data/index | Bulk-exports data in CSV/Excel format |
All four screens share an identical tag tree panel on the left; only the right-hand area differs according to each screen's function.
Shared Left Pane — Tag Tree Panel
Stream, Trend, and Snapshot all use the same col-lg-3 wide tag tree panel on the left.
┌─────────────────────────────┐
│ 🗂 모델 [💬] [🔍] [📋] │ ← 헤더 + 도구 3개
│ ─────────────────────────── │
│ 🏭 [ 사이트 ▼ ] │ ← 사이트 셀렉터
│ ─────────────────────────── │
│ [에셋] [연결] │ ← 탭 (ADMIN만 연결 탭 표시)
│ ─────────────────────────── │
│ 🔍 검색... │ ← 토글 시 노출
│ ─────────────────────────── │
│ ▶ 자산 트리 │ ← 자산/태그 계층 트리
│ ▶ MOTOR-001 │
│ ▼ MOTOR-001.SPEED │
│ ▼ MOTOR-001.TEMP │
│ ... │
│ ─────────────────────────── │
│ 오브젝트 ID : (hover 시 표시) │ ← 푸터
└─────────────────────────────┘
Three Header Tools
| Button | Icon | Action |
|---|---|---|
| Show tag description option | 💬 | Toggles whether descriptions are shown next to tags in the tree |
| Tag search | 🔍 | Toggles the search input field above the tree |
| Copy selected tag names | 📋 | Copies the checked tag names to the clipboard |
Site Selector
| Item | Form | Action |
|---|---|---|
| Left of input group | 🏭 (industry icon) | — |
| Selector | 사이트명 [설명] options | On change (changeSite()), reloads the tree with that site's assets/connections |
Tabs (Asset / Connection)
| Tab | Visible to | Tree contents |
|---|---|---|
| Asset (default) | Everyone | Site → Area → Line → Equipment → Tag asset tree |
| Connection | ADMIN | OPC server → Channel → Tag (communication-unit tree) |
Each tab has its own search input field (assetSearchInput / opcSearchInput) that expands as a toggle.
Footer — Object ID Preview
Hovering over a tag or asset displays that item's identifier in the Object ID field of the footer, so operators can quickly confirm an ID from the asset name alone.
Stream Screen (/stream/index)
Check tags in the left tree and press Start Streaming to watch data arrive in real time in the chart on the right.
Top Toolbar
🔀 스트림 [▶ 스트리밍 시작] [■] [↻]
| Button | Action |
|---|---|
| Start Streaming (▶, red) | stream() — Starts the real-time push subscription for the checked tags |
| Stop (■) | stop() — Stops streaming (enabled only after starting) |
| Refresh (↻) | refresh() — Resets the screen |
Chart Display Options
Tools at the right of the chart panel header.
| Item | ID | Default | Description |
|---|---|---|---|
| Display (min) | display_minutes | 5 | Time span shown in the chart (in minutes) |
| Add virtual point | (button) | — | addVPoint() — Adds a user-defined virtual point (based on a script calculation) to the chart |
| Settings | (button) | — | setDisplayCount() — Dialog for display count and other options |
Real-Time Chart Area
The chart panel body contains the following areas.
| Item | Display |
|---|---|
result_txt | Small text at the right of the header — summary of the current streaming status |
stream-content (list) | One line chart plus current value per checked tag, one row each |
Before streaming starts, the following guidance is shown.
🖼 [Stream icon]
Tag Data Stream View real-time tag data here. Select tag names in the tag tree on the left, then click the [▶ Start Streaming] button.
Procedure
- Check the tags you want to view in the left tree (multiple allowed)
- Click Start Streaming
- The chart refreshes automatically with incoming data
- If you need a different time span, adjust the Display (min) value at the top right
- When finished, click ■ Stop
Trend Screen (/storage/index)
A screen for analyzing tag data over a selected period using a time series chart and an aggregation table.
Top Search Area
📈 트렌드 [기간 ▭ ▭▭▭▭▭▭▭▭] [샘플링 ▼] [조회] [🎚️] [정지] [전체화면]
| Control | Width | Description |
|---|---|---|
Period input (search_time) | 280px | Start–end date/time (centered, bold). Clicking opens the date range picker. Passed via hidden search_date_from / search_date_to |
Sampling selector (term) | Auto | Disabled by default. Enabled with the 🎚️ button (see Sampling Options below) |
Query (submit_button) | Red + 🔍 | search() — Refreshes the chart and table with the specified conditions |
Sampling options toggle (sampling_button) | Red + 🎚️ | samplingOption() — Shows/hides the sampling selector |
Stop query (cancel_button) | Red + ⏹ | cancel() — Cancels the query in progress (enabled only while querying) |
| Full screen | Red + 🔗 | fullscreen() — Opens the Trend screen full screen in a new window |
Sampling Options
The sampling selector (term) is hidden by default and is turned on with the 🎚️ button. Use it to fetch only lightweight representative values when there is so much data that the chart becomes slow.
| Option | Meaning | Recommended use |
|---|---|---|
(빈 값) — 원본(RAW) | All data | Default. Short periods (hours/days) |
LTTB [0.1%] | Extracts only 0.1% using the LTTB algorithm | Long-term (monthly) trend overview |
LTTB [0.5%] | Extracts only 0.5% | Long-term (monthly) analysis |
LTTB [1%] | Extracts only 1% | Medium-term (weekly) analysis |
LTTB [5%] | Extracts only 5% | Short-term (daily) analysis |
LTTB [10%] | Extracts only 10% | Detailed precision analysis |
1분 주기 | Simple sample at 1-minute intervals | Short-term (daily) sampling |
5분 주기 | 5-minute intervals | Medium-term (weekly) sampling |
30분 주기 | 30-minute intervals | Long-term (monthly) sampling |
1시간 주기 | 1-hour intervals | Long-term trend sampling |
LTTB (Largest-Triangle-Three-Buckets) is a downsampling algorithm that best preserves the visual shape of a time series, optimized for chart display.
Chart Display Options
An inline toolbar at the right of the chart panel header.
| Item | ID | Options | Description |
|---|---|---|---|
| Chart type | chart_type | Line, area, column, smooth line, smooth area | How the chart series is rendered |
| Step line | show_step_line | Standard line / step line | Stepped rendering, as for digital signals |
| Alarm display | show_alarm_flags | Show alarms / hide | Markers on the chart at alarm occurrence times |
| TRIP display | show_trip_line | Show TRIP / hide | Shows trip threshold lines, in multi Y-AXIS mode only |
| C.HEIGHT | chart_height | 100/150(default)/200/250/300/400/500 | Chart height (px) |
| Settings | (button) | — | configure() — Additional chart settings dialog |
| Excel download | (button) | — | downloadXLS() — Downloads the results as Excel |
Chart Area
| Item | ID | Description |
|---|---|---|
| Chart | result_chart | 600px-high time series chart |
| Result count | result_count_txt / result_time_txt | Top right of the chart — number of displayed data points and query elapsed time |
| No-data notice | chart_no_data | "No data to display." (when no tag is selected or the result is empty) |
| Loading indicator | ws_wait_text | "Querying data..." (spinning icon) |
| Execution time | exec_time_txt | Small text at the bottom of the panel — elapsed time of the last query |
Tag Aggregation Table
Aggregate statistics for the selected tags are shown in table form below the chart (storage_table).
┌──────────────────────────── 헤더 (그룹) ────────────────────────────┐
│ 태그ID │ 태그명 │ 데이터 타입 │ 단위 │ 집계 (4 컬럼) │ 액션 │
│ │ │ │ │ 카운트 │첫|끝│최저|최고│평균|합계│ │
└────────────────────────────────────────────────────────────────────┘
| Column | Width | Display |
|---|---|---|
| Tag ID | 90px | Tag identifier |
| Tag name | 220px+ | Human-readable tag name |
| Data type | 80px | INT/FLOAT/BOOL/STRING, etc. |
| Unit | 50px | Unit of measurement (e.g., °C, kPa, rpm) |
| Count | 60px | Number of data points within the query period |
| First | Last | 60px | Values at the start/end of the period |
| Min | Max | 60px | Minimum and maximum values |
| Average | Sum | 60px | Average and sum |
| Action | 40px | Per-row tool buttons |
Add Timeline Dialog
You can overlay an asset-level event timeline on the chart.
| Item | Description |
|---|---|
| Trigger | A separate button in the chart tools (position may vary by chart) |
| Modal title | 🎯 "Add Timeline" |
| Guidance | "Adds an asset event timeline to the chart. Select an asset, then click the [Add Timeline] button." |
| Asset selection | t_asset_id selector (240px) — select from the list of registered equipment |
| Confirm | Add Timeline button |
Once a timeline is added, that asset's events (running/stopped/abnormal) are drawn as colored bars below the chart for comparison against the time series.
Snapshot Screen (/snapshot/index)
Snapshot has a layout similar to Trend but is optimized for viewing only values sampled at fixed intervals (in minutes) in table form.
Top Search Area
🔪 스냅샷 [기간 ▭▭▭▭] [간격 ▼] [조회] [↻]
| Control | Description |
|---|---|
Period input (search_time) | Same as Trend (280px, centered) |
Interval selector (term) | System-defined snapshot interval options (e.g., 1_MIN/5_MIN/30_MIN/1_HOUR/1_DAY) |
| Query | search() — Refreshes the table with the specified conditions |
| Refresh | refresh() — Resets the screen |
Left Pane
The same tag tree panel as Stream/Trend (site selector, Asset/Connection tabs, search).
Right Pane
Displays the snapshot values of the tags checked in the left tree in chronological order. It is a table in which each row is one point in time and each column is the value of one tag.
Example use: observing 5 tags at 1-minute intervals for a week → organized as 10,000 rows × 5 columns, easy to move into external tools.
Data Export Screen (/data/index)
A screen for bulk-exporting collected data (CSV/Excel).
| Area | Contents |
|---|---|
| Top toolbar | Period/site/tag selection + output format selection |
| Output format | CSV / Excel (.xlsx) — one or both, depending on the system environment |
| Download | On click, the server generates the file and downloads it |
The larger the data volume, the longer the download takes. For more than 1 million records, we recommend splitting the period into several exports.
Usage Scenarios
| Scenario | Screen | Example settings |
|---|---|---|
| Monitoring current line operation | Stream | Check 5 key tags in the line asset tree → Display 5 min → Start |
| Analyzing last night's shift trend | Trend | Period 21:00–07:00 / Sampling 1 min / Chart type line |
| Comparing a remote line over a month | Trend | Period 1 month / Sampling LTTB 1% / TRIP display ON |
| Reconstructing conditions just before an alarm | Trend | Period alarm time ±10 min / Alarm display ON / Add timeline |
| Data for daily reports at 30-minute granularity | Snapshot | Period 24 hours / Interval 30_MIN |
| Moving data to an external analysis tool | Data Export | 1 week + 5 key tags → CSV download |
FAQ
Q. I started streaming, but the chart does not fill in. A. Check that you have checked tags in the left tree. Also check whether the pipeline card on the Dashboard shows 0 — data ingestion itself may have stopped.
Q. Trend queries are very slow. A. There is too much data. Turn on the sampling selector with the 🎚️ button and downsample with LTTB (e.g., 1%) or a time interval (e.g., 5 minutes).
Q. There are so many chart series that readability suffers. A. Click a series name in the legend at the top right of the chart to toggle that series between shown and hidden. Unchecking a tag in the left tree also removes it from the chart.
Q. I enabled the alarm display option, but no markers appear on the chart. A. No alarm occurred for that tag within the query period. Check the occurrence history first on the Alarm screen.
Q. The TRIP line is not visible. A. TRIP lines are shown only in multi Y-AXIS mode (when several tags each have their own Y axis). In single Y-axis mode they are not shown, for chart readability.
Q. What is the difference between Stream and Trend? A. Stream shows data arriving now; Trend shows data already stored. Stream also refreshes automatically, whereas Trend refreshes only when the operator explicitly presses Query.
Q. What is a virtual point? A. A user-defined point that is not an actual sensor tag but is produced by calculating from the values of other tags — for example, the difference between two temperature sensors, or pressure × flow. Define one with the Add virtual point button on the Stream screen.
Q. My Excel download comes out as an empty file. A. An empty file is generated when the chart is empty or the query returned no results. Confirm that the chart renders correctly before downloading.
Q. What happens if I check too many tags on one screen? A. For chart readability and rendering speed, we recommend limiting yourself to 10–20 at a time. Beyond that, reduce the data volume with LTTB sampling.
Related Screens
- Dashboard — Data ingestion trends per site at a glance
- Daily Statistics — Daily comparative analysis by site, line, and equipment
- Predictive Analytics — Learns from tag data for forecasting and outlier detection
- Alarm — Linked with alarm display on trend charts
- Factory Management — Asset and tag registration
- Status Code Definitions — Data types and status codes