Tag Analyzer는 Tag Table의 ROLLUP 기능을 활용하여 데이터들을 Chart로 조회/분석할 수 있는 기능을 제공한다.
설정
MWA에서 호출이 되므로 MWA가 사용가능해야 하며, 사용되는 Table은 TAG Table로 지정되어 있다.
The Tag Analyzer provides the ability to query and analyze data by using the ROLLUP function of Tag Table.
Configuration
MWA must be available because it is called in MWA, and the table used is specified in the TAG table.
Among the settings defined in $MACHBASE_HOME/webadmin/flask/MWA.conf 파일에 정의된 설정 중에서 Tag Analyzer에서 사용되는 항목은 아래와 같다.
...
file, the items used by Tag Analyzer are as follows.
Item | Description | Default Value |
|---|---|---|
| USE_TAG_ANALYZER_AUTO_DRILLDOWN |
If no rollup data is found, the data is searched for in the rollup a step below. | Y |
| MAX_TAG_COUNT |
The maximum number of tags available in a chart | 12 |
시작
...
Start
When you run MWA, click "Tag View" 를 클릭하면 새로운 탭(창)에 Tag Analyzer가 실행된다.MWA에 로그인되어 있는 상태라면 on the top left of the visible menu to run Tag Analyzer on the new tab (window).
If you are logged in to MWA, you can directly connect to the Tag Analyzer using the MWA URL/tagview (예ex: 127.0.0.1:5001/tagview) 를 사용하여 Tag Analyzer에 직접 접속할 수 있으며, 저장된 Dashboard가 있는 경우 or MWA URL/tagview?id=dashboard_id (예ex: 127.0.0 .0.1: 5001/tagview?id=board1) 를 입력하면 해당 Dashboard를 바로 조회할 수 있다.
사용법
Tag Analyzer는 여러 개의 Chart로 구성된 Dashboard 형태로 구성되며 Dashboard의 각 열은 하나의 Chart로 구성된다.
개요
좌측 상단에 Tag Analyzer를 관리하는 메뉴가 표시된다.
Dashboard 선택
저장된 Dashboard중에서 현재 화면에 표시되는 Dashboard를 선택한다.
New Dashboard
새로운 Dashboard를 생성한다.
Set
Preference
Tag Analyzer의 환경을 설정한다.
...
to display the corresponding Dashboard.
How to use
The Tag Analyzer consists of a Dashboard consisting of several charts. Each column of the Dashboard consists of one Chart.
Overview
In the top left corner, a menu for managing the Tag Analyzer is displayed.
Select Dashboard
Select the Dashboard that is displayed on the current screen among the saved Dashboards.
New Dashboard
Creates a new Dashboard.
Preference
Sets the environment of the Tag Analyzer.
Item | Description | Default Value |
|---|---|---|
| UI Thema | Sets the background color of the Dashboard. (machIoTchartBlack/machIoTchartWhite) | machIoTchartBlack |
| Home Dashboard |
Selects the Dashboard to be selected when Tag Analyzer is called without specifying Dashboard. | 없음.(New Dashboard) None (New Dashboard) |
| Query Timeout |
If there is no response within the time set in the Query call, a Timeout error is generated. | 20 |
Manage Dashboard
저장된 Dashboard를 관리한다Manages the saved Dashboard.
| 버튼Button | 설명Description | 비고Remarks | |||
|---|---|---|---|---|---|
| Dashboard를 새 탭(창)에서 조회한다. |
| Dashboard의 Title을 수정한다. |
| Dashboard를 삭제한다. |
Request Rollup
...
| Retrieves Dashboard in a new tab (window) | ||
| Modifies Dashboard Title | |
| Deletes Dashboard |
Request Rollup
Executes the command " EXEC ROLLUP_FORCE" 명령을 실행시킨다. 약 6초간의 시간이 소요된다 ", which is a ROLLUP forced update command . This takes about 6 seconds.
Logout
MWA에서 logout 한다Logs out of MWA.
Dashboard
Creating Chart
...
Dashboard의 각 열은 하나의 Chart로 구성되며 제일 하단의 패널에 표시된 + 버튼을 눌러서 Chart를 생성할 수 있다.
사용할 Tag들과 집계방법을 선택하고 Chart 유형을 선택하면 Chart가 생성된다. 선택된 Tag 목록에 있는 Tag를 Click하면 선택이 취소된다.
설정
Dashboard에 관련된 버튼은 우측 상단에서 찾을 수 있다.
...
현재의 Dashboard를 저장한다.
Board ID는 조회시 URL에 사용된다.
Board ID를 변경하면, "Save as Copy"가 체크된 경우에는 새로운 Dashboard가 생성되며 그렇지 않으면 Board ID가 변경된다.
...
Time Range
조회할 시간범위와 Refresh 주기를 설정한다.
...
Each row in the Dashboard consists of a single chart . You can create a chart by pressing the + button on the bottom panel.
Select the tags and aggregation method you want to use and select Chart type to create a chart. Click on the Tag in the Selected Tag list to deselect it.
Configuration
The buttons related to Dashboard can be found in the upper right corner.
Button | Description | Remarks |
|---|---|---|
| Save Dashboard | Saves the current Dashboard. The Board ID is used in URLs when viewed. | Board ID can only contain alphanumeric characters and underscore (_) |
Time Range | Sets the time range to be inquired and the refresh interval.
|
|
|
|
예 : now = 2021-03-04
Today
설정 : from = now/d, to = now/d
결과 : 2021-03-04 00:00:00 ~ 2021-03-04 23:59:59
Previous year
설정 : from = now-1y/y, to = now-1y/y
결과 : 2020-01-01 00:00:00 ~ 2020-12-31 23:59:59,
Last ~ This week (2weeks)
설정 : from = now-1w/w, to = now/w
결과 : 2021-02-22 00:00:00 ~ 2021-03–07 23:59:59
|
If you set the time range or the refresh interval separately in Chart setting, it operates based on its own setting value regardless of Dashboard setting. | YYYY-MM-DD HH24:MI:SS |
| Refresh all |
Refreshes all charts. | |
| Share Dashboard |
현재의 Dashboard를 새로운 탭(창)에서 조회한다.(조회용 URL로 open)
Chart
선택된 Tag들과 집계방법으로 Chart가 그려진다. 마우스를 Chart에서 움직이면 시간 및 Series별 값을 확인 할 수 있다.
아래 부분에 표시된 범례(legend)를 클릭하면 선택한 Tag의 그래프만 볼 수 있으며 같은 Tag를 다시 클릭하면 다시 모든 Series를 볼 수 있다.
또한 범례 중 Chart 색 부분을 클릭하면 선택한 Tag의 Alias를 설정할 수 있다.
Zoom
Chart에서 확대해서 보고 싶은 부분을 마우스로 Drag해서 선택하면 해당 되는 부분을 자세히 볼 수 있다. Chart의 아래 부분에 Time Range에 따른 전체 그래프가 나타나고 그 중에서 현재 Chart에 그려지는 부분이 표시된다. Chart에 표시되는 부분이 점점 확대가 되면 초단위 ROLLUP 데이터까지 표시가 되다가 선택된 부분이 아주 작아지면 원시자료(raw data)를 표시하는 Chart가 그려진다.
Raw data chart의 경우 Chart Header에 표시되는 Time Range의 좌우에 시간을 이동할 수 있는 버튼이 표시가 되어 Chart를 이동하면서 조회할 수 있다. Raw data chart는 선택 범위가 아주 작으므로 viewport를 사용하여 이동할 수 없다.
Zoom모드에 있는 경우 Auto Refresh는 동작하지 않는다.
- viewport : Chart 아래 부분에 전체 그래프가 표시되는 부분. Chart의 일부를 확대해서 볼 때만 표시된다.(Zoom 모드로 시작하는 것이 기본 값이다.) viewport 좌측에 있는 [x]를 누르면 Zoom 모드를 종료하고 viewport를 닫는다.
- window : viewport 중에서 현재 Chart에 그려지는 부분을 표시한다. 마우스로 Drag하여 이동할 수 있으며, 좌우측 끝부분을 Drag하면 크기를 변경하여 Chart를 확대 축소할 수 있다.
viewport buttons : viewport를 이동하거나 조작하는데 사용되는 button들이다.
...
Retrieves the current Dashboard in a new tab (window) ( open as a URL for viewing) | Only available if saved |
Chart
Charts are drawn with selected tags and aggregation method. You can see the time and series value by moving the mouse in the chart.
You can see the graph of the selected tag by clicking on the legend shown in the bottom part, and you can see all series again by clicking the same tag again.
Zoom
If you select the part you want to enlarge in the chart by dragging it with the mouse, you can see the corresponding part in detail. In the lower part of the chart, the whole graph according to Time Range is displayed, and the portion drawn in the current chart is displayed. When the part displayed on the chart is enlarged, the ROLLUP data in seconds is displayed, and if the selected part becomes very small, a chart showing raw data is drawn.
In the case of Raw data chart, a button to move the time to the left and right of the Time Range displayed in the Chart Header is displayed and can be viewed while moving the Chart. Raw data charts are so small that they can not be moved using the viewport.
Auto Refresh does not work when in Zoom mode.
- viewport: The part of the chart where the entire graph is displayed. Displayed only when zoomed in on a part of the chart (starting with Zoom mode is the default). Press [x] on the left side of the viewport to exit Zoom mode and close the viewport.
- window: Displays the portion of the viewport currently drawn in the chart. You can move it by dragging with the mouse. You can enlarge or reduce the chart by changing the size by dragging the left and right ends.
- viewport buttons: These buttons are used to move or manipulate the viewport.
Button | Description | Remarks |
|---|---|---|
| Time Range | Sets the Time Range using the time and duration. | From & 6M |
| Undo | Cancels the Zoom |
...
operation. The right mouse button also performs the same function. | Currently, only available with previous Zoom. | |
| Reset | Sets the Time Range to the minimum to maximum of all data. | |
| Center | Adjusts the Time Range so that the current window is centered in the viewport. | |
| Resize | Adjust the Time Range so that the current window is centered at 20%. | |
| - , + |
...
Zooms in / out the window to the left (right). | Zoom out / Zoom in |
| << , < , > , >> |
...
Moves the window 100% (50%) |
...
left and right. |
Chart buttons
Chart의 우측 상단에 표시되는 버튼으로 아래와 같다.
...
The buttons on the upper right of the chart are as follows.
| Button | Description | Remarks | |
|---|---|---|---|
Preview ( | Only the corresponding chart is displayed in a new tab (window). | ||
Edit options ( | Chart의 property를 수정한다. Chart의 모양을 변경하거나 Tag를 추가/수정할 수 있다. | 수정후  를 눌러야 적용Modifies the properties of the Chart. You can change the shape of the chart or add/modify tags. | Apply |
Refresh ( | Chart를 다시 그린다Draws the chart again. | ||
Delete ( | Chart를 Dashboard에서 제거한다Removes the chart from the Dashboard. |
Chart properties
Property는 하단의 패널에서 수정하고 
를 눌러서 수정된 것을 확인한 다음 상단의 
를 누르면 적용이 된다. 각 탭별 Property는 아래와 같다Property is modified in the bottom panel, press 
to confirm that it has been modified, and then click on the top to apply. The property of each tab is as follows.
General
| Property |
|---|
...
Description |
|---|
...
Default Value |
|---|
...
Remarks |
|---|
| Chart Title |
...
Chart Title | Chart Title | |
| Width |
...
Chart Width (0: |
...
Full Size) | 0 |
...
Currently, there is no meaning except 0 |
| Height |
...
Chart Height (0: |
...
Full Size) | 300 |
...
Currently 0 is calculated as 300 |
| Action On Click |
...
Actions when clicking on the chart node |
...
Action |
...
Shows Raw data |
...
chart |
...
Shows Raw data table | No Action |
...
Show Raw data chart means the chart corresponding to the time range of the clicked node. |
| Zoom |
...
Whether to zoom when dragging Chart | Y | |
| Drill down |
...
Whether to drill down when zooming | Y | |
| Start with Zoom |
...
When you drawing chart, start in Zoom mode. | Y |
...
Since Auto Refresh does not work in Zoom state, this function should be turned off to use Auto Refresh. |
| Normalize |
...
| Whether use normalize at chart | N | |
| Raw data time range | Basic time range in Raw Data |
...
| Chart | 5000 |
...
The value must be written in millisecond (ms) |
...
units. |
Data
...
Changes the tag to use and the aggregation method.
| Property |
|---|
...
| Description |
|---|
...
| Default Value |
|---|
...
| Remarks | |
|---|---|
| Calc. mode | The way to Tag Data |
...
| Average | ||
| Tag Names |
...
| Name of tag | It becomes one series when you type multiple tags with "," |
...
. If there are several tags corresponding to the time zone, | |||
| Alias | Alias used in charts instead of Tag Names | Tag Name if blank | |
| Weight | Weight by tag when using Normalize | 1 | Value must be between 0 and 1. |
Axes
| Property |
|---|
...
Description |
|---|
...
Default Value |
|---|
...
Remarks |
|---|
| Interval |
...
Sets the time interval on the X axis. If not specified, it is automatically calculated according to the time range and screen size. | Supports h, m, and s |
...
| Show tick line (X-axis) |
...
Shows the grid corresponding to the X-axis scale (vertical line). | Y | |
| Pixels between tick marks |
...
Sets the pixel between the X axis scale. | 3 | |
| Start at zero (Y-axis) |
...
| Y-axis start with 0. | N | |
| Show tick line (Y-axis) |
...
| Shows the grid corresponding to the Y-axis scale (horizontal line). | Y | |
| Custom scale |
...
Sets the range of scale on the Y axis. If not specified, it is specified automatically using minimum value and maximum value. | ||
| Custom scale for drill down chart |
...
Sets the scale of the Y scale of the drill down chart . If not specified, it is specified automatically using minimum value and maximum value. | ||
| Set additional Y-axis. |
...
| Use additional Y-axis. | N | |
| Position of Y-axis |
...
| Set where additional Y-axis draw. | Right | |
| Select tags for Y-axis 2 |
...
Select the data to use the added Y axis. |
Display
| Property |
|---|
...
Description |
|---|
...
Default Value |
|---|
...
Remarks |
|---|
| Show data points |
...
Displays the point on the chart's node. | N | |
| Point radius |
...
The radius of the displayed point (pixel) in the above case | 3 | |
| Legend |
...
Displays legend. | Y | |
| Opacity of fill area |
...
Sets the transparency of the fill area of the graph. | 0.15 | 0: |
...
transparent, 1: |
...
opaque |
| Line thickness |
...
Sets the leading edge of the line chart. | 1.5 | 0: |
...
no line |
| Border color |
...
Sets the border color of the chart. If not input, it is set to Background Color. | Enter "#" when changing and input "none" when changing to input space. |
Time Range
Enters the Time Range and Refresh period that apply only to this chart. When these values are set, the chart will only work with this value, regardless of the Dashboard settings.