Versions Compared

Version Old Version 12 New Version Current
Changes made by

Edward Lee (Unlicensed)

Edward Lee (Unlicensed)

Saved on

Key

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

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

...

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

항목설명기본값
USE_TAG_ANALYZER_AUTO_DRILLDOWNRollup 데이터가 발견되지
않는 경우
않으면 아래 단계의
Rollup Table에서
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로 구성된다.

...

Preference

Tag Analyzer의 환경을 설정한다.

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

저장된 Dashboard를 관리한다.

버튼설명비고
Image Removed

Image Added

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

Image Added

Dashboard의 Title을 수정한다.
Image Removed

Image Added

Dashboard를 삭제한다.
Request Rollup

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

...

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), d(day), h(hour), m(minute), s(second)가
가능합니다
  • 가능하다.
  • Refresh 주기 : h(hour), m(minute), s(second) 단위로 입력이 가능하며 입력된 주기로 Dashboard가 다시
그려집니다
  • 그려진다.

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

동작합니다

동작한다.

시간 양식 :

YYYY-MM-DD HH24:MI:SS


Refresh all모든 Chart를 Refresh
합니다
한다.
Share Dashboard

현재의 Dashboard를 새로운 탭(창)에서

조회합니다.현재의 Dashboard를 새로운 창에서 조회용 URL로 open하는 것입니다.

조회한다.(조회용 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를 사용하여 이동할 수 없다.

...

  • viewport buttons : viewport를 이동하거나 조작하는데 사용되는 button들이다.

    버튼설명비고
    Time Range시간 및 기간을 사용하여 Time Range를 설정한다.From & 6M
    UndoZoom 조작을 취소한다. 마우스 우측 버튼도 같은 기능을 수행한다.현재는
    바로 전의 Zoom만 Undo가 가능하다.
    직전의 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 (Image Added)

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

Edit options (Image Added)

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

Property를 수정하고 (tick) 버튼을 눌러야 적용이 됩니다.

Refresh

수정후 Image Added를 눌러야 적용

Refresh (Image Added)

Chart를 다시 그린다.

Delete (Image Added)

Chart를 Dashboard에서 제거한다.

Chart properties

Property는 하단의 패널에서 수정하고 (tick)Image Added를 눌러서 수정된 것을 확인한 다음 상단의 (tick)Image Added를 누르면 적용이 됩니다된다. 각 탭별 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와

    집계방법을 변경합니다.
    Tag Names에

    집계방법 등을 변경한다.

    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
    The scale of the y-axis start at zero.

    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를 표시합니다.)
    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가 동작한다.

...