Sankey Diagram Widget
Sankey widget can render results as a
two-level Sankey diagram. It is good at displaying flows between
entities, such as network flows from one IP to another.
See in Figure 118, “Sankey Widget” an example of how this widget may look like.
Figure 118. Sankey Widget
Find in table below the main fields that are typically used in the
||string||The ID of the source node (left side). This value will also be used as the label of the node.|
||string||The ID of the target node (right side). This value will also be used as the label of the node.|
The value that is used to determine the size of the edge
The Sankey widget is most easily used with its companion query
sankey(), but can easily be used simply
by ensuring the input fields are named as expected.
Example 1: Network Traffic
Here we are using the companion query function to visualize data
We use the
sum() function to calculate the
total number of bytes sent — where
pkt_size` is a field containing the packet size.
sankey(source=src_ip, target=dst_ip, weight=sum(pkt_size))
Example 2: Thread Usage
In some situations it might be easier to produce the input data manually instead of using the companion function.
rename(class, as=source) | rename(thread, as=target) | groupBy([source, target], function=count(as=weight))
In this case we want to visualize which classes use which threads in
a service. We need to rename the
thread fields to match the expected input; we do
this using the
groupBy() function, and to
weight fields, we make sure that the
function we use in the
groupBy() names its
Use the widget'spanel to configure the following properties.
The title of the widget as displayed in the dashboard.
The description of the time chart. This is free form text supporting markdown syntax.
This same description appears in the dashboard as a tooltip by hovering over the question mark on top of the widget.
Shows values in the vertical axis.
Controls the order of the series in each stack.
Type arranges series by:
Label— sort by the series’ label name.
Size— sort by the series’ size.
Arranges series by ascending or descending order (alphabetical if sorted by label, numerical if sorted by size).
Valid options are:
Choose where you want the labels to appear in the chart. Valid options are:
Inside— positions the labels within the chart area.
Outside— positions the labels external to the chart area.
Sets the length of the label — smaller values will show labels as truncated.
Allows to change the color and the displayed name of each series in the diagram.