1.安装ExceptionLess
在ExceptionLess官网提供了基于Docker的私有化部署方式,我们可以按照官网的方式进行测试环境的安装。
- 在官网github中下载最新的release包,地址:https://github.com/exceptionless/Exceptionless/releases
- 解压缩,然后进入解压缩的目录,执行
docker-compose up -d
命令在后台启动多个容器,当执行完成后,Exceptionless已经在本地运行起来了。我们可以在Kitematic中查看运行中的容器 - 按照官网的说明,5000端口是登陆页面,但实际情况是5000是API,5100才是登陆页面,因此我们打开http://localhost:5100进入登陆页面。注意:此处可能跟版本有关,在使用时查看docker的端口映射。
通过以上步骤,就在本地搭建好了测试环境。我们可以看到启动的总共启动了6个容器,分别是redis、elasticsearch、kibana、Exceptionless Job、Exceptionless Api、Excetpionless UI。
2.快速上手
搭建好测试环境后,首先访问Exceptionless UI来创建用户、组织和项目。然后,当项目创建完成之后,Exceptionless 会跳转到客户端配置页面,来指引我们如何使用Exceptionless客户端。我们可以选择自己需要用到的客户端,通过页面的指引完成客户端配置。
引导页面如下:
按照这种方式我们可以完成.Net平台项目、JS项目的配置。
日志配置:Nlog
<extensions>
<!--添加扩展Exceptionless程序集-->
<add assembly="Exceptionless.NLog"/>
</extensions>
<targets>
<!--上报Exceptionless-->
<!--xsi:type:固定是Exceptionless-->
<!--apiKey:即我们在Exceptionless中添加完项目后得到的apiKey-->
<!--serverUrl:Exceptionless的地址-->
<target xsi:type="Exceptionless" name="Exceptionless" apiKey="VIICRAsuE53uf7OBJbi2TX28s7RXmB0HzbiQkU1s"
serverUrl="https://logapi.ertuidian.com/">
<!--堆栈信息-->
<field name="StackTrace" layout="${stacktrace}"/>
<!--Message信息-->
<field name="Message" layout="${message}"/>
<field name="LogLevel" layout="${level}"/>
<field name="CreateDate" layout="${date}"/>
<!--物理名称-->
<field name="MachineName" layout="${machinename}" />
<!--线程ID-->
<field name="ThreadId" layout="${threadid}"/>
<!--发生源-->
<field name="CallSite" layout="${callsite}"/>
<field name="AppdomainVersion" layout="${assembly-version}"/>
<field name="Appdomain" layout="${appdomain}"/>?
</target>
log4Net
首先添加程序集的支持:
Install-Package Exceptionless.Log4net
然后在log4net的配置文件中进行配置(代码来源于官网):
<log4net>
<appender name="exceptionless" type="Exceptionless.Log4net.ExceptionlessAppender,Exceptionless.Log4net">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%-4timestamp [%thread] %-5level %logger %ndc - %message%newline"/>
</layout>
</appender>
<root>
<level value="DEBUG"/>
<appender-ref ref="exceptionless"/>
</root>
</log4net>