Dashplot Visualizations

Visualizations convert query results into charts and graphical representations.

The Visualizations tab displays all saved visualizations.

To access Dashplots Studio:

  1. In the xObserve UI, click the User icon in the upper-right corner.
  2. Select Dashplots Studio.

The Dashplots Studio workspace opens and provides the following tabs:

  • Dashboards – Create and manage dashboards.

  • Visualizations – Create and manage reusable visualizations.

  • + - Create a new visualization.

For details about creating a visualization, see Creating a Visualization.

Visualization Library

The Visualization Library provides a centralized repository for managing reusable visualizations.

  • Name – Unique name of the visualization.
  • Display Name – Title displayed on dashboards.
  • Visualization Type – Type of chart or visualization (e.g., Bar, Line, Pie).
  • Description – Brief description of the visualization.
  • Updated At – Timestamp of the most recent update.

Visualizations can be reused across multiple dashboards.

Changes to a visualization automatically apply wherever that visualization is used.

Creating a Visualization

To create a visualization:

  1. In the xObserve UI, go to the user icon in the top-right corner.
  2. Select Dashplots Studio. The dashboard page appears on the screen.
  3. Go to the Visualization tab and click Create Visualization or click the + icon.
  4. A new visualization scratchpad opens, asking for the visual name, title, and description.
  5. Click Save.
  6. Follow the steps below, such as selecting a data source, schema, metric, etc.

Select a Data Source

Choose a data source from the Datasource panel.

  • VictoriaMetrics: For time-series metrics
  • PostgreSQL: For configuration-related metrics.

Select a Schema

Choose the schema associated with the selected data source.

Select a Metric

From the Tables pane:

  1. Browse available metrics.
  2. Select a metric.

The metric is automatically added to the query editor.

Example:

spark.BlockManager_disk.diskSpaceUsed_MB

Execute Query

Click Execute Query.

The query result appears in the Sample Data section.

The sample data can be viewed as:

  • Table
  • JSON

Variables

  • Variables allow dynamic query generation and reusable visualizations.
  • Variables can be referenced within queries and modified without changing the query definition.

Variable Types

  • Global Variables:

    • Provided by the system.

    • Examples include:

      • from_date_epoch
      • to_date_epoch
    • Global variables cannot be modified.

  • Dashboard Variables

    • Dashboard variables are automatically promoted when the same variable is used across multiple visualizations.
    • Changes affect all linked visualizations.
  • Local Variables

    • Local variables affect only a single visualization.

Adding Variables

To add variables:

  1. Place the cursor in the query editor.
  2. Click Global Variable.
  3. Select a variable.

Example:

${from_date_epoch}

  1. Execute the query.

The selected value is substituted during execution.

Visualization Configuration

The Visualization panel is used to customize chart behavior and appearance.

Supported Visualization Types:

  • Line, Bar, Pie, Doughnut, Scatter, Heatmap, Table, Treemap, and other chart types.
Visualization TypeSelect the chart type (Line, Bar, Pie, Scatter, Heatmap, Table, Treemap, etc.).
X-AxisConfigure the X-axis field, label, and formatter.
Y-AxisConfigure the Y-axis field, scale, label, and formatter.
ScaleChoose the axis scale: Linear or Logarithmic.
Group ByGroup data using dimensions such as Host, Cluster, Application, or Namespace.
FiltersApply filters to limit the data displayed in the visualization.
Color PickerSelect chart colors from predefined palettes.
Show LabelsEnable or disable data value labels on the chart.
Gradient OptionApply gradient styling to supported chart types.
RedirectionConfigure navigation to another dashboard or external URL when a chart element is clicked.
DrilldownConfigure interactive drilldowns using a target URL and query parameters.
Query ParametersPass values such as X-Axis Value, Y-Axis Value, and Series Value during drilldown.
Compare OptionEnable comparison mode. Comparison mode displays data from multiple time periods simultaneously.
Annotation

Annotations provide additional operational context.

Supported annotations include:

  • Incident Overlay: Displays incident markers on charts.
  • Log Overlay: Displays associated log events.

Sample Data

The executed query details appear in the table.

You can see the data in the table or JSON format.

Saving a Visualization

After configuring the chart:

  1. Click Save.

  2. Provide:

    1. Name: Visualization identifier
    2. Title: Display title
    3. Description: Visualization description
  3. Click Save.

The visualization is added to the Visualization Library.

VariableType to search · ESC to discard
GlossaryType to search · ESC to discard
InsertType to search · ESC to discard
No matches