Connecting to Elastic Maps Service

Elastic Maps Service (EMS) is a service that hosts tile layers and vector shapes of administrative boundaries. If you are using Kibana’s out-of-the-box settings, Elastic Maps is already configured to use EMS.

EMS requests are made to the following domains:

  • catalogue.maps.elastic.co
  • tiles.maps.elastic.co
  • vector.maps.elastic.co

Elastic Maps makes requests directly from the browser to EMS.

Connect to Elastic Maps Service from an internal network

To connect to EMS when your Kibana server and browser are in an internal network:

  1. Set map.proxyElasticMapsServiceInMaps to true in your kibana.yml file to proxy EMS requests through the Kibana server.
  2. Update your firewall rules to whitelist connections from your Kibana server to the EMS domains listed above.

Coordinate map and region map visualizations do not support map.proxyElasticMapsServiceInMaps and will not proxy EMS requests through the Kibana server.

Disable Elastic Maps Service

You might experience EMS connection issues if your Kibana server or browser are on a private network or behind a firewall. If this happens, you can disable the EMS connection to avoid unnecessary EMS requests.

To disable EMS, change your kibana.yml file.

  1. Set map.includeElasticMapsService to false to turn off the EMS connection.
  2. Set map.tilemap.url to the URL of your tile server. This configures the default tile layer of Elastic Maps.
  3. (Optional) Set map.regionmap to the vector shapes of the administrative boundaries that you want to use.