Exceptionless 本地部署

Posted 2020-08-08

免费开源分布式系统日志收集框架 Exceptionless

前两天看到了这篇文章，亲身体会了下，确实不错，按照官方的文档试了试本地部署，折腾一番后终于成功，记下心得在此，不敢独享。

本地部署官方wiki

• .NET 4.6.1 这个因为我装了VS2015，就没有单独再装了
• Java JDK 1.8+ 安装完后还需配置下Java环境，系统变量添加：JAVA_HOME  对应 C:\\Program Files\\Java\\jdk1.8.0_102 是安装jdk的目录，用户变量Path 中添加 %JAVA_HOME%\\bin; 配置完成后打开cmd，运行

  java -version 如果报错的话有很多种可能，搜索一下会有解决方案，我的就是在C:\\Windows\\System32 目录下把java.exe改名成javaa.exe，再次cmd运行就成功了

• IIS 8+ 这个感觉不是强制的，我win7的IIS 7.5也是可以的
• ElasticSearch 1.7.5 (Elasticsearch 2.x is not yet supported) 到连接地址去下载1.7.5版本，人家已经说明2.x的版本不支持，找这个历史版本得翻好几页，大概在第7页左右，直接给个下载连接：elasticsearch-1.7.5 ，下载完后解压
• 下载最新的latest Exceptionless release artifact ZIP ，下载后解压，将目录中的elasticsearch.yml 复制到到elasticsearch的解压目录中，执行elasticsearch目录中的elasticsearch.bat，看到最后一行有

  started 就说明成功了，打开http://localhost:9200/就能看到相关信息

• 在IIS中新建一个网站，路径选择Exceptionless解压目录中的wwwroot目录，端口这里可以自定义，比如用8004，应用程序池选4.0集成
• 修改web.config中的ElasticSearchConnectionString为es的站点http://localhost:9200，修改<add key="BaseURL" value="http://localhost:8004/#" />，注意后面的"#"
• 修改app.config.*.js中的.constant(‘BASE_URL‘, ‘http://localhost:8004‘)
• 打开http://localhost:8004 就能看到登录页面了，然后创建账户-->创建项目，比如创建一个控制台项目，这里就会提示怎么使用Exceptionless
• ExceptionlessClient.Default.Startup("oXX5BJqhS30ni045BqthqJtiSnpB0naMactfmYmI")，这里的oXX5BJqhS30ni045BqthqJtiSnpB0naMactfmYmI就是api-key
• 新建控制台项目，使用 NuGet  安装

  Install-Package Exceptionless

在Main中写测试代码：

//ExceptionlessClient.Default.Startup("qnN5lVebQ7LA94Erkthtkq5z57xX5Wg7ZzafiMdZ");
            var client = new ExceptionlessClient(c => {
                c.ApiKey = "oXX5BJqhS30ni045BqthqJtiSnpB0naMactfmYmI";
                c.ServerUrl = "http://localhost:8004";
            });
            
            try
            {
                throw new Exception("test exception "+DateTime.Now.ToString("yyyy-MM-dd HH-mm-ss"));
            }
            catch (Exception ex)
            {
                client.SubmitException(ex);
                //ex.ToExceptionless().Submit();
                Console.WriteLine("error send");
            }
            Console.ReadKey();

这里需要注意注释掉的部分，因为是本地部署，所以不能直接用官网的示例，接下来就可以在http://localhost:8004/#/type/error/dashboard中看到异常信息了。