Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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
Rollup 데이터가 발견되지 않으면 아래 단계의 Rollup에서 데이터를 찾는다

If no rollup data is found, the data is searched for in the rollup a step below.

Y
MAX_TAG_COUNT
하나의 Chart에서 사용할 수 있는 최대 Tag의 수

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
Dashboard 지정없이 Tag Analyzer를 호출했을때 선택되는 Dashboard를 선택한다

Selects the Dashboard to be selected when Tag Analyzer is called without specifying Dashboard.

없음.(New Dashboard)

None (New Dashboard)

Query Timeout
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를 새 탭(창)에서 조회한다.

Image Removed

Dashboard의 Title을 수정한다.

Image Removed

Dashboard를 삭제한다.
Request Rollup

...

Retrieves Dashboard in a new tab (window)

Image Added

Modifies Dashboard Title

Image Added

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. 
If you change the Board ID, a new Dashboard will be created if "Save as Copy" is checked, otherwise the Board ID will be changed.

Board ID can only contain alphanumeric characters and underscore (_)

Time Range

Sets the time range to be inquired and the refresh interval.

  • Time range: It is possible to specify relative time using time selection (input) or now. 
    (ex: now, now-5d, now-3M)
단위 : now를 기준으로
  • The time specification based on now y (year), M (month),
w(week : Mon - Sun), d
  • d (day), h (hour), m (minute), and s (second)
사용 가능하다Refresh 주기 :
  • is possible.
  • 옵션 : "/"를 사용하여 특정기간을 쉽게 지정할 수 있다.
    예 : 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
    • Refresh cycle: It is possible to input in h (hour), m (minute), s (second)
    단위로 입력이 가능하며 입력된 주기로 Dashboard가 다시 그려진다.Chart 설정에서 별도로 시간범위나 Refresh 주기를 설정하면 Dashboard의 설정과 무관하게 자체 설정 값을 기준으로 동작한다
    • unit.

    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
    모든 Chart를 Refresh 한다

    Refreshes all charts.


    Share Dashboard

    현재의 Dashboard를 새로운 탭(창)에서 조회한다.(조회용 URL로 open)

    Save된 경우에만 가능

    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.

    ButtonDescriptionRemarks

    Preview ()

    해당 Chart만  새로운 탭(창)에서 조회한다
    Only the corresponding chart is displayed in a new tab (window).

    Edit options ()

    Chart의 property를 수정한다. Chart의 모양을 변경하거나 Tag를 추가/수정할 수 있다.수정후 Image Removed를 눌러야 적용Modifies the properties of the Chart. You can change the shape of the chart or add/modify tags.

    Apply Image Added after modifying

    Refresh ()

    Chart를 다시 그린다Draws the chart again.

    Delete ()

    Chart를 Dashboard에서 제거한다Removes the chart from the Dashboard.

    Chart properties

    Property는 하단의 패널에서 수정하고 Image Removed를 눌러서 수정된 것을 확인한 다음 상단의 Image Removed를 누르면 적용이 된다. 각 탭별 Property는 아래와 같다Property is modified in the bottom panel, press (tick) to confirm that it has been modified, and  then click on the top (tick) 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 
    -

    ...

    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 chartN
    Raw data time rangeBasic time range in Raw Data

    ...

    Chart5000

    ...

    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. modeThe 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, 
    the value of the earliest tag is selected in alphabetical order.
    Alias
    Alias ​​used in charts instead of Tag Names

    Tag Name if blank

    Weight
    Weight by tag when using Normalize
    1Value 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.
    Select items from registered in the 'Data' tab.



    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.