Hosted Graphite Docs
Get StartedBook a Demo
  • Welcome to Hosted Graphite
  • Getting Started
  • HG-CLI
  • Sending Metrics
    • Supported Protocols
    • Graphite Tag Support
    • Metric Management
    • Metric APIs
  • Language Guide
    • Metric Libraries
    • .NET
    • Go
    • Java
    • Javascript
    • Node.js
    • PHP
    • Postman
    • Python 2.x
    • Python 3.x
    • Python Pickle
    • Ruby
    • Shell
    • TypeScript
  • Dashboard and Graphs
    • Primary Dashboards
    • Dashboard Library
    • Local Dashboard Integration
    • Worldmap Panel
    • Graphite Dashboard Guide
    • Graphite Graph Menu Reference
    • Other Dashboard Options
  • Alerting Guide
    • Alerting Overview
    • Alerts API
    • Notification Channels API
    • Scheduled Mutes API
    • Using Your Own Alerting
  • Agents Guide
    • The Hosted Graphite Agent
      • Base Metrics
      • System Layout
    • Telegraf
    • K8 Telegraf Daemon
    • OpenTelemetry
    • collectd Agent
    • StatsD Agent
    • Diamond
  • Add-Ons and Integrations Guide
    • AWS CloudWatch
    • Azure Monitor Metrics
    • GCP Metrics
    • Carbon-C-Relay
    • Circle CI
    • Cloudbees
    • Collectd Add Ons
    • GitHub
    • GitLab
    • Heroku
    • Hosted StatsD
    • New Relic
    • Papertrail
    • Pingdom
    • Sentry
    • Sitespeed
    • StatsD Add-on
    • Statuspage
  • Account Management
    • Access Keys
    • Account Diagnostics
    • Account Settings
    • Team Access: Limited Access Groups
    • SAML Authentication
    • Team Access
  • Additional Features
    • Aggregation Rules
    • Data Views
  • API Guides
    • Metrics API
    • Tag API
    • Graphite Render API
    • Render Variables API
    • Dashboard API
    • Annotations and Events API
    • Aggregation Rules API
    • Alerts APIs
  • FAQ
    • General
    • Business
    • Technical
    • Account Metrics and Limiting
    • Customization
    • Troubleshooting
    • Support
    • Changelog
Powered by GitBook
On this page
  • Query Example
  • Map Visual Option Settings
  • Map Data Options

Was this helpful?

  1. Dashboard and Graphs

Worldmap Panel

The Worldmap Panel is a tile map of the world that can be overlaid with circles representing data points from a metric query.

PreviousLocal Dashboard IntegrationNextGraphite Dashboard Guide

Last updated 5 months ago

Was this helpful?

Geomap Panel

In versions of Grafana > 8, Worldmap has been renamed to and requires a few additional parameters to properly render data from your Graphite metrics. This example shows how to use the built-in Gazetteer for US states but you can also lookup coordinates by country, or define coordinates:

  • Add a Reduce transformation to the query:

    • Mode: Series to Rows

    • Calculations: Total

  • Update map layers in panel edit mode:

    • Location Mode: Lookup

    • Lookup Field: Field

    • Gazetteer: USA States

Worldmap Panel (deprecated)

Data points are linked to locations on the map by matching part of the metric name to a key in the set of ‘Location Data’.

Included location data:

  • Countries (2 letter codes)

  • Countries (3 letter codes)

  • US states

This works by matching country codes (like US or GB or FR) or US state codes (TX or NY) to a node or a wildcard in a metric namespace. If there is a match in the list of countries or states then a circle will be drawn at the location.

The size of the circle depends on the value of the matched metric. Circle size is relative e.g. if you have 3 countries with values 1, 2, and 3 or 100, 200, and 300 then you will get one small circle, one medium circle, and one large circle.

Query Example

Use the aliasByNode function to point to the field containing the country code: aliasByNode(worldmap-metric.country.US, 2)

Map Visual Option Settings

Center

This setting configures the default center of the map. There are 5 centers to choose from or you can choose a custom center. For a custom center, there are two fields: latitude and longitude. Examples of values are 37.09024, -95.712891 for the center of the US, or 55.378051, -3.435973 for Great Britain.

Initial Zoom:

The initial zoom factor for the map. This is a value between 1 and 18 where 1 is the most zoomed out.

Min Circle Size:

This is minimum size for a circle in pixels.

Max Circle Size:

This is the maximum size for a circle in pixels. Depending on the zoom level you might want a larger or smaller max circle size to avoid overlapping.

Unit:

The unit is shown in the popover when you hover over a circle. There are two fields the singular form and the plural form. E.g. visit/visits or error/errors

Show Legend:

Shows/hide the legend on the bottom left that shows the threshold ranges and their associated colours.

Map Data Options

Location Data

There are four location data options for the Worldmap panel:

countries

This is a list of all the countries in the world. It works by matching a country code (US, FR, AU) to a node alias in a time series query.

countries_3letter

The same as above, but with 3 letter codes (USA, FRA, AUS).

states

Similar to countries but for the states in USA e.g. CA for California

probes

This is a selection of cities around the world.

City keys included in probes

taipei
london
los-angeles
new-jersey
portland
south-carolina
sydney
charleroi
frankfurt
new-york
san-francisco
seattle
singapore
amsterdam
chicago
miami
paris
sao-paulo
silicon-valley
tokyo
atlanta
dallas
omaha

Threshold Options

Thresholds control the colour of the circles.

If one value is specified then two colours are used. For example, if the threshold is set to 10 then values under 10 get the first colour and values that are 10 or more get the second colour.

The threshold field also accepts 2 or more comma-separated values. For example, if you have 2 values that represent 3 ranges that correspond to the three colours. For example: if the thresholds are 70, and 90 then the first colour represents < 70, the second colour represents between 70 and 90 and the third colour represents > 90.

Geomap Panel

  • Add a Reduce transformation to the query:

    • Mode: Series to Rows

    • Calculations: Total

  • Update map layers in panel edit mode:

    • Location Mode: Lookup

    • Lookup Field: Field

    • Gazetteer: USA States

Probes (a )

In versions of Grafana > 8, Worldmap has been renamed to and requires a few additional parameters to properly render data from your Graphite metrics.

Geomap
selection of cities
Geomap
Transform Query
Worldmap Example