1. 概述编辑
Elasticsearch 是一个分布式、开源的搜索和分析引擎，能够以近实时的方式处理海量数据的存储、检索和分析。
Elasticsearch 凭借其灵活性、扩展性和高性能，逐渐成为日志管理、监控、安全分析等领域的核心工具。
对于运维平台部署的帆软项目，支持对接ElasticSearch组件，替换产品中原有的swift（logdb）作为日志存储，对项目中工程、外接数据库、业务库和其他集群组件的请求进行采集。
本文讲解帆软项目如何对接ElasticSearch，作为日志服务：
用户可自行准备一个ElasticSearch，并进行参数调优
在部署新项目/项目部署好后，可将项目与该日志服务对接
2. 确认帆软项目编辑
2.1 操作日志使用须知
1）对于历史操作日志
在切换 ElasticSearch 作为日志服务后，工程历史 swift（logdb）中存储的操作日志无法自动迁移。
如有备份要求，请在迁移前，使用 平台日志同步到其他数据库插件 ，将历史日志导出到自备的相关数据库中。
2）对于新增操作日志
在切换 ElasticSearch 作为日志服务后，工程无法再通过 数据连接 方式直连 logdb 访问操作日志。
如需查看工程日志，请联系帆软技术支持获取帮助。技术支持联系方式：「服务>在线支持」
2.2 确认帆软应用类型
1）主应用类型
仅 FineBI、FineReport 类型的帆软应用，支持对接 ElasticSearch 作为日志服务。
对于 FineDataLink 类型的帆软应用，仅支持使用 swift（logdb）作为日志存储
2）应用部署方式
仅运维平台部署的项目，支持对接 ElasticSearch 作为日志服务。
对于非运维平台部署的项目，仅支持使用 swift（logdb）作为日志存储
2.3 确认安装插件
帆软项目与ElasticSearch的对接，依赖「logdb的ElasticSearch实现」插件。运维平台部署的项目，默认已安装该插件。
管理员登录帆软应用，点击「管理系统>插件管理>我的插件」，可查看是否正常启用「logdb的ElasticSearch实现」插件。
如已卸载，需要重新安装，插件获取请联系技术支持。技术支持联系方式：「服务平台>在线支持」、电话「400-811-8890」
插件安装方法参照： 插件管理
注：V2.29.0及之后版本的运维平台，对接或部署的帆软项目，内置的「logdb的ElasticSearch实现」插件版本在V1.0.17及以上，支持上传SSL连接证书和查看ElasticSearch接入状态。
3. 准备ElasticSearch编辑
用户需要自行准备并部署ElasticSearch。
帆软不提供相关资料和指导，仅对必要内容进行指明，请查阅相关官网获取其他帮助。
如运维能力不足，推荐使用运维平台部署新项目时，在「日志服务」中勾选「部署ElasticSearch」即可，无需手动部署和调优。
3.1 ElasticSearch要求
| 要求 | 说明 |
|---|---|
| 版本要求 | 对于用户自备的ElasticSearch，仅支持8.X版本 |
| 运行要求 | 部署/对接成功后，请勿暂停ElasticSearch，否则可能会导致项目操作日志丢失 因此建议为ElasticSearch服务配置开机自启动 |
| 防火墙端口 | 请确保帆软项目所在服务器，与ElasticSearch服务所在机器和端口内网互通 |
3.2 ElasticSearch信息
请准备好以下ElasticSearch信息
| 信息 | 说明 |
|---|---|
| 链接地址 | ElasticSearch的访问地址，形如：http://IP:port 默认端口为9200 |
| 用户名 | ElasticSearch用户名 默认用户名为elastic |
| 密码 | ElasticSearch用户的密码 |
| SSL连接证书 | 如ElasticSearch配置了https，可上传证书 证书请自行准备，帆软不提供相关指导 |
4. 项目接入ElasticSearch服务编辑
支持在以下情况下接入 ElasticSearch 作为日志服务，请根据情况自行选择，任选其一即可。
4.1 部署新项目时接入
在「部署新项目-项目设置」时，可接入自备的 ElasticSearch 作为项目日志服务。
1）日志服务选择「对接已有日志服务」。
2）在「日志服务」信息填写处，填写3.2节准备的ElasticSearch信息。
3）点击「测试连接」，提示「测试连接成功」，即代表可正常对接。
4.2 运维平台集群管理接入
项目部署成功后，在运维平台的「集群管理」中，可为项目接入自备的ElasticSearch作为日志服务。
1）管理员登录运维平台，选中指定项目。
2）点击「维护>集群管理」，对「日志服务器」进行配置。
3）填写3.2节准备的ElasticSearch信息。
4）点击「保存」，提示「连接成功」，即代表可正常对接。
5）切换至「组件管理」，重启工程组件，以使ElasticSearch作为文件服务生效。
4.3 管理系统接入
在帆软应用的「管理系统>系统管理>常规」中，可为项目接入自备的ElasticSearch作为日志服务。
1）管理员登录帆软应用，点击「管理系统>系统管理>常规」。
2）在「ElasticSearch连接配置」中，填写3.2节准备的ElasticSearch信息。
3）点击「保存」按钮，等待当前接入状态为「已连接」，即代表ElasticSearch作为文件服务生效。
注1：V2.29.0及之后版本的运维平台，对接或部署的帆软项目，内置的「logdb的ElasticSearch实现」插件版本在V1.0.17及以上，支持上传SSL连接证书和查看ElasticSearch接入状态。
注2：如ElasticSearch配置了https，可上传证书。证书请自行准备，帆软不提供相关指导。
4）前往运维平台，选择指定项目，点击「维护>组件管理」，重启工程组件，以使ElasticSearch作为文件服务生效。
