SOFALookout 服务端快速开始
1.使用本机 ES 服务
- 1)本地启动 ES
docker run -d --name es -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" elasticsearch:5.6
版本:V5,V6
- 2)检查 ES 是否健康
http://localhost:9200/_cat/health?v
- 3)启动 Lookout 服务
执行 all-in-one-bootstrap 编译后的 fat-jar 包,如何获得,见文末备注部分:
java -Dcom.alipay.sofa.ark.master.biz=lookoutall -jar lookout-all-in-one-bootstrap-1.6.0-executable-ark.jar
注意
-Dcom.alipay.sofa.ark.master.biz=lookoutall
是必须的, 用于设置 sofa-ark 的 master biz。4)最后进行功能验证
查询 (Gateway)的 metrics 作为功能验证,访问“localhost:9090”,在查询框输入:
jvm.memory.heap.used{app="gateway"}
最后,也可以使用 grafana
2.使用远程 ES 服务
总体步骤和“使用本机 ES 服务”类似,唯一不同的是,需要指定配置文件。
java -Dcom.alipay.sofa.ark.master.biz=lookoutall -Dlookoutall.config-file=abc.properties \
-jar lookout-all-in-one-bootstrap-1.6.0-executable-ark.jar
-Dlookoutall.config-file
(如果你本地启动 ES 测试的话则该配置项可以忽略!),该配置项制定的文件暂时只能引用文件系统上的 properties 文件(没有像 spring-boot 支持那么丰富),配置项必须以应用名开头,从而提供隔离能力。
例如:在fat-jar同目录下创建一个abc.properties
配置文件, 用于存放存放配置文件(下面列出了必须的配置项,用于指向使用的 ES 服务地址):
gateway.metrics.exporter.es.host=localhost
gateway.metrics.exporter.es.port=9200
metrics-server.spring.data.jest.uri=http://localhost:9200
备注
如何获得 all-in-one-bootstrap 编译后的 fat-jar。
方式1:本地编译
./boot/all-in-one-bootstrap/build.sh
打包结果在
boot/all-in-one-bootstrap/target/allinone-executable.jar
方式2:发布报告中附件获取
临时方式(针对 1.6.0)暂时提供一个 v1.6.0的snapshot包,下载后(保证ES服务已经单独启动)运行:
java -Dcom.alipay.sofa.ark.master.biz=lookoutall -jar lookout-all-1.6.0.snapshot.jar
方式3:使用docker镜像
服务端默认会连接到 localhost:9200
的ES实例, 而我所用的开发机器是MacOS,无法使用 --net=host
模式启动容器,因此在容器内无法通过 localhost:9200
连接ES,需要使用如下方式绕过去:
编辑一个配置文件,比如 foo.properties
:
gateway.metrics.exporter.es.host=es
metrics-server.spring.data.jest.uri=http://es:9200
在 foo.properties
所在的目录下运行 all-in-one 镜像:
docker run -it \
--name allinone \
--link es:es \
-p 7200:7200 \
-p 9090:9090 \
-v $PWD/foo.properties:/home/admin/deploy/foo.properties \
-e JAVA_OPTS="-Dlookoutall.config-file=/home/admin/deploy/foo.properties" \
-e JAVA_OPTS="...定制JVM系统属性..." \
xzchaoo/lookout-allinone:1.6.0-SNAPSHOT
这里利用了docker的–link参数使得应用可以访问到ES实例 这里做测试用,所以不用-d参数在后台运行