ASP .NET Core 集成 Exceptionless 日志

Exceptionless简介

Exceptionless是一款分布式日志管理框架，它可以统一收集管理并展示出来程序的日志，这样的话减少了传统开发过程中还需要去服务器查找日志的痛苦，大大提升对程序的运维效率。 Exceptionless依赖于Redis和Elasticsearch。

官网地址：https://exceptionless.com/
官方文档地址：https://exceptionless.com/docs/
官方Github地址：https://github.com/exceptionless/Exceptionless
Docker镜像地址：https://hub.docker.com/r/exceptionless/exceptionless
日志搜索文档：https://exceptionless.com/docs/filtering-and-searching

目前支持JavaScript, Node, .NET Core, .NET相关应用程序的异常信息采集。为何仅支持.Net .Net Core和JS相关的？原因很简单，Exceptionless是基于.NET Core开发的。如果你有别的语言的开发需求也想使用Exceptionless，这个时候不要气馁，因为Exceptionless本质是基于http接口的形式上报数据的，这个可在官方文档上找到如何使用http上报日志信息相关

官方文档api地址：https://exceptionless.com/docs/api/api-getting-started/
api官方文档地址：https://api.exceptionless.io/
api官方swagger地址：https://api.exceptionless.io/docs/index.html

部署Exceptionless

官网提供了两种使用的方式

在官方网站注册账号然后获取apiKey，这样的话不用自己搭建Exceptionless，而是将日志直接收集上报到Exceptionless服务器上。但是，一般基于安全和性能考虑，这种方式并不常用。
自建Exceptionless服务，也是本篇我们要使用的方式。之前的低版本支持在window服务器上自建服务，但是高版本已经是基于docker的方式构建了。而使用docker的方式也是我个人日常学习中比较喜欢的方式。

基于docker-compose部署。官方yml文件地址

https://github.com/exceptionless/Exceptionless/blob/main/docker-compose.yml
https://github.com/exceptionless/Exceptionless/blob/main/samples/docker-compose.yml

简化版docker-compose.yml

version: '3.7'

services:
  app:
    depends_on:
      - elasticsearch
    image: exceptionless/app:7.2.1
    environment:
      EX_AppMode: Production
      EX_ConnectionStrings__Cache: provider=redis
      EX_ConnectionStrings__Elasticsearch: server=http://elasticsearch:9200
      EX_ConnectionStrings__MessageBus: provider=redis
      EX_ConnectionStrings__Queue: provider=redis
      EX_ConnectionStrings__Redis: server=192.168.1.5:6379,abortConnect=false
      EX_RunJobsInProcess: 'false'
    ports:
      - 5000:80
    volumes:
      - appdata:/app/storage

  jobs:
    depends_on:
      - app
    image: exceptionless/job:7.2.1
    environment:
      EX_AppMode: Production
      EX_BaseURL: http://192.168.1.5:5000
      EX_ConnectionStrings__Cache: provider=redis
      EX_ConnectionStrings__Elasticsearch: server=http://elasticsearch:9200
      EX_ConnectionStrings__MessageBus: provider=redis
      EX_ConnectionStrings__Queue: provider=redis
      EX_ConnectionStrings__Redis: server=192.168.1.5:6379,abortConnect=false
      EX_ConnectionStrings__Storage: provider=folder;path=/app/storage
    volumes:
      - appdata:/app/storage

  elasticsearch:
    image: exceptionless/elasticsearch:7.15.2
    environment:
      discovery.type: single-node
      xpack.security.enabled: 'false'
      xpack.ml.enabled: 'false'
      ES_JAVA_OPTS: -Xms1g -Xmx1g
    ports:
      - 9200:9200
      - 9300:9300
    volumes:
      - esdata7:/usr/share/elasticsearch/data

volumes:
  esdata7:
    driver: local
  appdata:
    driver: local

yml下载到服务器后直接docker-compose up -d启动站点

Exceptionless 使用

访问站点http://192.168.1.5:5000/，首次登陆使用注册邮箱账号

注册成功后登陆就可以看到主界面了

新建一个组织

组织中新建一个项目,项目与组织绑定关系是为了后续组织邀请其他用户方便管理查看日志

输入项目名称

项目类型选择ASP.NET Core,然后选择管理项目

进入项目详情，选择API秘钥，在ASP.NET Core项目中需要此秘钥配置