Plugins 〉Calendar

Panel
community

Calendar

  • Overview
  • Installation
  • Change log
  • Related content

Calendar panel plugin for Grafana

Calendar

Grafana 9 CI codecov

Introduction

The Calendar panel plugin for Grafana to display calendar events from data sources.

Requirements

  • Grafana 8.5+, Grafana 9.0+ is required.

Getting Started

Calendar panel can be installed from the Grafana Marketplace or use the grafana-cli tool to install from the command line:

grafana-cli plugins install marcusolsson-calendar-panel

Features

  • Allows to change time range by selecting the days in the calendar.
  • Query calendar events from any data source.

Panel options

Display

OptionDescription
Scroll to bottomAutomatically scroll to the end of the time range.

Dimensions

OptionDescription
TextField to use as event text. Defaults to the first text field.
DescriptionField to use as event description.
Start timeField to use as event start time. Defaults to the first time field.
End timeField to use as event end time.
LabelsFields to use as event labels.

If only Start is configured, events are considered instantaneous.

If End are configured, events are considered to have a duration. Any events that are missing an end time are considered ongoing.

Feedback

We love to hear from users, developers, and the whole community interested in this plugin. These are various ways to get in touch with us:

  • Ask a question, request a new feature, and file a bug with GitHub issues.
  • Star the repository to show your support.

License

  • Apache License Version 2.0, see LICENSE.

Installing Calendar on Grafana Cloud:

For more information, visit the docs on plugin installation.

Changelog

1.0.0 (2022-10-02)

Features / Enhancements

  • Maintained by Volkov Labs (#51)
  • Updated based on Volkov Labs Panel Template (#51)
  • Update to Grafana 9.1.6 (#52)

0.7.1 (2022-08-28)

Features / Enhancements

  • Update to Grafana 9

0.7.0 (2022-03-09)

Features / Enhancements

  • Quick links: Enable quick links to follow the data link when you click the event rather than opening a modal.
  • Update to Grafana 8.4.3

0.6.0 (2022-01-28)

Breaking changes

This release bumps the minimum required Grafana to >=8.0. 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.5.0.
  • If you're running Grafana 8.0 or above, you should update to v0.6.0.

0.5.0 (2021-09-06)

Features / Enhancements

  • Data links support (#25)
  • New details view: Instead of relying on tooltips, this version uses an inline drawer to display additional details. I like this better, but the built-in drawer component has some limitations. I'm not sure I like that it's a modal for example. I might end up creating a custom sidebar component. Let me know what you think about the new design!

0.4.3 (2021-06-12)

Features / Enhancements

  • Change "Apply time interval" to "Apply time range" to match Grafana
  • Increase contrast for single-day events

0.4.2 (2021-05-22)

Bug fixes

  • classicColors is (still) undefined (#16)

0.4.1 (2021-05-21)

Bug fixes

  • classicColors is undefined (#16)
  • Improve legibility of event text (#15)

0.4.0 (2021-05-20)

Features / Enhancements

  • Show event name if event starts in day out of filter (#13)
  • More calendars and colors (#14)
  • Line breaks in event description (#11)

0.3.0 (2021-05-18)

Features / Enhancements

  • Show more details for individual events (#10)

0.2.0 (2021-05-09)

Features / Enhancements

  • Multi-day events (#1)
  • Display truncated events (#6)
  • Allow string and number fields for time dimensions

0.1.1 (2021-02-10)

No changes.

0.1.0 (2021-02-10)

Initial release. Not fit for production.