Skip to main content
Version: 4.0.4

Set Up System Cube

What is System Cube​

For better supporting self-monitoring, a set of system Cubes are created under the system project, called "KYLIN_SYSTEM". Currently, there are five Cubes. Three are for query metrics, "METRICS_QUERY_EXECUTION", "METRICS_QUERY_SPARK_JOB", "METRICS_QUERY_SPARK_STAGE". And the other two are for job metrics, "METRICS_JOB", "METRICS_JOB_EXCEPTION".

How to Set Up System Cube​

Please check document: How to use System Cube in Kylin4.0

Details of System Cube​

Common Dimension​

For all of these Cube, admins can query at four time granularities. From higher level to lower, it's as follows:

KYEAR_BEGIN_DATEyear
KMONTH_BEGIN_DATEmonth
KWEEK_BEGIN_DATEweek
KDAY_DATEdate

METRICS_QUERY​

This Cube is for collecting query metrics at the Spark Execution level.

METRICS_QUERY_SPARK_JOB​

This Cube is for collecting Spark Job level query metrics.

METRICS_QUERY_SPARK_STAGE​

This Cube is for collecting Spark Stage level query metrics.

METRICS_JOB​

In Kylin, there are mainly three types of job:

  • "BUILD", for building Cube segments from HIVE.
  • "MERGE", for merging Cube segments in storage engine.
  • "OPTIMIZE", for dynamically adjusting the precalculated cuboid tree base on the base cuboid in storage engine.

This Cube is for collecting job metrics. The details are as follows:

Dimension
PROJECT
CUBE_NAME
JOB_TYPE
CUBING_TYPEin kylin, there are two cubing algorithms, Layered & Fast(InMemory)
Measure
COUNT
MIN, MAX, SUM of DURATIONthe duration from a job start to finish
MIN, MAX, SUM of TABLE_SIZEthe size of data source in bytes
MIN, MAX, SUM of CUBE_SIZEthe size of created Cube segment in bytes
MIN, MAX, SUM of PER_BYTES_TIME_COST= DURATION / TABLE_SIZE
MIN, MAX, SUM of WAIT_RESOURCE_TIMEa job may includes several MR(map reduce) jobs. Those MR jobs may wait because of lack of Hadoop resources.

METRICS_JOB_EXCEPTION​

This Cube is for collecting job exception metrics. The details are as follows:

Dimension
PROJECT
CUBE_NAME
JOB_TYPE
CUBING_TYPE
EXCEPTIONwhen running a job, exceptions may happen. It's for classifying different exception types
Measure
COUNT