异常日志框架Exceptionless结合.NET Core(本地部署)

一、前言

1、分布式异常日志收集框架Exceptionless是开源的工具，根据官方给出的说明： Exceptionless可以为您的ASP.NET、Web API、WebFrm、WPF、控制台和MVC应用程序提供实时错误、特性和日志报告。它将收集的信息组织成简单的可操作的数据，这些数据将帮助你很方便的查看异常信息。

2、Exceptionless提供两种使用方式，一种是官网创建账号；一种是自己搭建本地项目。官网上创建账号的操作方式可以参考github上的官方wiki。此处主要介绍本地部署。

阅读目录

前言
环境要求
部署Exceptionless
.NET Core结合Exceptionless
总结

二、环境要求

根据Exceptionless 给出的环境要求如下：

测试环境：

操作系统windows
.NET 4.6.1
JAVA JDK1.8+
IIS Express 7.5+（win7以上系统都没有问题）
Elasticsearch 5.x

生产环境：

操作系统windows或Linux
.NET 4.7
JAVA JDK1.8+
IIS Express 7.5+（win7以上系统都没有问题）
Elasticsearch 5.x（部署在Linux上(强烈建议)，并且是多节点运行）
Redis 3.0+（可选，部署在Linux上(强烈建议)）

三、部署Exceptionless

1、配置JAVA JDK 1.8

说明：为什么需要安装JAVA JDK呢？由于es需要依赖此环境。

第一步：从官网上下载JDK windows 包

地址：https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

第二步：安装JDK后配置windows环境变量

设置系统变量添加java jdk的安装目录。

在用户变量中添加 JAVA_HOME的系统变量路径。

配置结束。查看JAVA是否安装成功。提示如下：即代表安装成功。

2、部署Exceptionless

Exceptionless 下载地址：https://github.com/exceptionless/Exceptionless/releases

下载后解压出来：把wwwroot部署在IIS上

此处项目的端口可自己配置，默认是50000。

如需自己配置需要修改一下几个地方：

第一：修改web.config 中的BaseURL 中的端口。

第二：修改app.config.*.js文件中的 BASE_URL 端口。

第三：IIS上端口需要设置为自己的端口。

3、一键安装 es

双击打开 Start.bat,这将自动启动Elasticsearch，IIS Express和默认浏览器到Exceptionless登录页面。

注：如果出现错误，请确保java 环境安装完成。

安装结束当前目录下会出现es和kibana，以及自动打开 Exceptionless 项目

4、注册本地账号Exceptionless

第一步：注册账号

第二步：注册完后即可进入到主页面。创建一个组织和项目名（每个项目都有对应唯一的apikey）

第三步：选择项目多对应的类型。选择完后会出现对应的安装提示。

四、.NET Core结合Exceptionless

1、新建一个.NET Core项目

引入nuget包：

2、配置appsettings.json

此处的ApiKey在 Exceptionless中所创建项目获取，正是根据这个我们才能把项目匹配到exceptionless中

"Exceptionless": {
    "ApiKey": "aW6nxAsLNE5JcFthRbjbh5Ot2iFk4MgrcZtC35Ut",
    "ServerUrl": "http://localhost:50000"
  }

3、配置Startup.cs

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            ExceptionlessClient.Default.Configuration.ApiKey = Configuration.GetSection("Exceptionless:ApiKey").Value;
            ExceptionlessClient.Default.Configuration.ServerUrl = Configuration.GetSection("Exceptionless:ServerUrl").Value;
            app.UseExceptionless();

            app.UseMvc();
        }

4、Controller 控制器添加测试代码异常

[Route("api/[controller]")]
    public class ValuesController : Controller
    {
        [HttpGet]
        public ActionResult Get()
        {
            try
            {
                throw new Exception("LouieGuo测试项目的异常");
            }
            catch (Exception ex)
            {
                ex.ToExceptionless().Submit(); //这个很重要
            }
            return Ok();
        }
    }