Plugins 〉Humio
The Humio plugin has been deprecated and is no longer maintained.
Humio
Humio Datasource
The Humio Datasource for Grafana allows you to visualize your Humio data within Grafana. Full documentation can be found at the official humio docs and usage examples can be found here.
Vision
The vision for this project, is to create a plugin for Grafana, which allows users to create Grafana panels that pull data from Humio. It should be possible for users to write pure Humio queries in Grafana to populate their panels. Development seeks to keep the plugin up to date with both Grafana and Humio as they evolve.
Governance
This project is maintained by employees at Humio ApS. As a general rule, only employees at Humio can become maintainers and have commit privileges to this repository. Therefore, if you want to contribute to the project, which we very much encourage, you must first fork the repository. Maintainers will have the final say on accepting or rejecting pull requests. As a rule of thumb, pull requests will be accepted if:
- The contribution fits with the project's vision
- All automated tests have passed
- The contribution is of a quality comparable to the rest of the project
The maintainers will attempt to react to issues and pull requests quickly, but their ability to do so can vary. If you haven't heard back from a maintainer within 7 days of creating an issue or making a pull request, please feel free to ping them on the relevant post.
Maintainers will also be in charge of both versioning and publishing future releases of the project. This includes adding versioning tags and adding to the changelog file.
The active maintainers involved with this project include:
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
.h4 . .mb-0 }
- 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 Humio 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 Humio 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.
Changelog
0.1.5 (2020-03-26)
Major refactoring of codebase.
Added
- Support for table queries
- Support for groupby on multiple fields
Changed
- Migrated from using older REST endpoints to modern GraphQL
- Updated code structure to improve readability
Removed
- Many smaller unused files.
2.0.0 (2020-04-16)
Update to Datasource Configuration. This update requires existing data sources to be set up again.
Added
- Encryption of Humio access token on backend. Now all Humio calls are proxied through the Grafana backend, meaning that access tokens are no longer accessible to users in the frontend. This also means that Humio queries can no longer be made through the browser directly.
Changed
- Fixed bug where humio query links would not work, if the datasource URL did not have a trailing slash.
Removed
- Some standard data source configuration options. These had to be removed in order to configure datasources for encrypted access tokens.
3.0.0 (2020-07-16)
Major update which rewrites the plugin to use React rather than AngularJS
Added
- Support for variables
- Support for annotations
Changed
- Fixed bug where humio query links would not work, if the datasource URL did not have a trailing slash.
Removed
- Old tests
3.0.1 (2020-07-21)
Patch which allows users to use non-token auth for data sources again.
Changed
- Updated data source config to allow users more types of authentication.
3.0.2 (2020-07-24)
Can now filter repository dropdowns to limit their contents
Added
- A field to the Annotations page, which allows for filtering on strings beginning with another string.
3.0.3 (2020-08-26)
Smaller bugfixes
Changed
- Annotation query now works without Regex lookahead. This is not supported in browsers like Safari, so it yielded some issues.
Removed
- Regex escaping for variables. The escaping procedure proved to aggressive and ruined templated queries.
3.0.4 (2020-08-27)
Version created to test release pipeline, equivalent with 3.0.3.
3.0.5 (2020-10-29)
Updated plugin id, so that the project was ready for official release.
3.1.0 (2020-11-03)
First release to Grafana.com
Changed
- Update to use grafana-toolkit 7.3.0 to fix some vulnerable dependencies
- Changed plugin id to
humio-datasource
, will require a reinstallation of existing datasources.
3.1.1 (2020-11-09)
Changed
- Updated Query editor not to execute query when hidden or when no repo is selected.
3.2.0 (2020-12-08)
Added
- Queries are now marked as initiated from Grafana.
- A large amount of new unit tests.
Changed
- Annotation queries can now use live query jobs like with the panel queries.
- Non-predefined time ranges that can be set in Grafana are now supported.
3.2.1 (2020-12-18)
Added
- Unit tests for the query job object
Changed
- BugFix: Switching between repos when running live queries now results in a new queryjob being created.
- BugFix: Error Handling in query job now works as it used to, and can recreate queryjob automatically on errors.
3.2.2 (2021-01-06)
Changed
- Upgraded some transitive dependencies to include security fixes.
3.2.3 (2021-01-29)
Changed
- Upgraded some transitive dependencies to include security fixes.
3.2.4 (2021-03-30)
Changed
- Fixed issue where data of certain timechart queries wasn't correctly formatted.
- Upgraded some transitive dependencies to include security fixes.
3.3.0 (2021-09-02)
Added
- Functionality for creating region annotations
Changed
- Now depending on Grafana version 8
- Non-admins can now follow the humio query link in the query editor
- Upgraded some transitive dependencies to include security fixes.
3.3.1 (2022-08-26)
Changed
- Changed plugin dependency to Grafana version '=>8.0.0'