Plugins 〉Gantt
Gantt
Gantt for Grafana
Important: As of July 2022, I'm no longer actively maintaining this plugin. If this plugin has been useful to you, consider switching to the State timeline core panel.
A panel plugin for Grafana to visualize Gantt charts.
Gantt charts display a list of tasks over time, where each task is visualized using a bar with a start and an end time.
Features
- Identify bottlenecks where one or more tasks are running significantly longer than others
- Compare recurring sets of tasks by grouping them, such as data pipelines that run in regular intervals.
- Display additional metadata from your data source as labels
Configuration
This section lists the available configuration options for the Gantt panel.
Panel options
Experiments
By enabling experiments, you can try out new features that we're working on. Experiments can be unstable and may break your panel. Use at your own risk.
Dimensions
Option | Description |
---|---|
Text | Name of the field to use for task labels. Defaults to the first string field. |
Start time | Name of the field to use for value. Defaults to the first time field. |
End time | Name of the field to use for value. Defaults to the second time field. |
Color by | Field to use for colors. Defaults to the text field. Color configuration depends on the field type. If the dimension is set to a string field, you can add color mappings for each value. If the dimension is set to a number field, you can instead use field options to configure the colors. |
Group by | Name of the field to use to group tasks. When grouping tasks, the time interval is set to the start of the first task and the end of the last task in the group. |
Labels | Fields to use as labels in the tooltip. |
As some data sources don't yet support time fields, the plugin supports selecting string and number fields as start and end time:
- If you select a string field, values need to be ISO 8601 strings
- If you select a number field, values need to be Unix timestamps in milliseconds
Display
Option | Description |
---|---|
Show Y-axis | Toggles the Y-axis. |
Sort by | Dimension to sort tasks by. |
Sort order | Order in which to sort the tasks. |
Color mappings | Configures task color based on the text value based on the Color by dimension. |
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Installing Gantt on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Panel
Use the grafana-cli tool to install Gantt from the commandline:
grafana-cli plugins install
The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Add the Panel to a Dashboard
Installed panels are available immediately in the Dashboards section in your Grafana main menu, and can be added like any other core panel in Grafana.
To see a list of installed panels, click the Plugins item in the main menu. Both core panels and installed panels will appear.
Changelog
0.8.1 (2022-06-28)
This releases updates the plugin to support Grafana 9.0.
0.8.0 (2022-01-28)
This release bumps the minimum required Grafana to >=8.1. Grafana 8 introduces a new theming engine for panel plugins.
- If you're running a Grafana version before 8.0, you should stay with v0.7.5.
- If you're running Grafana 8.1 or above, you should update to v0.8.0.
0.7.5 (2022-01-07)
Bug fixes
0.7.4 (2021-09-05)
Bug fixes
- Fix Data Links in Grafana 8.0 (#49)
0.7.3 (2021-08-06)
Bug fixes
- Cannot read property 'visualization' of undefined (#38)
0.7.2 (2021-06-15)
Enhancements
- Upgrade grafana-plugin-support dependency
0.7.1 (2021-06-15)
Enhancements
- Nothing plotted when too many values on y axis (#32)
- Metadata and docs updates
- Upgrade dependencies
0.7.0 (2021-05-09)
Enhancements
- Color support: You can now configure colors based on text and number fields. Unfortunately, this bumps the minimum required Grafana version to 7.3.0 (#26)
- Support for data links (#25)
- Improved zoom support
- Option to not display y axis labels (#30)
- Limit task bar height (#22) (thanks @ymmt07039)
0.6.1 (2021-03-07)
Enhancements
- Limit Y-axis to relevant values only (#19)
0.6.0 (2021-02-18)
Enhancements
Adds a new Experiments category with two new features: Lock to extents and Relative time:
- Lock to extents locks the zoom to fit all tasks from start to finish
- Relative time changes the X axis to display the duration from when the first task started
0.5.0 (2021-02-16)
Enhancements
- Add option to sort tasks by text or by start time (#15)
- Make dimensions clearable (#12)
- Add fallback panel for unsupported Grafana versions
- Add wizard for configuring the query
0.4.0 (2021-02-06)
Enhancements
0.3.1 (2021-02-02)
Bug fixes
- Reduced precision when using strings as time (#5)
0.3.0 (2021-01-28)
Enhancements
- Null values are interpreted as infinity
- Add duration to tooltip
- Improved styles
0.2.0 (2020-01-27)
Enhancements
0.1.0 (2020-01-08)
Initial release. Not fit for production use.