Introduction to Drata Visualizations - maneeshpal/Drata GitHub Wiki

About drata visualizations

Most of he conventional visualization tools are built along the lines of visualizing something by default based on the data you are tracking, and then lets users apply rules and switch visualizations. There is nothing wrong with that approach, but it leaves less room for building visualization with intelligent data segmentation and aggregations.

Drata takes a different approach though. You may notice that Drata needs you to specify the kind of visualization upfront, rather than giving you the ability to switch post widget creation.

This is because, Drata expects different format for linechart, areachart and Trend chart as opposed to Pie and bar charts. This hard set fundamental distinction lets Drata segment the data more efficiently geared towards providing useful visualizations, and not dumb and beautiful charts.

For example, in line chart, when you group data by a property, Drata will visualize each group as its own line, whereas in Pie/Bar charts, Drata will perform aggregations based on your selections and groupings; resulting in a visualization that best suit the user's requirements.

Don't get me wrong, but Linechart and Area charts does have the ability to aggregate data. Its done using the property you select as your x-axis. When you group a date property on x-axis by a specific interval, it will result in timeseries chart.

Note: The explanation below applies to Area, Bar and Pie Charts as well.

Example Linechart widget

Figure 1
The changes you make to any of the widget view options detailed in the above figure will persist those changes immediately. So, you don't need to edit the widget in order to save these changes.
1. Dimensions: You may set the dimensions of a widget by selecting a combination of width and height dropdowns. *Remember:* These widgets are layed out as list items on the dashboard, and so they FLOAT LEFT. For that reason, the dashboard will look wonky when you try to set a widget's height on the right side of dashboard to height greater than its left sibling. 2. If your chart has multiple groupings, it results in multiple line charts, which can be toggled using this dropdown. Read the section above for more info. 3. Tabular view: A button to toggle between chart and tabular view. 4. Auto Refresh: You may set the chart to refresh its contents at an interval. A textbox will appear if you click on the "refresh" icon on the right which lets you specify time in seconds. 5. Labels: You can toggle these labels to show/hide their respective visual representation on widget.

Tabular data view

Figure 2
  1. Depending on how you built your query using widget editor, the resulting data could resolve to multiple groups. This label is an index to those groups.
  2. In the above figure, we are dealing with line chart. So this column resolves to x-axis in the chart.
  3. This is value being visualized on y-axis.

Checkout how to

⚠️ **GitHub.com Fallback** ⚠️