Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ML1 and version 5.3
Sv translation
languageen

There are five (5) main sections of the Xpand GUI. Each of these can be directly accessed via the icons at the top of each page:

Image Modified

  1. Health Dashboard - View all important Cluster attributes at a glance
  2. Queries - View Current and Recent Queries
  3. Graphs - View all available Cluster attributes over time
  4. Compare - Compare Cluster attributes at different points in time
  5. Flex - Add or Remove nodes from the Cluster

Image Modified

Anchor
Accessing ClustrixGUI
Accessing ClustrixGUI
Accessing XpandGUI 

Access the XpandGUI by typing the ip or hostname of one of your nodes into a web browser. For non-root installations, include port 8080. Chrome is recommended. 

Image Modified

When logging in for the first time, provide the following temporary credentials:

  • Email: [email protected] 
  • Password: mariadb
  • Target: hostname or IP address of any node in your cluster

Xpand strongly recommends that you create a new user and delete the [email protected] user. To create a new user, access the "Manage Users" in the upper right corner of any page by clicking on Image Modified. For more information see Managing XpandGUI Users

Anchor
Health Dashboard
Health Dashboard
Health Dashboard

The 'Health Dashboard' is designed to give a quick high-level overview of database cluster health and activity. There are 24-hour sparkline graphs of six main cluster attributes: Transactions per second, CPU utilization, Rebalancer status, In-memory table utilization, Storage, and Read and Write latencies. These graphs are shown in green, yellow, or red depending on how they compare to threshold levels. Visual Alerts are displayed for attributes which are outside normal ranges. All data is polled and updated every 5 seconds. 

Health Dashboard Tabs

TPS

The TPS section displays the number of database transactions per second across all nodes, including sections for:

  • Current transaction execution times, broken down by execution time
  • Current transactions per second by node
  • Transactions per second in the last 24 hours (5 minute intervals)

You can select whether to display transactions or queries per second. 

Image Modified

CPU

The CPU section: displays Average CPU utilization across all the database nodes in the cluster including:

    • CPU usage breakdown
    • Current CPU usage by node, which can be used to identify imbalances 
    • CPU usage over the last 24 hours

Image Modified

Rebalancer

The rebalancer section displays the number and type of current rebalancer actions, as well as a history of recent actions, and actions over the previous 24 hours. If the cluster is underprotected, the Rebalancer health will reflect that.

Image Modified

Memory Utilization

The memory section provides information on how memory is used, including for In-Memory tables.

  • The current memory allocations for In-Memory Tables, Buffer Manager, Working Memory, Reserve, OS + Other Apps, and Free
  • Current memory utilization per node
  • The graph at the bottom shows the percent utilization of memory by type over 24 hour period, in 5 minute intervals

Image Modified

Storage

The Storage section displays how storage is being consumed across the active nodes in the cluster, including the following: 

  • User: Amount of User space 
  • Undo: Amount of Undo log
  • Binlog: Amount of storage used by replication binlog(s)
  • System: Amount of storage used by system processes
  • Free: Amount of free space in the cluster

This section also includes a breakdown of "Storage by node" and displays the "Storage allocation in the last 24 hours." These are useful for identifying uneven or "lumpy" distributions in data or recent changes to storage. 

Image Modified

Latency

  • "Latency over the last 24 hours": Displays the query read and write latencies (two-color chart) over the last 24 hours in 5 minute intervals
  • "Read Latency" The current average read latency of the cluster
  • "Write Latency" The current average write latency of the cluster

Image Modified


Anchor
Queries
Queries
Queries

The Queries tab has two distinct views that show Current and Recent Queries.

Current Queries

The Current Queries view displays all currently executing queries and queries that have completed within the last second. By default, this view is auto-refreshed every 5 seconds but can also be paused. If you navigate away from the Current Queries view, auto-refresh will resume. 

The following metrics are displayed:

  • Status: Query status
  • Query Statements: Displays the query statement, up to two lines. Click 'Show More' to display the full Query
  • Age: How long the query has been executing
  • Database: The database the query is being run on
  • Session ID: The ID of the session the in which query was run
  • Transaction ID: The ID of the transaction in which the query was run
  • Source IP: The IP address of the machine on which the query was run
  • Username: The Xpand username of the user under which the query was run 

Image Modified

Current Queries can be filtered via the Query Filters in the left pane or by entering text into the 'Filter by text' field. 

Note

Queries shown in the 'Current' Queries view will be removed as they complete, and subsequently can be found on the 'Recent' page.

