Elasticsearch:Elastic Maps Server 介绍
Posted 中国社区官方博客
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Elasticsearch:Elastic Maps Server 介绍相关的知识,希望对你有一定的参考价值。
在今天的文章中,我们很高兴向大家介绍 Elastic Maps Server。目前已经是正式版发布。如果你无法从 Kibana 服务器或浏览器客户端连接到 Elastic Maps Service,并且你的集群具有适当的许可证级别,则可以选择在自己的基础架构上托管该服务。
Elastic Maps Server 是 Elastic Maps Service 的自我管理版本,以 Docker 镜像的形式提供,同时提供 EMS 底图和 EMS 边界。 图像与底图捆绑在一起,最高缩放级别为 8。将其连接到 Elasticsearch 集群以进行许可证验证后,你可以选择下载和配置更详细的底图数据库。
重要:Elastic Maps Server 不提供 Vega,坐标和区域地图可视化所需的栅格图块(raster tiles)。
安装步骤
首先我们按照文章 “Security:如何安装 Elastic SIEM 和 EDR” 安装一个具有 https 访问权限的 Elastic Stack 集群。我的 Elasticsearch 及 Kibana 可以分别于一下的地址进行访问:
超级用户 elastic 的密码是 password。
我们接着到 Elastic 的官方网址 Elastic Maps Server 去下载。
我们首先需要在自己的电脑上安装 Docker。这里就不再累述了。我们启动 Docker。
我们可以使用 docker pull 从 Elastic Docker 注册表中下载 Elastic Maps Server 图像。
docker pull docker.elastic.co/elastic-maps-service/elastic-maps-server-ubi8:7.13.0
大家可能已经注意到上面的版本是 7.13,但是我们目前的 Elastic Stack 的最新版本是 7.12.1。这是什么原因呢?Elastic Maps 是独立于 Elastic Stack 开发的模块,它和 Elastic Stack 的版本可以完全不一致。
启动 Elastic Maps Server 并公开默认端口8080:
docker run --rm --init --publish 8080:8080 \\
docker.elastic.co/elastic-maps-service/elastic-maps-server-ubi8:7.13.0
Elastic Maps Server 运行之后,请按照网页上的说明进行操作:http://localhost:8080/ 定义配置文件,并可以选择下载更详细的底图数据库。
在上面,我们会发现一些错误。我们需要按照下面的 Setup Instructions。我们向下滚动:
按照上面的要求,我们输入如下的命令来创建一个 ems 的 role:
curl -k --user "elastic:password" -X POST -H "Content-Type: application/json" -d '{"cluster":["monitor"],"indices":[],"applications":[]}' "https://localhost:9200/_security/role/ems"
请注意在上面,我们使用 -k 选项来规避 SSL 错误信息:
$ curl -k --user "elastic:password" -X POST -H "Content-Type: application/json" -d '{"cluster":["monitor"],"indices":[],"applications":[]}' "https://localhost:9200/_security/role/ems"
{"role":{"created":true}}
我们使用如下的命令来创建一个 ems 的用户,并设置它的密码为 password。
curl -k --user "elastic:password" -X POST -H "Content-Type: application/json" -d '{"password":"password","roles":["ems"]}' "https://localhost:9200/_security/user/ems"
上面的命令返回的结果为:
$ curl -k --user "elastic:password" -X POST -H "Content-Type: application/json" -d '{"password":"password","roles":["ems"]}' "https://localhost:9200/_security/user/ems"
{"created":true}
接下来,我们来配置 Elastic Maps Server 连接到 Elasticsearch。创建一个叫做 elastic-maps-server.yml 的文件:
elastic-maps-server.yml
# Specifies the address to which the Elastic Maps Server server will bind. IP addresses and
# host names are both valid values. The default is the `hostname` of the Docker container.
# host: localhost
# This setting specifies the port the server runs on inside the Docker container. The default
# is 8080. Typically you'll want to expose this port from Docker.
# port: 8080
logging.level: debug
# Required settings for the URL and basic authentication parameters for your Elasticsearch
# cluster for license verification.
elasticsearch.host: 'https://192.168.0.3:9200'
elasticsearch.username: 'ems'
elasticsearch.password: 'password'
# Optional settings that provide the paths to the PEM-format SSL certificate and key files.
# These files are used to verify the identity of Elastic Maps Server to Elasticsearch and
# are required when xpack.security.http.ssl.client_authentication in Elasticsearch is set
# to required.
# elasticsearch.ssl.certificate: /etc/ssl/certs/elasticsearch.crt
# elasticsearch.ssl.key: /etc/ssl/certs/elasticsearch.key
# Optional setting that enables you to specify a path to the PEM file for the certificate
# authority for your Elasticsearch instance.
elasticsearch.ssl.certificateAuthorities: [ /etc/ssl/certs/ca.crt ]
# To disregard the validity of SSL certificates, change this setting's value to 'none'.
#elasticsearch.ssl.verificationMode: full
# Enables SSL and paths to the PEM-format SSL certificate and SSL key files, respectively.
# These settings enable SSL for outgoing requests from the Elastic Maps Server server to
# the browser.
#ssl.enabled: false
#ssl.certificate: /etc/ssl/certs/ems.crt
#ssl.key: /etc/ssl/certs/ems.key
# Location of planet tiles database
#path.planet: /usr/src/app/data/planet.mbtiles
# Logging level for Elastic Maps Server logs
#logging.level: info
# Optional: Should the status and layer preview be enabled? (default: true)
#ui: true
在上面,我们需要注意的是针对如下的项进行配置:
- elasticsearch.host: 'https://localhost:9200'
- elasticsearch.username: 'ems'
- elasticsearch.password: 'password'
- elasticsearch.ssl.certificateAuthorities: [ /etc/ssl/certs/ca.crt ]
我们需要根据自己的配置和证书的位置来进行配置。在我们的当前目录下,创建一个如下的叫做 ems 的目录,并把 ca.crt 拷贝到 ems 目录中:
$ pwd
/Users/liuxg/data/ems
$ tree -L 2
.
├── data
├── elastic-maps-server.yml
├── ems
│ └── ca.crt
└── log
└── elastic-maps-server.log
我们重新以如下的格式来运行 Elastic Maps Server:
docker run --rm --name elastic-maps-server -it \\
--hostname elastic-maps-server \\
-p 8080:8080 \\
-v "${PWD}/elastic-maps-server.yml:/usr/src/app/server/config/elastic-maps-server.yml" \\
-v "${PWD}/ems:/etc/ssl/certs" \\
-v "${PWD}/log:/var/log/elastic-maps-server" \\
docker.elastic.co/elastic-maps-service/elastic-maps-server-ubi8:7.13.0
请注意:在上面,和 localhost:8080 中的 guide 相比,我去掉了在如下的一行:
-v "${PWD}/data:/usr/src/app/data" \\
如果你没有数据在 data 目录中,启动会自动终止。
我们接下来可以下载 tile service database:
上面显示了具体的下载地址。在默认的情况下,如果不下载数据,Elastic Map Server 可以支持放大倍数到8。如果你觉得这个不够,你可以按照上面的链接下载数据,这样地图可以放大到14倍。把下载的数据保存到当前目录的 data 子目录下。当然这个依赖于你的硬盘大小。需要的文件大小为90G。还有你必须具有 Enterprise 授权才可以。你可以到 Kibana 中去启动试用功能:
如果你选择下载地图数据,并已经成功下载,那么请按照如下的命令来重新启动 Elastic Maps Server:
docker run --rm --name elastic-maps-server -it \\
--hostname elastic-maps-server \\
-p 8080:8080 \\
-v "${PWD}/elastic-maps-server.yml:/usr/src/app/server/config/elastic-maps-server.yml" \\
-v "${PWD}/data:/usr/src/app/data" \\
-v "${PWD}/ems:/etc/ssl/certs" \\
-v "${PWD}/log:/var/log/elastic-maps-server" \\
docker.elastic.co/elastic-maps-service/elastic-maps-server-ubi8:7.13.0
在上面,我们添加了 data 目录的挂载。运行后,我们可以看到:
从上面,我们可以看出没有任何的错误。但是我们的 map 的分辨率只能放大到8级,这是因为我们没有下载那 90G 的地图数据。
我们接下来配置 Kibana。我们找到 Kibana 的配置文件 config/kibana.yml。 添加如下的一行:
map.emsUrl: https://elastic-maps-server:8080
针对我的情况,我的 elastic-maps-server 的地址是 localhost:8080:
map.emsUrl: http://localhost:8080
配置完后,我们重新启动 Kibana。我们打开 Maps 应用:
我们发现即使在网路断掉的情况下,我们也可以很顺畅地放大缩小我们的地图。
以上是关于Elasticsearch:Elastic Maps Server 介绍的主要内容,如果未能解决你的问题,请参考以下文章