分布式日志框架Exceptionless之生产环境部署步骤

Param(
  [string]$Version = "5.5.2",
  [int]$NodeCount = 2,
  [bool]$StartKibana = $false,
  [int]$StartPort = 9200,
  [bool]$OpenKibana = $true,
  [bool]$ResetData = $false
)

(function () {
  'use strict';
angular.module('app.config', [])

.constant('BASE_URL', 'http://192.168.16.150')

.constant('EXCEPTIONLESS_API_KEY')

.constant('FACEBOOK_APPID')

.constant('GITHUB_APPID')

.constant('GOOGLE_APPID')

.constant('INTERCOM_APPID')

.constant('LIVE_APPID')

.constant('SLACK_APPID')

.constant('STRIPE_PUBLISHABLE_KEY')

.constant('SYSTEM_NOTIFICATION_MESSAGE')

.constant('USE_HTML5_MODE', false)

.constant('USE_SSL', false);

}());

<connectionStrings>

<!-- 如果开启了Redis缓冲 -->

<add name="RedisConnectionString" connectionString="192.168.16.151:6379,abortConnect=false" />

<!-- ElasticSearch的访问地址 -->

<add name="ElasticSearchConnectionString" connectionString="http://192.168.16.150" />

<add name="LdapConnectionString" connectionString="" />

</connectionStrings>

  <appSettings>

<!-- Base url for the ui used to build links in emails and other places. -->

<add key="BaseURL" value="http://192.168.16.150/#" />

<!-- Controls whether SSL is required. Only enable this if you have SSL configured. -->

<add key="EnableSSL" value="false" />

<!--

Dev: Use this mode when debugging. (Outbound emails will not be sent)

QA: Use this mode when deployed to staging. (Outbound emails restricted)

Production: Use this mode when deployed to production.

-->

<add key="WebsiteMode" value="Production" />

<!-- Controls whether users can signup. -->

<add key="EnableAccountCreation" value="true" />

<!-- Controls whether daily summary emails are sent -->

<add key="EnableDailySummary" value="true" />

......

</appSettings>

    <add key="SmtpHost" value="smtp.exmail.qq.com" />

<add key="SmtpPort" value="465" />

<add key="SmtpEncryption" value="SSL" />

<add key="SmtpFrom" value="edisonchou@companyname.com" />

<add key="SmtpUser" value="edisonchou@companyname.com" />

<add key="SmtpPassword" value="your-password" />

    <!-- 异常数据-默认存储在文件夹storage中 -->

<add key="StorageFolder" value="|DataDirectory|\storage" />

<!-- 在当前Web网站进程中运行Jobs -->

<add key="RunJobsInProcess" value="true" />

<add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />

<!-- 保留日志天数 -->

<add key="MaximumRetentionDays" value="90" />

<!-- 分片数量 -->

<add key="ElasticSearchNumberOfShards" value="3" />

<!-- 复制分片数量 -->

