FuseQL is a new query language to perform analytics on log events. It is meant to be a drop-in replacement for Grafana’s logQL LogQL support in Kloudfuse. In addition, it also supports more advanced operators such as anomaly detection, outlier detection, forecasting and several arithmetic and trigonometric operators.
All the various operators supported in FuseQL are documented in the following pages:
...
...
...
...
Info |
---|
Users can switch between FuseQL and |
...
LogQL with a toggle button on the log analytics page. |
For some of the common use cases on how to use log analytics with FuseQL, refer to the cheatsheet page.
Query Builder
...
Log Filters
To filter out logs that you want to run your analytics query on, click (Search logs). If no filters are specified, FuseQL will consider all log lines.
...
For more information on various supported aggregation operators, refer to Aggregation Operators.
...
Groups
FuseQL also supports grouping of log lines by label and facets. Click on the by dropdown to add group by fields to your aggregation operators. By default, FuseQL groups by everythingtime buckets, and by collapsing all the columnsother labels.
...
Limit To
By default, FuseQL limits the resulting time series values to the top 10. This can be changed by editing the dropdown.
...
Below is an example of using a 1m roll up in a time range of 5m resulting in 5 buckets.
...
Functions
FuseQL supports various functions - you can choose any of the available functions by clicking on ∑
button. The list of functions supported can be broadly classified into the following three categories:
Add Query
To add a another query, click (Add Query). Notice that a new query (B) appears under query (A), and it is a duplicate.
...
Add Formula
FuseQL also supports formulas by applying various mathematical operators on a set of queries. Currently following mathematical operators are supported:
Addition (
+
)Subtraction/Difference (
-
)Multiplication/Product (
*
)Division (
/
)Modulo (
%
)Pow (
^
)
Each query can have its own set of filters and aggregation operators.
The screenshot below shows an example of counting all log lines with levels info
, warn
and error
.
...
Note |
---|
Formulas are currently not supported with any advanced functions or math operators. You can only use log filters and aggregation operators with formulas. |
Visualizations
FuseQL supports four different visualization types. The default visualization is Time Series.
...
Use Time Series Visualization when you want to analyze trends, patterns, and behaviors over in buckets spanning the selected time range.
...
Top List
...
Table
...
Pie Chart
...
Algorithms
Overlay a band on the metric, showing the expected behavior of a series based on past values.
Highlight outliers series.
Forecast future values based on past values.Use Top List when you want to quickly identify and compare the highest-ranking groups within the selected time range.
...
Table
Use Table when you need a detailed, row-by-row summary of your data for deeper comparison and analysis within the selected time range.
...
Pie Chart
Use Pie Chart when you want to visualize the relative proportions of different groups within your data in the selected time range.
...