Plugins 〉RSS/Atom
RSS/Atom
RSS/Atom Data Source for Grafana
Introduction
The RSS/Atom data source is a plugin for Grafana that retrieves RSS/Atom feeds and allows visualizing them using Dynamic Text and other panels.
Requirements
- Grafana 9 and Grafana 10 are required for major version 3.
- Grafana 8.5 and Grafana 9 are required for major version 2.
- Grafana 8 is required for major version 1.
Getting Started
RSS/Atom data source can be installed from the Grafana Catalog or utilizing the Grafana command line tool.
For the latter, please use the following command.
grafana-cli plugins install volkovlabs-rss-datasource
Highlights
- Supports RSS 2.0, RSS 1.0 and Atom.
- Works great with Dynamic Text visualization panel.
- Returns Channel (Feed) data, Items (Entries) or both as separate data frames.
- Extract and parse as additional fields:
- Image from Meta.
- H4 and Image from the Encoded content.
- Media:Group for YouTube.
- Filter items/entries based on the selected Time Range.
- Allows specifying Query parameters with dashboard variables.
Documentation
Section | Description |
---|---|
Dynamic Text | Demonstrates how to display feed using Dynamic Text panel. |
Provisioning | Demonstrates how to automatically provision the Data Source. |
Release Notes | Stay up to date with the latest features and updates. |
Feedback
We're looking forward to hearing from you. You can use different ways to get in touch with us.
- Ask a question, request a new feature, and file a bug with GitHub issues.
- Subscribe to our YouTube Channel and leave your comments.
- Sponsor our open-source plugins for Grafana with GitHub Sponsor.
- Support our project by starring the repository.
License
Apache License Version 2.0, see LICENSE.
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 RSS/Atom 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 Data Source
Use the grafana-cli tool to install RSS/Atom 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. Configure the Data Source
Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.
Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.
To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.
Change Log
3.1.0 (2023-02-12)
Features / Enhancements
- Add application type in Headers (#61)
- Update ESLint configuration and refactoring (#62)
- Update to Grafana 10.3.1 (#63)
3.0.1 (2023-08-02)
Bugfix
- Remove root URL http://localhost:3000 added during migration to Plugin Tools
3.0.0 (2023-07-26)
Breaking changes
- Requires Grafana 9 and Grafana 10
Features / Enhancements
- Update tests with testing-library/react (#50)
- Migrate to Plugin Tools 1.5.2 (#51)
- Update to Node 18 and npm (#51)
- Update to Grafana 10.0.0 (#51)
- Add E2E Cypress testing (#52)
- Remove Grafana 8.5 support (#56)
- Update ESLint configuration (#56)
2.4.0 (2023-04-08)
Features / Enhancements
- Update to Grafana 9.4.7 (#44)
- Update CI and Release workflows (#45)
- Update Documentation, Provisioning (#46)
- Add URL parameters with variables support (#47, #48)
2.3.0 (2022-11-16)
Features / Enhancements
- Update to Grafana 9.1.4 (#36)
- Add Compatibility Check Workflow (#37)
- Update CI to Node 16 and Synchronize with Release workflow (#39)
- Update to Grafana 9.2.2 (#40)
- Update CI to upload signed artifacts (#41)
2.2.0 (2022-08-25)
Features / Enhancements
- Add YouTube video in README (#32)
- Rebuild based on 9.1.1 (#35)
2.1.0 (2022-06-23)
Features / Enhancements
- Add YouTube fields parsing and refactoring (#31)
2.0.0 (2022-06-17)
Breaking changes
- Requires Grafana 8.5+ and 9.0+
Features / Enhancements
- Rebuild based on 9.0.0 (#30)
1.7.0 (2022-05-21)
Features / Enhancements
- Support Feed URL with query parameters (#28)
1.6.2 (2022-05-13)
Breaking changes
- Requires Grafana 8.3.0 or newer.
1.6.1 (2022-05-13)
Features / Enhancements
- Clarify Breaking change introduced in 1.6.0 (#24)
- Refactor API tests and set parsing
rss.channel.item
as array always (#25) - Improve test coverage (#26)
1.6.0 (2022-05-12)
Breaking changes
- Automatic parsing of
author.name
andmedia:thumbnail.url
fields break templates who uses them. To fix it, just replace it withauthor
andmedia:thumbnail
. Thanks to @vfauth for testing.
Features / Enhancements
- Rebuild based on 8.5.2 (#23)
Bug fixes
- Can't parse GitHub releases feed (#21)
1.5.0 (2022-04-25)
Features / Enhancements
- Add Provisioning instructions to README (#16)
- Rebuild using 8.4.3 (#17)
- Adding RSS 1.0 support (#19)
- Rebuild based on 8.5.0 (#20)
1.4.0 (2022-02-18)
Features / Enhancements
- Rebuild using 8.3.6 (#13)
- Rebuild using 8.4.0 and use PluginCheck v2 (#14)
- Select items/entries based on the selected Time Range (#3)
1.3.1 (2022-02-02)
Bug fixes
- Google Workspace Atom feed failed #11
1.3.0 (2022-01-24)
Features / Enhancements
- Update README with link to the Grafana Marketplace (#8)
- Rebuild using 8.3.4 (#6)
1.2.0 (2022-01-11)
Features / Enhancements
- Signed as Community datasource plugin (#7).
1.1.0 (2021-12-27)
Features / Enhancements
- Extract <img src="X"> from the <figure> (#5)
- Extract Guid's text from the <guid> (#5)
- Update dashboards layout
1.0.0 (2021-12-26)
Features / Enhancements
- Supports RSS 2.0 and Atom.
- Works great with Dynamic Text panel by Marcus Olsson (marcusolsson-dynamictext-panel).
- Initial release based on the Volkov Labs Abc Data source template.