Recent

The 'Recent' Queries view displays all the queries which have been recently completed, along with the following metrics:

  • Exec Count: The number of times the query was executed
  • Avg Exec Time: The average amount of time each iteration of the query took to execute
  • Query Statements: Displays the query statement, up to two lines. Click 'Show More' to display the full Query.
  • Avg Rows Read: The average number of rows read by each iteration of the associated query
  • Avg Rows Written: The average number of rows written by each iteration of the associated query
  • Avg Rows Output: The average number of rows output by each iteration of the associated query
  • Database: The database on which the query executed

Image Modified

Recent Queries can be filtered via the Query Filters in the left pane or by entering text into the 'Filter by text' field. 

Anchor
Graphs
Graphs
Graphs

The 'Graphs' tab displays important database attributes over a user-specified interval. There are predefined collections of graphs for Diagnostic (Xpand Specifics), Health, Locks, Performance, Queries and Rows, Replication, Sessions and Transactions, and Storage. You can also define custom collections. 

The default interval is 24 hours, but can be range from 15 minutes to 7 days. Choose an interval width on the data selector, or the top ruler (using the left/right cursors) by dragging that selected interval across the date range. Refresh the screen to go back to the default time frame.

Image Modified

  • Moving the cursor back and forth over a graph creates a vertical 'needle' which displays the attributes (on the left) for each visible graph at that time-stamp. All the graphs are aligned by timestamp, to aid in point-in-time analysis.
  • Single-click to place a vertical 'needle' for comparison purposes with the (moving) needle under the mouse
  • There are 2 ways to zoom in on Graphs
    •   Zoom into the x-axis (time) of all of the visible graphs by clicking inside a graph and dragging horizontally across the graph, you will see a vertical column highlighting the area (time frame) you wish to zoom in on.
    • Zoom into the y-axis of a particular graph by clicking in a graph and dragging vertically on a graph. You will see a horizontal bar across the screen highlighting the area of the y-axis that will be zoomed in on.
    • Double-click the graph to reset the zoom level to normal, you may need to double click several times if you have done many zooms.  You may also go to a different tab and return to the Graphs tab.

Anchor
Compare
Compare
Compare

The Compare tab allows users to compare two sets of database attributes at two different points in time. The default attributes are CPU min/max/average, and query latency.  The other attributes are shown in the drop-down below.

Image Modified

The left-side list of values is displayed on the left-side Y-axis, and the right-side list of values is displayed on the right-side Y-axis. The horizontal axis (time) is displayed and adjusted via the Rulers at the top of the page

  • The queries occurring at the timestamp selected is displayed under the associated needle. Thus, the left-side 'Query Statements' occurred at the point-in-time where the left needle is currently placed
  • The following fields are displayed in the two Query Statement views:
    • Database: The database on which the query executed
    • Query Statements: Displays the query statement, up to two lines. Click 'Show More' to display the full Query
    • Rows Read: The amount of rows read by the associated query
  • Each of the Query Statement views can be filtered via partial-entry text in its associated 'Filter Queries' box
  • The attributes being compared are selected from a drop down on the right and left sides of the screen

Anchor
Flex
Flex
Flex

The Flex page displays all the nodes and node statuses of the current cluster. It also allows the cluster to be expanded and reduced in size. 

Image Modified

Note

XpandGUI includes an option to "Drop this node", which simply marks the node as softfailed. For additional instructions on modifying your cluster size, see Expanding Your Cluster's Capacity - Flex Up and Reducing Your Cluster's Capacity - Flex Down.

Sv translation
languageko

Clustrix GUI에는 5개의 주요 섹션이 있습니다. 각각의 섹션은 페이지 상단의 아이콘을 통해 직접 액세스할 수 있습니다.

Image Added

  1. Health 대시보드 - 모든 중요한 클러스터 속성을 한눈에 보여줍니다.
  2. Queries - Current 및 Recent 쿼리를 보여줍니다.
  3. Graphs - 시간 경과에 따라 보기 가능한 모든 클러스터 속성을 보여줍니다.
  4. Compare - 다른 시점의 클러스터 속성을 비교합니다.
  5. Flex - 클러스터에서 노드를 추가 또는 제거합니다.

Anchor
Accessing ClustrixGUI
Accessing ClustrixGUI
ClustrixGUI에 액세스

