分布式日志框架之ExceptionLess：自行搭建帮助文档翻译

Posted 2021-01-28 supersnowyao

原文地址：https://github.com/exceptionless/Exceptionless/wiki/Self-Hosting

ExceptionLess自行托管环境搭建

一、测试环境

---

 如果你想在本地测试ExceptionLess，请遵循本节如下步骤。但是，请注意！以下事项仅用于测试环境，而不是用于生产环境。

1、基本配置

1）.Net 4.6.1

2）Java JDK 1.8+

3）操作系统是Windows环境时，需要配置JAVA_HOME环境变量，参考资料 

4）IIS Express 8+

5）PowerShell 3+ 版本建议在3.0及以上

6）通过管理员身份打开命令提示符，确保PowerShell执行Set-ExecutionPolicy Unrestricted

2、搭建说明

执行以下步骤：

1）确保满足以上所有要求；

2）将最新ExceptionLess发布压缩包下载到本机；

3）解压缩文件； 

4）解压完后，执行当前目录下的Start.bat文件，然后会自动下载ElasticSearch、Kibana资源。下载完毕后，会自动启动ElasticSearch、IIS Express以及默认浏览器登录到ExceptionLess系统登录页面；

执行完后，现在可以创建一个本地帐户、所属组织和项目。然后创建项目，模拟发送错误信息给它，以便进行本地测试。

 

二、产品环境

---

 在生产环境中，请遵循以下步骤配置ExceptionLess。

1、基本配置

强烈建议在Linux上运行ElasticSearch，至少配置三个节点，其中两个点是主节点。因为Linux版本比Windows版本的性能要好。

1）.NET 4.7

2）IIS 7.5+

3）ElasticSearch 5.6，ExceptionLess的GitHub站点也有相应的安装说明

2、搭建说明

1）确保满足以上所有要求；

2）将最新ExceptionLess发布压缩包下载到本机；

3）解压缩文件；

4）在相当的目录中，如果日志子目录不存在，则创建日志子目录。确保App_Data和Logs目录是IIS用户可写的。可右键->属性->“安全”页签->编辑->选择IIS_IUSRS，然后选择“全部控制”复选框；

5）安装ElasticSearch，ExceptionLess的GitHub站点也有相应的安装说明；

6）设置IIS，启用ASP>NET 4.6和静态内容特性，建立一个新的站点指向wwwroot文件夹，该文件夹可以在解压缩的目录中找到；

7）更新Web.Config文件：

　　a）ElasticSearchConnectionString应该指向ElasticSearch服务器；

　　b）将<appSettings>节点添加到Web.Config配置文件中，它控制每个索引应该使用多少分片和副本。对于单个节点设置，这些值应该分别设置为1和0.对于推荐的ElasticSearch集群（3个节点，2个master），建议值为3和1；

<add key="ElasticSearchNumberOfShards" value="..." />
<add key="ElasticSearchNumberOfReplicas" value="..." />

　　c）BaseURL应该设置为网站的外部Url，若没有采用下面可选部分的CleanUrls内容，请确保将hashbang(/#!)添加到BaseURL；

　　d）如果安装了SSL证书（推荐），EnableSSL应该设置为true。如果你的域没有自签名证书，可以在IIS管理器中创建自签名证书，方法是选择当前服务器，然后在右侧双击服务器证书，然后单击出现在右侧空格上的“创建自签名证书”；

　　e）如果想发送不受限制的电子邮件，应该将WebsiteMode设置为Production；

　　f）配置你想配置的其他属性（如：邮件设置），出现在Settings.cs中的任何属性均可以在这里配置；

8）更新App.config.*.js文件：

　　a）BaseURL应该设置为网站的外部Url，此值不应该附加hashbang(/#!)，即使它是在服务器配置中附加的；

　　b）USE_SSL应该与app.config中的EnableSSL设置相同的值；

　　c）注意：如果在ExceptionLess加载页面后更改配置文件，则需要进行重新加载；

9）配置系统，然后发送错误到站点；

　　现在，你可以创建一个本地帐户、所属组织和项目，并向其发送错误信息了。