Tag Analyzer
- jake shin (Unlicensed)
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 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" 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) or MWA URL/tagview?id=dashboard_id (ex: 127.0.0 .0.1: 5001/tagview?id=board1) 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
Manages the saved Dashboard.
| Button | Description | Remarks |
|---|---|---|
| Retrieves Dashboard in a new tab (window) | |
| Modifies Dashboard Title | |
| Deletes Dashboard |
Request Rollup
Executes the command " EXEC ROLLUP_FORCE ", which is a ROLLUP forced update command . This takes about 6 seconds.
Logout
Logs out of MWA.
Dashboard
Creating Chart
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.
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 | 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
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 ( | Modifies the properties of the Chart. You can change the shape of the chart or add/modify tags. | Apply |
Refresh ( | Draws the chart again. | |
Delete ( | Removes the chart from the Dashboard. |
Chart properties
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 | 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.