<add key="ElasticSearchNumberOfReplicas" value="1" />

    public static class ExceptionlessBuilderExtensions
    {
        public static IApplicationBuilder UseExceptionless(this IApplicationBuilder app, IConfiguration configuration)
        {
            var isEnableLogger = Convert.ToBoolean(configuration["Exceptionless:Enabled"] ?? "false");
            if (isEnableLogger)
            {
                // 封装使用Exceptionless分布式日志组件
                ExceptionlessClient.Default.Configuration.ApiKey = configuration["Exceptionless:ApiKey"];
                ExceptionlessClient.Default.Configuration.ServerUrl = configuration["Exceptionless:ServerUrl"];
                ExceptionlessClient.Default.SubmittingEvent += OnSubmittingEvent;
                app.UseExceptionless();
            }
        return app;
    }

    private static void OnSubmittingEvent(object sender, EventSubmittingEventArgs e)
    {
        // 只处理未处理的异常
        //if (!e.IsUnhandledError)
        //{
        //    return;
        //}

        // 忽略404错误
        if (e.Event.IsNotFound())
        {
            e.Cancel = true;
            return;
        }

        // 忽略没有错误体的错误
        var error = e.Event.GetError();
        if (error == null)
        {
            return;
        }

        // 忽略 401 (Unauthorized) 和 请求验证的错误.
        if (error.Code == "401" || error.Type == "System.Web.HttpRequestValidationException")
        {
            e.Cancel = true;
            return;
        }

        // Ignore any exceptions that were not thrown by our code.
        //var handledNamespaces = new List<string> { "Exceptionless" };
        //if (!error.StackTrace.Select(s => s.DeclaringNamespace).Distinct().Any(ns => handledNamespaces.Any(ns.Contains)))
        //{
        //    e.Cancel = true;
        //    return;
        //}

        // 添加附加信息.
        //e.Event.Tags.Add("EDC.Core");
        //e.Event.MarkAsCritical();
    }
}</code></pre></div></div><p>　　其他配置和用法，请参考我的这一篇《基于Exceptionless实现分布式日志》来使用。</p><p>　　下面是配置好后的Web控制台：</p><figure class=""><div class="rno-markdown-img-url" style="text-align:center"><div class="rno-markdown-img-url-inner" style="width:100%"><div style="width:100%"><img src="https://cdn.static.attains.cn/app/developer-bbs/upload/1723240808994702308.png" /></div></div></div></figure><p>　　如果需要获得邮件通知及发送邮件到注册用户进行验证：</p><figure class=""><div class="rno-markdown-img-url" style="text-align:center"><div class="rno-markdown-img-url-inner" style="width:100%"><div style="width:100%"><img src="https://cdn.static.attains.cn/app/developer-bbs/upload/1723240809353225653.png" /></div></div></div></figure><p>　　如果要获得每日的项目报告，请记得将Web.config中EnableDailySummary设为true。个人觉得邮件通知critical errors的功能很实用，再多的notification就是骚扰了。因此，我只勾选了一个critical errors。此外，要启用邮件通知，请先通过注册发送给你的email进行账户验证（如下图所示），否则无法启用邮件通知。</p><figure class=""><div class="rno-markdown-img-url" style="text-align:center"><div class="rno-markdown-img-url-inner" style="width:100%"><div style="width:100%"><img src="https://cdn.static.attains.cn/app/developer-bbs/upload/1723240809634042626.png" /></div></div></div></figure><p>　　Then, enjoy your bug exceptions :</p><figure class=""><div class="rno-markdown-img-url" style="text-align:center"><div class="rno-markdown-img-url-inner" style="width:100%"><div style="width:100%"><img src="https://cdn.static.attains.cn/app/developer-bbs/upload/1723240809798995775.png" /></div></div></div></figure><h2 id="71ajm" name="%E4%BA%94%E3%80%81%E4%B8%80%E4%BA%9B%E5%85%B6%E4%BB%96%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9">五、一些其他注意事项</h2><p>　　这里可以参考园友 花儿笑弯了腰 的这篇《Self Host 使用 Exceptionless 实时监控程序运行日志服务》，他讲述了一些QA，也许会有你也遇到的坑：</p><figure class=""><div class="rno-markdown-img-url" style="text-align:center"><div class="rno-markdown-img-url-inner" style="width:100%"><div style="width:100%"><img src="https://cdn.static.attains.cn/app/developer-bbs/upload/1723240810060135893.png" /></div></div></div></figure><h2 id="836aj" name="%E5%8F%82%E8%80%83%E8%B5%84%E6%96%99">参考资料</h2><p>Exceptionless GitHub</p><p>Exceptionless Self-Host Document</p><p>uptothesky，《Exceptionless本地部署》</p><p>uptothesky，《Exceptionless邮箱配置》</p><p>akaxb，《Exceptionless本地部署小结》</p><p>依乐祝，《Exceptionless安装配置及简单实用》</p><p>花儿笑弯了腰，《Self Host 使用 Exceptionless 实时监控程序运行日志服务》</p>