asp.net core系列 72 Exceptionless使用介绍

一.exceptionless介绍

　　exceptionless专注于.net平台提供实时错误和日志报告。主要包括：错误通知、智能分组异常、详细错误报告堆栈跟踪、支持离线、ui查看重要错误和确定优先级、仪表板上的统计信息和趋势、对异常标记为已修复，监视回归、将事件标记为关键等。

 

　　1.1 服务端托管

 　　　　对于exceptionless有二种部署环境：

　　　　　　a.在exceptionless官网创建帐号，跟着页指导新建应用程序以及项目，官网会生成apikey,将apikey复制拿到net 对应项目中，在项目中安装exceptionless客户端进行使用，日志数据将存储在exceptionless官网。

　　　　　　b.自己搭建exceptionless的服务器环境，数据存储在自己的服务器上。对于a种方案是直接省事，但有很多限制功能(如：不能添加成员)，除非掏钱成会员。所以推荐使用b方案。

 

　　　　5.0版本发布信息:https://github.com/exceptionless/exceptionless/releases

 

　　1.2 自主托管

　　　　在exceptionless5.0版本之前，要进行自主托管需要准备很多环境，生产环境包括.net 4.7，java jdk 1.8+，iis 7.5，powershell 3+等环境。在exceptionless5.新版本中官方已经准备了docker镜像部署很方便。

　　　　自主托管参考：https://github.com/exceptionless/exceptionless/wiki/self-hosting

　　　　环境要求:linux或windows的docker 18.09.0+

　　　　先下载 exceptionless-5.0.0.zip (https://github.com/exceptionless/exceptionless/wiki/self-hosting)，在安装exceptionless自主托管之前，需要先安装好如下:

　　　　　　(1) elasticsearch:5.6.16 (存储与大数据检索)

　　　　　　(2)  kibana:5.6.16(ui展示)

　　　　　　(3)  redis

　　　　然后再修改exceptionless下的docker-compose.yml文件配置，修改里面有关elasticsearch、kibana\redis 地址或端口。在docker终端使用命令：docker-compose up -d在后台运行docker。这是自托管的推荐方法。

 

　　　　安装成功后默认启动 http://localhost:5000  进入exceptionless登录页面，注册用户，添加组织、添加项目、选择项目类型并且记住apikey，如下所示:

 

　　　　下面选择了console and service applications项目类型，并产生了apikey 如下所示:

 

　　　　接着开发成员注册，并邀请到项目中来，如下所示：

 

　　

 

二.项目引用nuget包说明

 

　　　　在.net项目中引用包：

　　　　　　install-package exceptionless -version 4.3.2027

    　　如果是asp.net core，则会引用下面包

　　　　　　install-package exceptionless.aspnetcore 

　　　　exceptionless还可以与nlog集成，下面是nlog引用包：

　　　　　　install-package exceptionless.nlog -version 4.3.2027

　　　　exceptionless集成了nlog资料：https://github.com/exceptionless/exceptionless.net/blob/master/samples/exceptionless.sampleconsole/program.cs

 

三.项目集成

　　下面控制台程序引用nuget包：

　　　　install-package exceptionless -version 4.3.2027

　　　　using exceptionless;

 　　//main方法中设置
  　　 exceptionless.exceptionlessclient.default.configuration.serverurl = "http://localhost:5000";          
　　　　exceptionless.exceptionlessclient.default.startup("ae3kwemn8qmbe5esmgbi5j8phlnftgkezbazjcqo");

　　//异常测试提交
 　　　　try
            {
                throw new exception("测试异常");
            }
            catch (exception ex)
            {
                ex.toexceptionless().submit();
            }

　　提交成功如下所示：

 

 

　　更多使用参考:  https://github.com/exceptionless/exceptionless/wiki