Performance Tracing Tool

IoTDB supports the use of the TRACING clause to enable performance tracing of executed query statements. Users can use the performance tracing tool to analyze potential performance problems in some statements.

The current performance analysis includes the following contents:

  1. The elapsed time of each stage of the execution process.
  2. Statistics related to performance analysis, it includes the number of time series queried, the number of Tsfile files accessed, the total number of chunks to be scanned, and the average number of data points contained in the chunk, the total number of pages read, and the number of overlapped pages.

For example, execute tracing select * from root, will display the following contents:

  1. Tracing Activties:
  2. +------------------------------------------------------+------------+
  3. |                                              Activity|Elapsed Time|
  4. +------------------------------------------------------+------------+
  5. |Start to execute statement: tracing select * from root|           0|
  6. |                            Parse SQL to physical plan|           4|
  7. |                              Create and cache dataset|          16|
  8. |                              * Num of series paths: 3|            |
  9. |                       * Num of sequence files read: 2|            |
  10. |                     * Num of unsequence files read: 1|            |
  11. |        * Num of sequence chunks: 6, avg points: 100.0|            |
  12. |      * Num of unsequence chunks: 3, avg points: 100.0|            |
  13. |         * Num of Pages: 9, overlapped pages: 0 (0.0%)|            |
  14. |                                      Request complete|          20|
  15. +------------------------------------------------------+------------+