abp vnext 微服务-Exceptionless 日志收集框架本地环境搭建
内容提要
该文章介绍了如何搭建Exceptionless的本地和服务器环境。首先,需要满足系统环境要求,包括.NET 4.6.1和Java Sdk1.8+。然后,下载并解压ElasticSearch 5.1,并启动elasticsearch环境。接下来,下载最新的Exceptionless代码,解压后点击Start.bat进行本地部署。最后,通过在IIS中添加网站并修改配置文件,将Exceptionless部署到服务器上。
延伸解读
自建服务端的动机与前提
文章指出Exceptionless线上免费版存在限制,因此建议自建服务端以解除限制并提升安全性。但自建并非零成本:需要准备.NET 4.6.1、Java SDK 1.8+,并额外部署ElasticSearch 5.1作为强制依赖。这意味着在搭建日志收集系统前,需先评估服务器资源与运维负担,尤其是ElasticSearch的安装与启动管理。
ElasticSearch的启动与常驻管理
ElasticSearch需通过bin目录下的elasticsearch.bat启动,但每次手动运行不便。文章建议将其注册为Windows服务并设为自启动,同时提供了Install、Remove、Start、Stop、Manager等命令。这能避免因忘记启动导致日志收集中断,也便于后续服务管理。对于生产环境,这种常驻化处理是保证日志链路稳定的基础步骤。
本地部署与服务器部署的关键差异
本地部署只需运行Start.bat即可完成,适合快速验证。但服务器部署需通过IIS添加网站,并修改Web.config中的BaseURL和ElasticSearchConnectionString,以及app.config.*.js中的BASE_URL。这些配置必须指向实际服务器地址,否则日志无法正确写入。文章提醒,本地localhost地址无法被服务器访问,因此部署到IIS是必要环节。
Q&A
为什么建议自己搭建Exceptionless服务端而不是用线上免费版?
Exceptionless线上版本免费是有限制的,自己搭建服务端使用起来没有限制,而且也更安全。
搭建Exceptionless需要满足哪些系统环境要求?
需要.NET 4.6.1(如果已安装过VS可忽略),以及Java SDK 1.8+并配置好Java环境变量。此外还需要下载ElasticSearch 5.1,它是框架强制依赖的环境。
如何启动ElasticSearch并设置为Windows服务?
下载解压ElasticSearch 5.1后,进入bin目录运行elasticsearch.bat即可启动。若想创建Windows服务,在bin目录下执行Elasticsearch-Service.bat install,然后在系统服务中将其设置为自启动即可。
本地部署Exceptionless的步骤是什么?
从GitHub下载最新的Exceptionless代码,解压后点击Start.bat运行,如果出现成功提示即部署成功,之后可进行本地测试。
在IIS上部署Exceptionless需要修改哪些配置文件?
需要修改两个文件:一是wwwroot目录下的Web.config,修改BaseURL为添加网站的地址,ElasticSearchConnectionString为ElasticSearch服务器地址;二是wwwroot目录下的app.config.*.js,修改BASE_URL为添加网站的地址。
Elasticsearch-Service.bat支持哪些命令?
支持的命令有:Install(安装服务)、Remove(删除已安装的服务,如果启动则停止)、Start(启动服务)、Stop(停止服务)、Manager(启动GUI管理已安装的服务)。