/
태그 분석기 (Tag Analyzer)

태그 분석기 (Tag Analyzer)

Owned by Grey Shim
Jan 17, 2022

Tag Analyzer는 Tag Table의 ROLLUP 기능을 활용하여 데이터들을 Chart로 조회/분석할 수 있는 기능을 제공한다.

설정

MWA에서 호출이 되므로 MWA가 사용가능해야 하며, 사용되는 Table은 TAG Table로 지정되어 있다.

$MACHBASE_HOME/webadmin/flask/MWA.conf 파일에 정의된 설정 중에서 Tag Analyzer에서 사용되는 항목은 아래와 같다.

항목설명기본값
USE_TAG_ANALYZER_AUTO_DRILLDOWNRollup 데이터가 발견되지 않으면 아래 단계의 Rollup에서 데이터를 찾는다.Y
MAX_TAG_COUNT하나의 Chart에서 사용할 수 있는 최대 Tag의 수12

시작

MWA를 구동하면 보이는 상단의 메뉴중 제일 좌측의 "Tag View"를 클릭하면 새로운 탭(창)에 Tag Analyzer가 실행된다.

MWA에 로그인되어 있는 상태라면 MWA URL/tagview(예: 127.0.0.1:5001/tagview)를 사용하여 Tag Analyzer에 직접 접속할 수 있으며, 저장된 Dashboard가 있는 경우 MWA URL/tagview?id=dashboard_id(예: 127.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의 환경을 설정한다.

항목설명기본값
UI ThemaDashboard의 배경색을 설정한다. (machIoTchartBlack / machIoTchartWhite)machIoTchartBlack
Home DashboardDashboard 지정없이 Tag Analyzer를 호출했을때 선택되는 Dashboard를 선택한다.없음.
Query TimeoutQuery 호출시 설정한 시간동안 응답이 없으면 Timeout 오류를 발생시킨다.20
Manage Dashboard

저장된 Dashboard를 관리한다.

버튼설명비고

Dashboard를 새 탭(창)에서 조회한다.

Dashboard의 Title을 수정한다.

Dashboard를 삭제한다.
Request Rollup

ROLLUP 강제 업데이트 명령인 "EXEC ROLLUP_FORCE" 명령을 실행시킨다. 약 6초간의 시간이 소요된다.

Logout

MWA에서 logout 한다.

Dashboard

Chart 생성

Dashboard의 각 열은 하나의 Chart로 구성되며 제일 하단의 패널에 표시된 + 버튼을 눌러서 Chart를 생성할 수 있다.

사용할 Tag들과 집계방법을 선택하고 Chart 유형을 선택하면 Chart가 생성된다. 선택된 Tag 목록에 있는 Tag를 Click하면 선택이 취소된다.

설정

Dashboard에 관련된 버튼은 우측 상단에서 찾을 수 있다.

버튼설명비고
Save Dashboard

현재의 Dashboard를 저장한다.

Board ID는 조회시 URL에 사용된다.
Board ID를 변경하면, "Save as Copy"가 체크된 경우에는 새로운 Dashboard가 생성되며 그렇지 않으면 Board ID가 변경된다.

Board ID에는 영문, 숫자 및 underscore(_)만 사용 가능

Time Range

조회할 시간범위와 Refresh 주기를 설정한다.

  • 시간범위 : 시간 선택(입력) 또는 now를 이용한 상대 시간 지정이 가능하다.
    (예: now, now-5d, now-3M)
    • 단위 : now를 기준으로 y(year), M(month), w(week : Mon - Sun), d(day), h(hour), m(minute), s(second) 사용 가능하다.
    • 옵션 : "/"를 사용하여 특정기간을 쉽게 지정할 수 있다.
      예 : 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 주기 : h(hour), m(minute), s(second) 단위로 입력이 가능하며 입력된 주기로 Dashboard가 다시 그려진다.

Chart 설정에서 별도로 시간범위나 Refresh 주기를 설정하면 Dashboard의 설정과 무관하게 자체 설정 값을 기준으로 동작한다.

YYYY-MM-DD HH24:MI:SS


Refresh all모든 Chart를 Refresh 한다.
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들이다.

    버튼설명비고
    Time Range시간 및 기간을 사용하여 Time Range를 설정한다.From & 6M
    UndoZoom 조작을 취소한다. 마우스 우측 버튼도 같은 기능을 수행한다.현재는 직전의 Zoom만 가능
    ResetTime Range를 전체 데이터의 minimum ~ maximum 으로 설정한다.
    Center현재의 window가 viewport의 중앙에 위치하도록 Time Range를 조정한다.
    Resize현재의 window가 20%의 크기로 중앙에 위치하도록 Time Range를 조정한다.
    - , +window를 좌측(우측)으로 Zoom out / Zoom in 한다.Zoom out / Zoom in
    << , < , > , >>window를 좌우로 100%(50%) 이동한다.

Chart buttons

Chart의 우측 상단에 표시되는 버튼으로 아래와 같다.

버튼설명비고

Preview ()

해당 Chart만  새로운 탭(창)에서 조회한다.

Edit options ()

Chart의 property를 수정한다. Chart의 모양을 변경하거나 Tag를 추가/수정할 수 있다.

수정후 를 눌러야 적용

Refresh ()

Chart를 다시 그린다.

Delete ()

Chart를 Dashboard에서 제거한다.

Chart properties

Property는 하단의 패널에서 수정하고 를 눌러서 수정된 것을 확인한 다음 상단의 를 누르면 적용이 된다. 각 탭별 Property는 아래와 같다.

  • General

    Property설명기본값비고
    Chart TitleChart의 제목Chart Title
    WidthChart의 너비(0 : 전체 크기)0현재는 0외에는 의미없음
    HeightChart의 높이(0: 전체 크기)300현재 0은 300으로 계산
    Action On ClickChart의 node를 클릭했을 때의 동작
    - No Action
    - Show Raw data chart
    - Show Raw data table    		No ActionShow Raw data chart는 클릭한 node의 시간 범위에 해당하는 Chart를 의미한다.
    ZoomChart를 Drag 했을때 Zoom을 하는지 여부Y
    Drill downZoom을 할때 Drill down을 하는지 여부Y
    Start with ZoomChart를 그릴 때 Zoom모드에서 시작한다.YZoom 상태에서는 Auto Refresh가 동작하지 않으므로, Auto Refresh를 사용하려면 이 기능은 꺼두어야 한다.
    NormalizeChart에 Normalize 사용 여부N
    Raw data time rangeRaw Data Chart의 기준 시간 범위5000값은 millisecond(ms) 단위로 작성해야 한다.

  • Data
    사용할 Tag와 집계방법 등을 변경한다.

    Property설명기본값비고
    Calc. modeTag Data 집계 방법Average
    Tag Names사용할 Tag의 이름
    		여러 개의 Tag를 ","로 연결해서 입력하면 하나의 Series로 그려진다.
    시간대에 해당하는 Tag가 여러 개라면 Alphabet 순으로 빠른 Tag의 값이 선택된다.
    AliasChart에서 Tag Name 대신 사용하는 Alias
    		빈칸이면 기존의 Tag Name을 사용한다.
    WeightNormalize를 사용 시 Tag 별 가중치10~1사이의 값을 입력해야 한다.

  • Axes

    Property설명기본값비고
    IntervalX축의 시간 간격을 설정한다. 지정하지 않으면 시간범위 및 화면의 크기에 따라서 자동으로 계산한다.
    		h, m, s 지원
    Show tick line (X-axis)X축의 눈금에 대응하는 Grid를 보여준다.(세로선)Y
    Pixels between tick marksX축 눈금 간의 pixel을 설정한다.3
    Start at zero (Y-axis)Y축 눈금이 0부터 시작한다.N
    Show tick line (Y-axis)Y축의 눈금에 대응하는 Grid를 보여준다.(가로선)Y
    Custom scaleY축의 눈금의 범위를 설정한다. 지정하지 않으면 최소값과 최대값을 사용하여 자동으로 지정된다.

    Custom scale for drill down chartDrill down Chart의 Y축의 눈금의 범위를 설정한다. 지정하지 않으면 최소값과 최대값을 사용하여 자동으로 지정된다.

    Set additional Y-axis.Y축을 하나 추가해서 사용한다.N
    Position of Y-axis추가된 Y축이 그려지는 위치를 설정한다.Right
    Select tags for Y-axis 2

    추가된 Y축을 사용할 Data를 선택한다. 'Data' 탭에 등록된 항목에서 선택한다.



  • Display

    Property설명기본값비고
    Show data pointsChart의 node에 point를 표시한다.N
    Point radius위의 경우 표시되는 point의 반지름(pixel)3
    Legend범례(Legend)를 표시한다.Y
    Opacity of fill area그래프의 fill 영역의 투명도를 설정한다.0.150:투명, 1:불투명
    Line thicknessline chart의 선두께를 설정한다.1.50:line없음
    Border colorChart의 테두리 색상을 설정한다. 입력하지 않으면 Background Color로 설정된다.
    		변경시에는 #을 붙여서 입력 공백으로 돌릴때는 "none"을 입력
  • Time Range
    이 Chart에만 적용되는 Time Range와 Refresh 주기를 입력한다. 이 값들이 설정되면 Dashboard의 설정과는 무관하게 이 값으로만 Chart가 동작한다.