클러스터에서 노드 중 하나의 노드의 IP 또는 호스트 이름을 웹 브라우저에 입력하여 ClustrixGUI에 액세스하십시오. Chrome 브라우저를 사용하는 것이 좋습니다.

처음으로 로그인하는 경우 다음 임시 인증 정보를 사용하십시오.

  • Email: [email protected]
  • Password: clustrix
  • Target: 클러스터에 있는 노드의 호스트 이름 또는 IP 주소

새 사용자를 만들고 [email protected] 사용자를 삭제하는 것이 좋습니다. 페이지 오른쪽 상단의 Image Added을 클릭하여 "Manage Users"에 들어가서 새 사용자를 만들 수 있습니다.

Anchor
Health Dashboard
Health Dashboard
Health 대시보드

'Health 대시보드'는 데이터베이스 클러스터 상태 및 활동에 대한 상위 수준의 전체 개요를 간략히 제공합니다. 다섯 가지 주요 클러스터 속성을 24시간 스파크라인 그래프로 보여줍니다: 초당 트랜잭션, CPU 사용률, In-Memory 테이블 사용률, 스토리지, 읽기 및 쓰기 대기 시간. 이 그래프들은 임계값 수준과 비교하여 녹색, 노란색 또는 빨간색으로 표시됩니다. 임계값 대비 '너무 높은' 속성에 대해서는 경고가 표시됩니다.

모든 데이터는 5초마다 폴링되고 업데이트됩니다. 참고로 24시간의 데이터를 보여주는 '큰 그래프'는 5분 동안 누적된 데이터의 평균을 표시합니다.

5개의 주요 클러스터 속성 중 하나라도 경고 임계값을 초과하면 Health 아이콘이 빨간색 으로 깜박입니다.

Health 대시보드 탭

TPS

TPS 섹션에는 모든 노드에서의 초당 데이터베이스 트랜잭션 수가 표시됩니다. 또한, 다음 항목의 섹션을 포함합니다:

  • Current transaction execution times
  • Current transactions per second by node
  • Transactions per second in the last 24 hours ( 5 minute intervals)

Image Added

CPU

CPU 섹션은 아래의 사항을 포함하여 클러스터의 모든 데이터베이스 노드에서의 평균 CPU 사용률을 표시합니다.

    • CPU usage breakdown
    • Current CPU usage by node, which can be used to identify imbalances
    • CPU usage over the last 24 hours

Image Added

In Memory 테이블 사용률

메모리 섹션은 In-Memory Tables의 메모리 사용 현황을 나타냅니다. 사용된 메모리의 %는 백분율을 나타냅니다.

Image Added

Storage

Storage 섹션은 다음 항목을 포함하여 클러스터의 활성 노드에서 스토리지의 사용 현황을 표시합니다.

  • User: 유저 스페이스 사용량
  • Undo: Undo 로그 사용량
  • Replication: 복제 binlog가 사용하는 스토리지 사용량
  • System: 시스템 프로세스에서 사용하는 스토리지 사용량
  • Free: 클러스터의 여유 공간

이 섹션에는 "노드 별 스토리지" 내역이 포함되어 있으며 "지난 24시간 동안의 스토리지 할당"이 표시됩니다. 이는 데이터의 "불균형" 분산이나 최근의 스토리지 변경 사항을 식별하는 데 유용합니다.

Image Added

Latency

  • "Latency over the last 24 hours": 지난 24시간 동안 쿼리 읽기 및 쓰기 대기 시간(2색 차트)을 5분 간격으로 표시합니다.
  • "Current latency by node (Read/Write)": 클러스터의 각 노드에 대한 읽기 및 쓰기 대기 시간(위는 읽기 %, 아래는 쓰기 %). 대기 시간을 노드 당 퍼센트 대기 시간으로 표시합니다.

Image Added

Anchor
Queries
Queries
Queries

쿼리 탭에는 현재 쿼리(Current Queries)와 최근 쿼리(Recent Queries)를 보여주는 별개의 뷰가 있습니다.

Current Queries

Current Queries 뷰는 현재 실행 중인 모든 쿼리와 지난 1초 이내에 완료된 쿼리를 표시합니다. 기본적으로 이 뷰는 자동으로 5초마다 새로 고침이 실행되지만 일시 중지할 수도 있습니다. Current Queries 뷰에서 다른 곳으로 이동하면 자동 새로 고침이 재개됩니다.

현재 쿼리(Current Queries)는 왼쪽 창의 Query Filters를 사용하거나 'Filter by text' 필드에 텍스트를 입력하여 필터링할 수 있습니다.

