Monitor Workflows with Kestra Dashboards

The Dashboards page displays the default dashboard and any custom dashboards you’ve created. Switch between them using the hamburger menu — if you have more than 10, use the search bar. The same menu lets you edit or delete dashboards. From any dashboard you can apply and save filters, refresh data, and set an automatic periodic refresh.

Custom dashboards

Custom dashboards let you define queries and charts to visualize execution, log, and metric data. Edit each chart individually using the pencil icon in the dashboard view.

Build dashboards using the No Code editor (no YAML required) or by writing YAML directly. Both produce the same schema-validated output.

No Code editor

The No Code editor lets you design dashboards using structured forms. As you configure charts and data sources, YAML is generated in real time and the live preview stays in sync. Switch to YAML at any point for filters, dynamic queries, or advanced layout logic — both views reflect the same underlying definition.

Interactive demo

For a step-by-step walkthrough of building your first KPI chart using the No Code editor, see Build a KPI success ratio chart.

Chart types

Dashboards support six chart types: Bar, Pie, TimeSeries, Table, KPI, and Markdown. Each data chart type is composed of chartOptions and data.

A chart’s chartOptions property controls display names, descriptions, legends, and tooltips. The data property specifies the data source, which columns to display (including aggregations and sort order), and any filters to apply.

Each chart’s options are listed in the Chart Plugin Documentation where you can dive further into the properties of each type.

Common chart properties

All chart types share the following chartOptions properties:

Bar chart

type: io.kestra.plugin.core.dashboard.chart.Bar

Compares categorical data across groups. Requires exactly one aggregation column.

Additional chartOptions properties:

charts:
  - id: executions_per_namespace_bars
    type: io.kestra.plugin.core.dashboard.chart.Bar
    chartOptions:
      displayName: Executions per Namespace
      description: Execution count per namespace
      column: namespace
      legend:
        enabled: true
    data:
      type: io.kestra.plugin.core.dashboard.data.Executions
      columns:
        namespace:
          field: NAMESPACE
        state:
          field: STATE
        total:
          displayName: Executions
          agg: COUNT

Pie chart

type: io.kestra.plugin.core.dashboard.chart.Pie

Shows proportions and distributions. Requires exactly one aggregation column.

Additional chartOptions properties:

charts:
  - id: executions_pie
    type: io.kestra.plugin.core.dashboard.chart.Pie
    chartOptions:
      displayName: Total Executions
      description: Total executions per state
      graphStyle: DONUT
      colorByColumn: state
      legend:
        enabled: true
    data:
      type: io.kestra.plugin.core.dashboard.data.Executions
      columns:
        state:
          field: STATE
        total:
          agg: COUNT

TimeSeries chart

type: io.kestra.plugin.core.dashboard.chart.TimeSeries

Tracks trends over time. Requires between one and two aggregation columns.

Additional chartOptions properties:

The graphStyle property can be set per column in data.columns to control how each series is rendered: LINES, BARS, or POINTS. It defaults to LINES when an aggregation is set.

charts:
  - id: executions_timeseries
    type: io.kestra.plugin.core.dashboard.chart.TimeSeries
    chartOptions:
      displayName: Executions
      description: Executions last week
      column: date
      colorByColumn: state
      legend:
        enabled: true
    data:
      type: io.kestra.plugin.core.dashboard.data.Executions
      columns:
        date:
          field: START_DATE
          displayName: Date
        state:
          field: STATE
        total:
          displayName: Executions
          agg: COUNT
          graphStyle: BARS
        duration:
          displayName: Duration
          field: DURATION
          agg: SUM
          graphStyle: LINES

KPI chart

type: io.kestra.plugin.core.dashboard.chart.KPI

Displays a single key performance indicator value. Requires exactly one aggregation column. Use ExecutionsKPI, FlowsKPI, LogsKPI, or MetricsKPI as the data type for KPI charts.

To display a ratio (e.g., success rate), use the numerator property to filter the subset of rows that count toward the numerator. All rows matching the chart’s where clause form the denominator.

Additional chartOptions properties:

charts:
  - id: kpi_success_percentage
    type: io.kestra.plugin.core.dashboard.chart.KPI
    chartOptions:
      displayName: Success Ratio
      numberType: PERCENTAGE
      width: 3
    data:
      type: io.kestra.plugin.core.dashboard.data.ExecutionsKPI
      columns:
        field: FLOW_ID
        agg: COUNT
      numerator:
        - field: STATE
          type: IN
          values:
            - SUCCESS
      where:
        - field: NAMESPACE
          type: EQUAL_TO
          value: "company.team"

Table

type: io.kestra.plugin.core.dashboard.chart.Table

Displays structured data in a sortable, paginated table.

Additional chartOptions properties:

Column-level properties unique to tables:

charts:
  - id: table_metrics
    type: io.kestra.plugin.core.dashboard.chart.Table
    chartOptions:
      displayName: Sum of sales per namespace
    data:
      type: io.kestra.plugin.core.dashboard.data.Metrics
      columns:
        namespace:
          field: NAMESPACE
        value:
          field: VALUE
          agg: SUM
          columnAlignment: RIGHT
      where:
        - field: NAME
          type: EQUAL_TO
          value: sales_count
      orderBy:
        - column: value
          order: DESC

Markdown

type: io.kestra.plugin.core.dashboard.chart.Markdown

