Skip to main content

RSS/Atom Data Source

Grafana 9 YouTube CI codecov Language grade: JavaScript

Introduction​

The RSS/Atom data source is a plugin for Grafana that retrieves RSS/Atom feeds and allows to visualize them using Dynamic Text and other panels.

Requirements​

  • Grafana 8.5+, Grafana 9.0+ is required for version 2.X.
  • Grafana 8.0+ is required for version 1.X.

Getting Started​

RSS/Atom data source can be installed from the Grafana repository or use the grafana-cli tool to install from the command line:

grafana-cli plugins install volkovlabs-rss-datasource

Features​

  • Supports RSS 2.0, RSS 1.0 and Atom.
  • Works great with Dynamic Text panel by Marcus Olsson (marcusolsson-dynamictext-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.

Provisioning​

Grafana supports managing data sources by adding one or more YAML config files in the provisioning/datasources folder.

Example of provisioning the RSS/Atom Data Source for Bitcoin news feed.

datasources:
  - name: Bitcoin
    type: volkovlabs-rss-datasource
    access: proxy
    orgId: 1
    uid: rZAdZdf7k
    version: 1
    editable: true
    jsonData:
      feed: https://news.bitcoin.com/feed/

Disable Sanitize HTML​

To display HTML returned from feeds please disable sanitize HTML parameter. For Docker:

GF_PANELS_DISABLE_SANITIZE_HTML=true

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.