欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

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

程序员文章站 2023-11-14 16:54:46
一.Exceptionless介绍 Exceptionless专注于.net平台提供实时错误和日志报告。主要包括:错误通知、智能分组异常、详细错误报告堆栈跟踪、支持离线、UI查看重要错误和确定优先级、仪表板上的统计信息和趋势、对异常标记为已修复,监视回归、将事件标记为关键等。 1.1 服务端托管 对 ......

一.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,如下所示:

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

 

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

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

 

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

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

 

  

 

二.项目引用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();
            }

  提交成功如下所示:

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

 

 

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