Adds explanatory text or context alongside data charts. No data property is required.

The content of a Markdown chart is set via the source property. Two source types are available:

Text — inline Markdown content:

charts:
  - id: markdown_insight
    type: io.kestra.plugin.core.dashboard.chart.Markdown
    chartOptions:
      displayName: Chart Insights
      description: How to interpret this chart
    source:
      type: Text
      content: |
        ## Execution Success Rate

        This chart displays the percentage of successful executions over time.

        - A **higher success rate** indicates stable and reliable workflows.
        - Sudden **drops** may signal issues in task execution or external dependencies.

FlowDescription — pulls the description from a specific flow:

charts:
  - id: markdown_flow_desc
    type: io.kestra.plugin.core.dashboard.chart.Markdown
    chartOptions:
      displayName: Flow Overview
    source:
      type: FlowDescription
      namespace: company.team
      flowId: my_flow

Dashboard as code

The + Create new dashboard button opens the editor. Select the YAML view to define the dashboard layout and charts directly as code.

The top-level dashboard properties are:

The example below defines a dashboard with a TimeSeries execution chart, a success ratio KPI, two data tables, and a Markdown panel:

title: Getting Started
description: First custom dashboard
timeWindow:
  default: P7D
  max: P365D
charts:
  - id: executions_timeseries
    type: io.kestra.plugin.core.dashboard.chart.TimeSeries
    chartOptions:
      displayName: Executions
      description: Executions last week
      legend:
        enabled: true
      column: date
      colorByColumn: state
    data:
      type: io.kestra.plugin.core.dashboard.data.Executions
      columns:
        date:
          field: START_DATE
          displayName: Date
        state:
          field: STATE
        total:
          displayName: Executions
          agg: COUNT
          graphStyle: BARS
        duration:
          displayName: Duration
          field: DURATION
          agg: SUM
          graphStyle: LINES

  - id: kpi_success_percentage
    type: io.kestra.plugin.core.dashboard.chart.KPI
    chartOptions:
      displayName: Success Ratio
      numberType: PERCENTAGE
      width: 3
    data:
      type: io.kestra.plugin.core.dashboard.data.ExecutionsKPI
      columns:
        field: FLOW_ID
        agg: COUNT
      numerator:
        - field: STATE
          type: IN
          values:
            - SUCCESS
      where:
        - field: NAMESPACE
          type: EQUAL_TO
          value: "company.team"

  - id: table_metrics
    type: io.kestra.plugin.core.dashboard.chart.Table
    chartOptions:
      displayName: Sum of sales per namespace
    data:
      type: io.kestra.plugin.core.dashboard.data.Metrics
      columns:
        namespace:
          field: NAMESPACE
        value:
          field: VALUE
          agg: SUM
      where:
        - field: NAME
          type: EQUAL_TO
          value: sales_count
        - field: NAMESPACE
          type: IN
          values:
            - dev_graph
            - prod_graph
      orderBy:
        - column: value
          order: DESC

  - id: table_logs
    type: io.kestra.plugin.core.dashboard.chart.Table
    chartOptions:
      displayName: Log count by level for filtered namespace
    data:
      type: io.kestra.plugin.core.dashboard.data.Logs
      columns:
        level:
          field: LEVEL
        count:
          agg: COUNT
      where:
        - field: NAMESPACE
          type: IN
          values:
            - dev_graph
            - prod_graph

  - id: markdown
    type: io.kestra.plugin.core.dashboard.chart.Markdown
    chartOptions:
      displayName: Chart Insights
      description: How to interpret this chart
    source:
      type: Text
      content: |
        ## Execution Success Rate

        This chart displays the percentage of successful executions over time.

        - A **higher success rate** indicates stable and reliable workflows.
        - Sudden **drops** may signal issues in task execution or external dependencies.
        - Use this insight to identify trends and optimize performance.

More dashboard examples are available in the Enterprise Edition Examples repository.

Exporting data

Export table data as CSV using the download icon in the top-right corner of a table chart — no pagination required.

Querying data

The data property of a chart defines the type of data that is queried and displayed. The type determines which columns are available.

Data source types

Dashboards can query data from these source types:

Available fields by data source

After defining the data source, specify the columns to display in the chart. Each column is defined by its field. The fields available depend on the data source type:

Executions / ExecutionsKPI:

Flows / FlowsKPI:

Logs / LogsKPI:

Metrics / MetricsKPI:

Triggers:

Assets (EE and Cloud only)

Asset charts are not filtered by the dashboard time range — they always reflect the current inventory. Assets is compatible with Bar, Pie, and Table chart types. Use NAMESPACE in a where clause to scope results to a specific namespace.

Column properties

Each entry in data.columns supports the following properties:

Filtering data

Use the where property to filter the result set before it is displayed. Filters can apply to any field in the data source. Multiple conditions in where are combined with AND by default. To use OR logic, set type: OR on a condition.

Available filter types:

• CONTAINS
• ENDS_WITH
• EQUAL_TO
• GREATER_THAN
• GREATER_THAN_OR_EQUAL_TO
• IN
• IS_FALSE
• IS_NOT_NULL
• IS_NULL
• IS_TRUE
• LESS_THAN
• LESS_THAN_OR_EQUAL_TO
• NOT_EQUAL_TO
• NOT_IN
• OR
• PREFIX
• REGEX
• STARTS_WITH