Note

'Current' Queries 뷰에 표시된 쿼리는 완료되면 제거되며 'Recent' 페이지에서 나중에 다시 찾을 수 있습니다.

Recent

'Recent' Queries 뷰에는 최근에 완료된 모든 쿼리와 함께 아래의 메트릭이 표시됩니다.

  • Exec Count: 쿼리가 실행된 횟수
  • Exec Time: 쿼리의 각 반복 실행에 걸린 시간
  • Query Statements: 쿼리 문을 최대 두 줄까지 표시합니다. 'Show More'를 클릭하면 전체 쿼리가 표시됩니다.
  • Rows Read: 연관된 쿼리에서 읽은 행 수
  • Database: 쿼리가 실행된 데이터베이스

Image Added

최근 쿼리(Recent Queries)는 왼쪽 창에 있는 Query Filters를 사용하거나 'Filter by text' 필드에 텍스트를 입력하여 필터링할 수 있습니다.

Anchor
Graphs
Graphs
Graphs

'Graphs' 탭에는 사용자가 지정한 간격 동안 중요한 데이터베이스 속성이 표시됩니다. 기본 간격은 24시간이지만, 범위는 15분에서 7일까지 될 수 있습니다. 상단 눈금자에서 간격 폭을 선택(왼쪽 / 오른쪽 커서 사용)한 다음 선택한 간격을 날짜 범위만큼 드래그하십시오.

Performance, Diagnostic, Queries and Rows, Locks, Sessions and Transactions, Replication 및 Disk와 같은 여러 카테고리의 그래프가 있습니다. 원하는 카테고리를 클릭하여 그래프를 확장하십시오.

Image Added

  • 그래프 위에서 커서를 앞뒤로 움직이면 세로 '바늘'이 생성되어 해당 타임스탬프 때의 각 가시 그래프 속성을 표시합니다. 모든 그래프는 타임스탬프로 정렬되어 특정 시점 분석을 돕습니다.
  • 마우스를 한 번 클릭해서 수직 '바늘'을 비교하고자 하는 (움직이는) 바늘 옆에 놓습니다.
  • 그래프를 클릭 / 수직으로 드래그하여 그래프를 확대할 수 있습니다. 그래프를 두 번 클릭하여 줌 레벨을 보통으로 재설정합니다.
    • 세로로 드래그하거나 왼쪽으로 조금씩 드래그하여 세로로 확대하십시오.

Anchor
Compare
Compare
Compare

Compare 탭을 사용하면 서로 다른 두 시점에서 서로 다른 두 가지 데이터베이스 속성 집합을 비교할 수 있습니다. 기본 속성은 CPU min/max/average 및 query latency입니다.

Image Added

왼쪽 값 목록은 왼쪽 Y축에 표시되고, 오른쪽 값 목록은 오른쪽 Y축에 표시됩니다. 가로축(시간)은 페이지 상단의 눈금자를 통해 표시되고 조정됩니다.

  • 선택한 타임스탬프에서 발생하는 쿼리는 연관된 바늘 아래에 표시됩니다. 따라서, 왼쪽에 표시된 'Query Statements'는 현재 왼쪽 바늘이 놓여있는 시점에서 발생했습니다.
  • 다음 필드는 두 개의 Query Statement 뷰에 표시됩니다.
    • Database: 쿼리가 실행된 데이터베이스입니다.
    • Query Statements: 쿼리 문을 최대 두 줄까지 표시합니다. 전체 쿼리를 표시하려면 'Show More'를 클릭하십시오.
    • Rows Read: 관련 쿼리가 읽은 행 수
  • 각 Query Statement 뷰는 연관된 'Filter Queries' 상자의 부분 입력 텍스트를 통해 필터링할 수 있습니다.

Anchor
Flex
Flex
Flex

Flex 페이지는 현재 클러스터의 모든 노드 및 노드 상태를 표시하고 클러스터의 크기를 확장 및 축소할 수 있도록 합니다. Expanding Your Cluster's Capacity - Flex UpReducing Your Cluster's Capacity - Flex Down을 참조하십시오.

Note

ClustrixGUI에는 "Drop this node" 옵션이 포함되어 있고 이 옵션은 단순히 노드를 "softfailed"로 표시합니다. 클러스터에서 노드를 제거하는 방법에 대한 추가 지침은 위의 Reducing Your Cluster's Capacity 링크를 참조하십시오.