.NET Core微服务之基于Exceptionless实现分布式日志记录

一、Exceptionless极简介绍

640?wx_fmt=png

  Exceptionless 是一个开源的实时的日志收集框架,它可以应用在基于 ASP.NET,ASP.NET Core,Web API,Web Forms,WPF,Console,ASP.NET MVC 等技术开发的应用程序中,并且提供了REST接口可以应用在 Javascript,Node.js 中。它将日志收集变得简单易用并且不需要了解太多的相关技术细节及配置,对于微服务架构的应用程序来说,统一的日志收集系统的建立更是有必要。

二、Quick Start

2.1 官方创建一个账号

  640?wx_fmt=png

2.2 创建项目

  640?wx_fmt=png

2.3 得到ApiKey

  640?wx_fmt=png

2.4 安装Exceptionless.AspNetCore并进行配置

NuGet>Install-Package Exceptionless.AspNetCore  

  *.目前最新版本是4.3.2004

  在你要进行Logging的项目(MVC,WebAPI等)中注册APIKey,这里以ASP.NET Core WebAPI项目为例:


    public void Configure(IApplicationBuilder app, IHostingEnvironment env, IApplicationLifetime lifetime){......app.UseMvc();        // exceptionlessapp.UseExceptionless(Configuration["Exceptionless:ApiKey"]);        // swagger        ......}

  这里我将ApiKey配置到了json配置文件中:

  "Exceptionless": {   
 
"ApiKey": "Your Api Key from Exceptionless server"}

2.5 简单地封装一个ExceptionlessLogger

  (1)自定义一个ILogger接口

    public interface ILogger{        
           
void Trace(string message, params string[] args);    
          
void Debug(string message, params string[] args);    
           
void Info(string message, params string[] args);    
           
void Warn(string message, params string[] args);  
         
void Error(string message, params string[] args);}


  (2)实现ILogger接口:ExceptionlessLogger


    public class ExceptionLessLogger : ILogger{      
      
/// <summary>/// Trace        
       
/// </summary>public void Trace(string message, params string[] tags){ExceptionlessClient.Default.CreateLog(message, LogLevel.Trace).AddTags(tags).Submit();}        /// <summary>/// Debug        /// </summary>public void Debug(string message, params string[] tags){ExceptionlessClient.Default.CreateLog(message, LogLevel.Debug).AddTags(tags).Submit();}        /// <summary>/// Info        /// </summary>public void Info(string message, params string[] tags){ExceptionlessClient.Default.CreateLog(message, LogLevel.Info).AddTags(tags).Submit();}        /// <summary>/// Warn        /// </summary>public void Warn(string message, params string[] tags){ExceptionlessClient.Default.CreateLog(message, LogLevel.Warn).AddTags(tags).Submit();}        /// <summary>/// Error        /// </summary>public void Error(string message, params string[] tags){ExceptionlessClient.Default.CreateLog(message, LogLevel.Error).AddTags(tags).Submit();}}


2.6 注入ExceptionlessLogger

    public IServiceProvider ConfigureServices(IServiceCollection services){        // IoC - Loggerservices.AddSingleton<ILogger, ExceptionLessLogger>();......}

2.7 在你想要Logging的地方调用

  比如我们要记录一个User登录的日志:

    public class LoginController : Controller{    
    
public ILogger Logger { get; }    

        
public LoginController(ILogger logger){Logger = logger;}[HttpGet("{id}")]      
          
public string Get(int id){Logger.Info($"User {id} Login Successfully. Time:{DateTime.Now.ToString()}", "Tag1", "Tag2");    
       
return "Login Success.";}}


  测试结果:

  640?wx_fmt=png

2.8 记录你程序中的各种Exception

  这里模拟一个空指针的异常,这里借助Exceptionless针对Exception类的扩展方法去进行写异常信息。


    [HttpGet]   
   
public string Get(){      
          
try{        
string str = null;str.ToString();}      
          
catch (Exception ex){ex.ToExceptionless().Submit();}        return "Unknown Error!";}


  测试结果:

  640?wx_fmt=png

2.9 Check你的日志与异常记录

  (1)Check 日志

  在Log Messages 或 AllEvents菜单中选择Dashboard,即可看到当前项目所有的Log Message了。(如果选择的是AllEvents,可能还会包含其他类型的信息,比如Exception)

  640?wx_fmt=png

  在最近的Log中可以看到我们刚刚的测试中记录的一跳日志:

  640?wx_fmt=png

  点击超链接,即可进入详细页面:

  Overview:可以看到一些项目和日志的基本信息,比如Event Type,Level以及标签Tags

  640?wx_fmt=png

  Environment:可以看到记录日志所在的项目所处的一些软硬件环境信息

  640?wx_fmt=png

  下面是一些额外的信息,比如Framework Version以及Runtime Framework

  640?wx_fmt=png

  通过对这些日志的查看和分析,我们可以方便地在一个地方对所有服务中的日志进行查看和分析。But,在线版本对项目和日志数量有限制,建议在生产环境使用本地部署版本,它是开源的。

  (2)Check 异常

  在Exception菜单下选择Dashboard:

  640?wx_fmt=png

  在最近的异常信息中找到刚刚记录的:

  640?wx_fmt=png

  同样,通过超链接查看详细信息:

  Overview:可以看到这个异常的基本信息,比如Error Type以及Stack Trace,这些都是可以帮准我们快速定位错误的信息

  640?wx_fmt=png

  Exception:如果基本信息不够,那就查看详情,你可能需要看看加载了哪些Modules

  640?wx_fmt=png

  最后是Environment,跟Log的Environment差不多,这里就不再贴图了。

三、本地部署

  我们说到Exceptionless是一款强大的开源框架,那么我们可以下载下来根据需要进行独立部署,可以不受一些用户、项目、Event数量的限制。这里我暂时不会去做其独立部署的实践,但是园子里已经有很多的独立部署实践的分享了,有兴趣的朋友可以看看下面几篇:

  花儿笑弯了腰,《Self Host 使用Exceptionless实时监控程序运行日志服务》

  罗曼缇克,《.Net 开源异常日志ExceptionLess搭建》

  平凡网客,《Exceptionless 本地部署》

  当然,官方的独立部署Wiki也是一个绝佳的参考资料:https://github.com/exceptionless/Exceptionless/wiki/Self-Hosting

  以下是测试环境的要求:

  640?wx_fmt=png

  以下是Production环境的要求,我们可以看到在Production环境中,强烈推荐使用ELK的ElasticSearch,如果有不知道ELK的朋友也可以百度/Google一下,ELK也是我后续的学习计划。

  640?wx_fmt=png

四、小结

  本篇主要简单的介绍了一下开源的分布式日志框架Exceptionless,并通过两个小例子介绍了如何快速的在ASP.NET Core中进行使用,最后通过在Exceptionless平台中Check我们在程序中记录的日志/异常信息了解Exceptionless的强大。此外,通过引入园友和官方的Wiki文档介绍了Exceptionless的另一种使用模式:本地部署,有兴趣的朋友可以去看看,这里我就不再去实践了(对我现阶段而言,去做独立部署的优先级不高)。本篇没有过多的语言介绍,更多的是贴code以及贴图片,因此不能算是很好的介绍文章,不过结合列出的参考资料应该可以对Exceptionless做个快速入门  

  一些朋友问我后续的分享计划,这里小小透漏一下:Ocelot+IdentityServer的结合做统一验证和授权,Ocelot+Butterfly的结合(目前Ocelot已集成Butterfly)做分布式追踪,基于AppMetrics+InfluxDB+Grafana的性能监控,数据一致性(可能会使用几个EventBus框架)初探,基于Apollo做配置中心,ASP.NET Core on Docker与K8S结合等等。等到POC初步研究后,可能还会去看看微软的微服务架构官方高级版大Demo-eShopOnContainers(微软有一本pdf大家可以去下载,点我下载)。这些计划可能需要花费我很多时间,不过我相信这样的学习和实践是值得的,也是值得分享的,如果你也有这样的计划,那就一起加油吧!

    640?wx_fmt=png

参考资料

Exceptionless Github:https://github.com/exceptionless/Exceptionless

savorboard(杨晓东),《免费开源分布式系统日志收集框架 Exceptionless》

编程梦,《ExceptionLess新玩法 — 记日志》

编程梦,《ExceptionLess新玩法 -- 审计日志》

花儿笑弯了腰,《Self Host 使用Exceptionless实时监控程序运行日志服务》

罗曼缇克,《.Net 开源异常日志ExceptionLess搭建》

平凡网客,《Exceptionless 本地部署》

原文地址:

https://www.cnblogs.com/edisonchou/p/exceptionless_foundation_and_quick_start.html

.NET社区新闻,深度好文,欢迎访问公众号文章汇总 http://www.csharpkit.com

640?wx_fmt=jpeg

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/320984.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

P2801-教主的魔法【分块,二分】

正题 题目链接:https://www.luogu.com.cn/problem/P2801 题目大意 nnn个数字&#xff0c;要求支持 区间加上一个数字www询问一个区间内不小于www的数的个数 解题思路 考虑分块&#xff0c;对于块内我们维护一个排序后的数组&#xff0c;查询时直接在整个块中二分答案即可。修…

【多重背包】太空电梯(jzoj 1286)

太空电梯 题目大意&#xff1a; 有n&#xff08;1<n<400&#xff09;种石头&#xff0c;每种石头有它的数量c&#xff08;1<c<10&#xff09;&#xff0c;高度h&#xff08;1<h<100&#xff09;&#xff0c;可搭到的最高高度a&#xff08;1<a<40000&…

P2522 HAOI2011 Problem b [莫比乌斯反演,数论分块]

P2522 HAOI2011 题意 对于给出的n个询问&#xff0c;每次求有多少个数对(x,y)(x,y)(x,y)&#xff0c;满足a≤x≤ba≤x≤ba≤x≤b&#xff0c;c≤y≤dc≤y≤dc≤y≤d&#xff0c;且gcd(x,y)kgcd(x,y) kgcd(x,y)k&#xff0c;gcd(x,y)gcd(x,y)gcd(x,y)函数为xxx和yyy的最大公约…

.netcore 整合 log4net

1.背景前两天&#xff0c;曾经的一个同事咨询我&#xff0c;怎样将log4net以中间件的形式整合到core里边去。我不假思索的回答&#xff0c;这种问题应该有人做过吧&#xff0c;他说没有。于是&#xff0c;我去博客园搜了下&#xff0c;发现还真没有&#xff0c;全部都是传统.NE…

P5459-[BJOI2016]回转寿司【树状数组】

正题 题目链接:https://www.luogu.com.cn/problem/P5459 题目大意 nnn个数&#xff0c;求有多少个区间和在[L,R][L,R][L,R]范围内。 解题思路 显然我们做了前缀和之后&#xff0c;枚举右端点就只需要找到有多少个左端点满足在[x−R,x−L][x-R,x-L][x−R,x−L]这个范围内就好了…

【暴力】穹妹的求助

穹妹的求助 题目大意&#xff1a; 输入两个数&#xff0c;输出这两个数之间因数最多的数&#xff0c;和这个数的的因数个数 原题&#xff1a; 题目描述 由于穹妹很聪明&#xff0c;她的数学老师给她布置了一个作业&#xff0c;让她求出L到R之间不同因子数最多的那个数和这…

Asp.Net Core中利用Seq组件展示结构化日志功能

在一次.Net Core小项目的开发中&#xff0c;掌握的不够深入&#xff0c;对日志记录并没有好好利用&#xff0c;以至于一出现异常问题&#xff0c;都得跑动服务器上查看&#xff0c;那时一度怀疑自己肯定没学好&#xff0c;不然这一块日志不可能需要自己扒服务器日志来查看&…

P2633-Count on a tree【主席树,LCA】

正题 题目链接:https://www.luogu.com.cn/problem/P2633 题目大意 nnn个点的树&#xff0c;每个点有点权&#xff0c;求u∼vu\sim vu∼v的路径上第kkk小的权值&#xff0c;强制在线。 解题思路 考虑在树上维护主席树&#xff0c;我们不难发现如果sizxsiz_xsizx​表示根节点到…

P3327 约数的个数和 [约数函数性质,数论分块]

P3327 约数的个数和 题意 d(x)d(x)d(x)为约数的个数,对于每个询问,回答∑i1n∑j1md(ij)\sum_{i1}^n\sum_{j1}^md(ij)∑i1n​∑j1m​d(ij). 题解 这个题推得我头皮发麻,然后还没推出来,后来发现要做这题的先知道一个性质: d(ij)∑x∣i∑y∣j[gcd(x,y)1]d(ij)\sum_{x|i}\sum_{…

【结论】小X的矩阵

小X的矩阵 题目大意&#xff1a; 有一个nn的矩阵&#xff0c;要你执行g此操作&#xff0c;然后根据操作输出&#xff08;详情见原题&#xff09; 原题&#xff1a; 题目描述 小X最近迷上了矩阵&#xff0c;他定义了一个对于一种特殊矩阵的特征函数G。对于N∗NN*NN∗N的矩阵…

Apache SkyWalking的架构设计【译文】

Apache SkyWalking提供了一个功能强大并且很轻量级的后端。在此&#xff0c;将介绍为什么采用以下方式来设计它&#xff0c;以及它又是如何工作的。架构图对于APM而言&#xff0c;agent或SDKs仅是如何使用libs的技术细节。手动或自动的形式与架构无关&#xff0c;因此在本文中&…

P4735-最大异或和【可持久化Trie】

正题 题目链接:https://www.luogu.com.cn/problem/P4735 题目大意 nnn个数字&#xff0c;有操作 在末尾加入一个数字xxx询问[l,r][l,r][l,r]范围内的一个ppp使得ap⊕ap1⊕ap2...⊕an⊕xa_p\oplus a_{p1}\oplus a_{p2}...\oplus a_{n}\oplus xap​⊕ap1​⊕ap2​...⊕an​⊕x的…

【SPFA】桐人的约会

桐人的约会 题目大意&#xff1a; 删掉一条边&#xff0c;让一个图中的最短路最长 原题&#xff1a; 题目描述 这是一个风和日丽的日子&#xff0c;桐人和诗乃在约会。他们所在的城市共有N个街区&#xff0c;和M条道路&#xff0c;每条道路连接两个不同的街区&#xff0c;…

北京区域赛I题,Uva7676,A Boring Problem,前缀和差分

A Boring Problem 题解 其实这题不难,只要想到了前缀和差分就基本OK了. 我们要求的是第iii项的式子: F(i)(a1a2...ai)k(a2...ai)k...(ai)kF(i)(a_1a_2...a_i)^k(a2...a_i)^k...(a_i)^kF(i)(a1​a2​...ai​)k(a2...ai​)k...(ai​)k 记Sia1a2...ai,S00S_i a_1a_2...a_i,S_…

P4331-[BalticOI2004]Sequence数字序列【左偏树】

正题 题目链接:https://www.luogu.com.cn/problem/P4331 题目大意 给出一个序列aaa&#xff0c;求一个单调上升的序列bbb使得∑i1n∣ai−bi∣\sum_{i1}^n|a_i-b_i|∑i1n​∣ai​−bi​∣最小。 解题思路 巧妙的解法 首先我们让所有的ai−ia_i-iai​−i这样我们求的bbb序列就…

通俗易懂,什么是.NET?什么是.NET Framework?什么是.NET Core?

什么是.NET&#xff1f;什么是.NET Framework?本文将从上往下&#xff0c;循序渐进的介绍一系列相关.NET的概念&#xff0c;先从类型系统开始讲起&#xff0c;我将通过跨语言操作这个例子来逐渐引入一系列.NET的相关概念&#xff0c;这主要包括&#xff1a;CLS、CTS(CLI)、FCL…

【离散化】【DP】命运石之门的选择

命运石之门的选择 题目大意&#xff1a; 有n个盒子&#xff0c;高度为ai&#xff0c;可以数值刷盒子&#xff0c;也可以横着刷&#xff0c;但如果前面没盒子了&#xff0c;就要停下&#xff0c;问刷完这些盒子最少要刷多少次 原题&#xff1a; 题目描述 在某一条不知名世界…

P2153 晨跑,费用流裸题

晨跑 题目连接 https://www.luogu.org/problemnew/show/P2153 题解 求最大不相交路径数,并在路径数最大前提下,求总路程最短. 太裸了. 求不相交路径数:将除1,n1,n1,n两点外的所有点拆分,中间连一条容量为111,费用为000的边.然后所有的原边u→vu \rightarrow vu→v视作从u…

P3812-[模板]线性基

正题 题目链接:https://www.luogu.com.cn/problem/P3812 题目大意 给出nnn个数&#xff0c;求在其中选出若干个数使得它们的异或和最大。 解题思路 序列aaa的线性基bbb满足以下性质 aaa中的任何一个数都可以由bbb中的若干个数异或得到bbb中的任何一个数都不可由bbb中的若干个…

.Net Core小技巧 - Hosted Services + Quartz实现定时任务调度

背景之前一直有朋友问&#xff0c;.Net Core Linux环境有没有类似Windows服务的东西。其实是有的&#xff0c;我了解的方法有两种&#xff1a;#1 创建一个ASP.Net Core的Web项目&#xff08;如Web API&#xff09;&#xff0c;然后通过添加中间件&#xff08;Middleware&#…