Creating a geographic chart

Geographic charts map their presentation onto a geographic map by using location information, where the data is displayed on the map according to the geographic location with which the data is associated.

Before you begin

Create a widget based on one of the following data sources and ensure that you have query results:


  1. In the Views section of the widget, give the chart a name and select whether to show the title and the update status.
  2. Select Geographic Chart.
  3. On the General tab, select the chart subtype.

    Scatter Geo charts display points to indicate the IP source and destination of detected malicious activities. You can display lines between the source and destination points.

    Choropleth charts are shaded in proportion to the amount of malicious activity detected in each geographic region.

  4. Select the type of geographic data, metric data, location, and projection.
  5. Set Show Legend to Yes and set the orientation.
  6. On the Thresholds tab, set thresholds for the geographic chart. In scatter geo charts, thresholds can be indicated in various ways. In choropleth charts, thresholds are indicated by using a color scale.
    1. Click Add Threshold Indicator.
    2. Set thresholds to display any numerical field in the query, such as the magnitude of events. For Scatter Geo charts, select the threshold indicator (point color, point shape, point size, line color, or line width) and then select the column. For Choropleth charts, select color scale and then select the column.
    3. Enter a value and click Add Value to pick a color or enter an HTML color code in the color palette to make it easier to select the same colors on different charts.
      Important: It is invalid to select a non-numerical column as a threshold. Run the query to get results and check your threshold settings to make sure that they work properly.
  7. On the Map tab, show borders and map grids, and set the color scheme for when land and water is displayed. If there is more than one geographic data source, you can also show the lines between data sets.
  8. Under Viewport, configure the latitude, longitude, and scale for how the map displays in the dashboard item. When you're happy with the preview display, click Set latitude, longitude, and scale as seen in the preview.
  9. Optional: On the Drilldown tab, choose whether to open a URL or a dashboard when an item is clicked in the geographic chart.
    1. If you chose to open a URL, specify an absolute path to open an external URL (for example, Choose whether to open the URL in the current window or in a new window. If you open an external URL in the current window, it replaces the console.

      You can define any number of parameters anywhere in the URL. Enclose parameters in braces ({}), then select a value for each parameter. For example,{ip_address}.

    2. If you chose to open a dashboard, select the dashboard to open, optionally select dashboard parameter values, and choose whether to open it in the current window or in a new window.

      If you set parameters, they are passed to the target dashboard based on the item that was clicked in the geo chart. For example, if you set an ID parameter, the bar or segment ID is passed as a parameter to the target dashboard. If you set a dashboard parameter value to Default, no parameter value is passed to the target dashboard; the existing session or default parameter value is used or the parameter field is blank in the target dashboard Parameters card.

      Tip: If you drill down to a different dashboard in the same window, you can use the breadcrumb trail to return to previous dashboards in the drill path.
  10. Preview how the chart looks and then click Save.
    Tip: The labels for the chart come from the queries that are used. If they are unintelligible in the preview, edit the labels in the View section.