Tag Analyzer는 Tag Table의 ROLLUP 기능을 활용하여 데이터들을 Chart로 조회/분석할 수 있는 기능을 제공한다.
MWA에서 호출이 되므로 MWA가 사용가능해야 하며, 사용되는 Table은 TAG Table로 지정되어 있다.
$MACHBASE_HOME/webadmin/flask/MWA.conf 파일에 정의된 설정 중에서 Tag Analyzer에서 사용되는 항목은 아래와 같다.
| 항목 | 설명 | 기본값 |
|---|---|---|
| USE_TAG_ANALYZER_AUTO_DRILLDOWN | Rollup 데이터가 발견되지 않으면 아래 단계의 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를 생성한다.
Tag Analyzer의 환경을 설정한다.
| 항목 | 설명 | 기본값 |
|---|---|---|
| UI Thema | Dashboard의 배경색을 설정한다. (machIoTchartBlack / machIoTchartWhite) | machIoTchartBlack |
| Home Dashboard | Dashboard 지정없이 Tag Analyzer를 호출했을때 선택되는 Dashboard를 선택한다. | 없음. |
| Query Timeout | Query 호출시 설정한 시간동안 응답이 없으면 Timeout 오류를 발생시킨다. | 20 |
저장된 Dashboard를 관리한다.
| 버튼 | 설명 | 비고 |
|---|---|---|
| Dashboard를 새 탭(창)에서 조회한다. | |
| Dashboard의 Title을 수정한다. | |
| Dashboard를 삭제한다. |
ROLLUP 강제 업데이트 명령인 "EXEC ROLLUP_FORCE" 명령을 실행시킨다. 약 6초간의 시간이 소요된다.
MWA에서 logout 한다.
Dashboard의 각 열은 하나의 Chart로 구성되며 제일 하단의 패널에 표시된 + 버튼을 눌러서 Chart를 생성할 수 있다.
사용할 Tag들과 집계방법을 선택하고 Chart 유형을 선택하면 Chart가 생성된다. 선택된 Tag 목록에 있는 Tag를 Click하면 선택이 취소된다.
Dashboard에 관련된 버튼은 우측 상단에서 찾을 수 있다.
| 버튼 | 설명 | 비고 |
|---|---|---|
| Save Dashboard | 현재의 Dashboard를 저장한다. Board ID는 조회시 URL에 사용된다. | Board ID에는 영문, 숫자 및 underscore(_)만 사용 가능 |
Time Range | 조회할 시간범위와 Refresh 주기를 설정한다.
Chart 설정에서 별도로 시간범위나 Refresh 주기를 설정하면 Dashboard의 설정과 무관하게 자체 설정 값을 기준으로 동작한다. | YYYY-MM-DD HH24:MI:SS |
| Refresh all | 모든 Chart를 Refresh 한다. | |
| Share Dashboard | 현재의 Dashboard를 새로운 탭(창)에서 조회한다.(조회용 URL로 open) | Save된 경우에만 가능 |
선택된 Tag들과 집계방법으로 Chart가 그려진다. 마우스를 Chart에서 움직이면 시간 및 Series별 값을 확인 할 수 있다.
아래 부분에 표시된 범례(legend)를 클릭하면 선택한 Tag의 그래프만 볼 수 있으며 같은 Tag를 다시 클릭하면 다시 모든 Series를 볼 수 있다.
또한 범례 중 Chart 색 부분을 클릭하면 선택한 Tag의 Alias를 설정할 수 있다.
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 buttons : viewport를 이동하거나 조작하는데 사용되는 button들이다.
| 버튼 | 설명 | 비고 |
|---|---|---|
| Time Range | 시간 및 기간을 사용하여 Time Range를 설정한다. | From & 6M |
| Undo | Zoom 조작을 취소한다. 마우스 우측 버튼도 같은 기능을 수행한다. | 현재는 직전의 Zoom만 가능 |
| Reset | Time 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의 우측 상단에 표시되는 버튼으로 아래와 같다.
| 버튼 | 설명 | 비고 |
|---|---|---|
Preview ( | 해당 Chart만 새로운 탭(창)에서 조회한다. | |
Edit options ( | Chart의 property를 수정한다. Chart의 모양을 변경하거나 Tag를 추가/수정할 수 있다. | 수정후 |
Refresh ( | Chart를 다시 그린다. | |
Delete ( | Chart를 Dashboard에서 제거한다. |
Property는 하단의 패널에서 수정하고 
를 눌러서 수정된 것을 확인한 다음 상단의 
를 누르면 적용이 된다. 각 탭별 Property는 아래와 같다.
General
| Property | 설명 | 기본값 | 비고 |
|---|---|---|---|
| Chart Title | Chart의 제목 | Chart Title | |
| Width | Chart의 너비(0 : 전체 크기) | 0 | 현재는 0외에는 의미없음 |
| Height | Chart의 높이(0: 전체 크기) | 300 | 현재 0은 300으로 계산 |
| Action On Click | Chart의 node를 클릭했을 때의 동작 - No Action - Show Raw data chart - Show Raw data table | No Action | Show Raw data chart는 클릭한 node의 시간 범위에 해당하는 Chart를 의미한다. |
| Zoom | Chart를 Drag 했을때 Zoom을 하는지 여부 | Y | |
| Drill down | Zoom을 할때 Drill down을 하는지 여부 | Y | |
| Start with Zoom | Chart를 그릴 때 Zoom모드에서 시작한다. | Y | Zoom 상태에서는 Auto Refresh가 동작하지 않으므로, Auto Refresh를 사용하려면 이 기능은 꺼두어야 한다. |
| Normalize | Chart에 Normalize 사용 여부 | N | |
| Raw data time range | Raw Data Chart의 기준 시간 범위 | 5000 | 값은 millisecond(ms) 단위로 작성해야 한다. |
Data
사용할 Tag와 집계방법 등을 변경한다.
| Property | 설명 | 기본값 | 비고 |
|---|---|---|---|
| Calc. mode | Tag Data 집계 방법 | Average | |
| Tag Names | 사용할 Tag의 이름 | 여러 개의 Tag를 ","로 연결해서 입력하면 하나의 Series로 그려진다. 시간대에 해당하는 Tag가 여러 개라면 Alphabet 순으로 빠른 Tag의 값이 선택된다. | |
| Alias | Chart에서 Tag Name 대신 사용하는 Alias | 빈칸이면 기존의 Tag Name을 사용한다. | |
| Weight | Normalize를 사용 시 Tag 별 가중치 | 1 | 0~1사이의 값을 입력해야 한다. |
Axes
| Property | 설명 | 기본값 | 비고 |
|---|---|---|---|
| Interval | X축의 시간 간격을 설정한다. 지정하지 않으면 시간범위 및 화면의 크기에 따라서 자동으로 계산한다. | h, m, s 지원 | |
| Show tick line (X-axis) | X축의 눈금에 대응하는 Grid를 보여준다.(세로선) | Y | |
| Pixels between tick marks | X축 눈금 간의 pixel을 설정한다. | 3 | |
| Start at zero (Y-axis) | Y축 눈금이 0부터 시작한다. | N | |
| Show tick line (Y-axis) | Y축의 눈금에 대응하는 Grid를 보여준다.(가로선) | Y | |
| Custom scale | Y축의 눈금의 범위를 설정한다. 지정하지 않으면 최소값과 최대값을 사용하여 자동으로 지정된다. | ||
| Custom scale for drill down chart | Drill 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 points | Chart의 node에 point를 표시한다. | N | |
| Point radius | 위의 경우 표시되는 point의 반지름(pixel) | 3 | |
| Legend | 범례(Legend)를 표시한다. | Y | |
| Opacity of fill area | 그래프의 fill 영역의 투명도를 설정한다. | 0.15 | 0:투명, 1:불투명 |
| Line thickness | line chart의 선두께를 설정한다. | 1.5 | 0:line없음 |
| Border color | Chart의 테두리 색상을 설정한다. 입력하지 않으면 Background Color로 설정된다. | 변경시에는 #을 붙여서 입력 공백으로 돌릴때는 "none"을 입력 |
)
)
를 눌러야 적용
)
)