Plugins 〉Orchestra Cities Map
Orchestra Cities Map
Orchestra Cities - Map Panel
This plugin extends Grafana Geomap panel with several functionalities:
- Support for GeoJSON shapes
- Support for icons (icons supported are from FontAwesome)
- Support for pop up visualizations of data from a specific point
- Multiple layers for the different queries
- A new map layer leveraging Inverse distance weighting (IDW) interpolation for scattered data points using Shepard's method.
New customization options available for the markers layer:
- Cluster support with a lot of customization like distance and value to display
- A fully customizable pin with the possibility to change colors, shapes and sizes
- The possibility to select which properties to be displayed on the popup
Cluster options:
- Distance
- Min distance
Pin Options:
- Shape
- Size
- Customizable icon
- Shadow
- Gradient
Popup Options:
- Display a title
- Display the Timestamp
- Selectable properties
Options available for the IDW layer:
IDW options:
- Weight value to be used to create the interpolation, including min and max range
- Scale factor of the precision of the interpolation
- Show data values over the map
Pupup Options:
- Display a title
- Display the Timestamp
- Selectable properties
It requires Grafana >=8.2.0
Usage with PostGis
To use the plugin with PostGis, you need either to query longitude and latitude from a stored Point
, e.g.:
ST_X(ST_GeomFromEWKT(location_centroid)) AS \"longitude\"
ST_Y(ST_GeomFromEWKT(location_centroid)) AS \"latitude\"
Or query the GeoJSON shape, e.g.:
ST_AsGeoJSON(ST_GeomFromEWKT(location)) AS \"geojson\"
Usage with CrateDB
To use the plugin with CrateDB, you need either to query longitude and latitude from a stored Point
, e.g.:
longitude(location_centroid) AS \"longitude\"
latitude(location_centroid) AS \"latitude\"
Or query the GeoJSON field, e.g.:
location AS \"geojson\"
What is a Grafana Panel Plugin?
Panels are the building blocks of Grafana. They allow you to visualize data in different ways. While Grafana has several types of panels already built-in, you can also build your own panel, to add support for other visualizations.
For more information about panels, refer to the documentation on Panels
Set up dev environment
See Contributing
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 Orchestra Cities Map 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 Orchestra Cities Map 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
v1.4.4
- Support for IDW Interpolation
- Update OpenLayer libraries
v1.4.3
- community signature
- Bump follow-redirects from 1.14.5 to 1.14.8
v1.4.2
- allow to the define colours for specific values via mappings
v1.4.1
- fix icon visualisation in pop-up and improve pop-up format
- support label for legends
- fix color per value in geometries
- fix color for clustering
v1.4.0
- Migrate to react for compatibility with Grafana 7+
v1.3.1
- Map centered at location updated when changing coordinates.
v1.3.0
- New option for centering map at user geolocation
v1.2.0
- Suport for leaflet markercluster
- Suport for leaflet sleep to avoid auto scroll when hover big dashboards.
- Resize panel improvements for mobile.
- min zoom level set to 3.
v1.1.0
- In the editor metrics tab, a query result can be 'format as' 'table'
v1.0.0
New features / Fix
- Changed the plugin's working process. Any datasource query with a group by clause will result in layers.
- Map rendering faster.
- Removal of polylines for data point of type traffic flow observed.
- Data points of type air quality, traffic flow and other have now distinct shapes (circle, square and triangle).
- Added missing snapshot functionality (Not tested).
- New option on editor for cityenv variable support. If we choose this option the map centers on the selected city.
- Fix problem with multiple map panels in the same dashboard.
- Ability to change the icon associated to the layer (with leaflet.awesome-markers).
- When adding this panel for the first time to a dashboard, metrics are filled with predefined values.
- Dark theme improvements.
Development
- Improvements based on grafana development guide best practices.
- New project structure. Improved DRY.
- Updated project packages. Leaflet version updated from 0.7 to 1.3.
- Updated project packages. Highcharts updated from 5.0.15 to 6.1.0.
- Fix app bugs introduced by Leaflet update.
- Gruntfile improvements.
v0.1.0
- Project structure improvements. Leaflet and highstock went out from project src and are now a dependency.
- Support for light and dark themes.
- From now on this file contents are reverse ordered to get last features on top.
v0.0.2
- Fixes bug where time series with a country code not found in the country data crashes the panel.
- Adds some extra country codes to the country data to be more similar to the MaxMind Country database.
v0.0.3
- Support for lowercase country codes for non-elasticsearch datasources.
v0.0.4
- Fixes snapshotting.
v.0.0.5
- Adds support for json and jsonp endpoints for location data.
v.0.0.6
- Adds decimal places option for data values in circle popovers.
v.0.0.7
- Updates tile map urls to https to avoid mixed content warnings on https sites.
v.0.0.8
- Saves location data in the dashboard json when snapshotting. This means snapshots should work even when using a custom endpoint for returning a location data json file.
v.0.0.9
- Fixes bug that meant location data did not refresh after being changed in the editor. It required the page to be refreshed to reload it.
v.0.0.10
- Performance fix for snapshotting. Sets maxdatapoints to 1 to minimize data that needs to be saved in the snapshot.
v.0.0.11
- Zoom issue fix and adds a states options for USA states location data.
v.0.0.12
v.0.0.13
- New location data option -> table data. Location data can now come from data sources other than graphite and Elasticsearch (InfluxDb for example). See table data instructions above on how to use it.
v.0.0.14
v.0.0.15
- Fix for change in Grafana that breaks Worldmap panels using Geohash or Table Data.
v.0.0.16
Option for sticky labels. Fix for https://github.com/grafana/worldmap-panel/issues/27
Ability to hide null or 0 values. Fix for https://github.com/grafana/worldmap-panel/issues/13
Background color change. Fixes https://github.com/grafana/worldmap-panel/issues/36
Dynamic thresholds implemented by Sam Hatchett. Can now have more than 2 threshold values. Thanks! Fixes https://github.com/grafana/worldmap-panel/issues/25
Validation and default values for option fields. Fixes https://github.com/grafana/worldmap-panel/issues/29
v.0.0.17
- Adds Country data with 3-letter country codes.