在之前我有专门写两篇文章介绍过Exceptionless这款开源日志项目的使用和部署，但是当时是基于4.1.0版本（2017年的release），时隔两年多Exceptionless也推出了5.0.0版本。

一、关于Exceptionless 5.0.0

　　Exceptionless 是一个开源的实时的好用的日志收集框架，它将日志收集变得简单易用并且不需要了解太多的相关技术细节及配置。但是之前的版本将其Web和API绑定在了Windows平台通过IIS运行，对于已经步入云原生时代的我们显得有点格格不入。5.0.0的发布解决了这一痛点，其最大的变化就是基于ASP.NET Core重写并支持跨平台，也就是说当初我们设想的要是能够基于Docker部署在Linux服务器下就更好了的愿望已经实现了，在此真心感谢Exceptionless项目的各位贡献者。本文就Exceptionless 5.0.0版本介绍一下快速地部署开发环境和生产环境，相信对有兴趣的朋友会有一点帮助。

　　至此我也可以将我们之前的Exceptionless从Windows Server迁移到Linux上了！

二、快速本地部署步骤

2.1 安装Docker 18.09+

　　由于Exceptionless 5.0.0的一个前置要求是Docker版本（CE）在18.09及以上，因此我们需要安装一个18.09+的Docker CE版本到Linux服务器上，如果你之前安装了可以跳过此步骤，但如果版本小于18.09，那么请清理掉老版本升级到新版本，升级版本可以参考以下步骤。

　　实验环境：阿里云ECS主机，CentOS 7.4

　　（1）清理已有Docker老版本

　　停止Docker老版本：

systemctl stop docker

　　卸载软件包：

yum erase docker \

docker</span>-<span style="color: #000000;">client \
docker</span>-client-<span style="color: #000000;">latest \
docker</span>-<span style="color: #000000;">common \
docker</span>-<span style="color: #000000;">latest \
docker</span>-latest-<span style="color: #000000;">logrotate \
docker</span>-<span style="color: #000000;">logrotate \
docker</span>-<span style="color: #000000;">selinux \
docker</span>-engine-<span style="color: #000000;">selinux \
docker</span>-<span style="color: #000000;">engine \
docker</span>-ce</pre>

　　删除相关配置文件：

find /etc/systemd -name 'docker' -exec rm -f {} ;
find /etc/systemd -name 'docker' -exec rm -f {} ;
find /lib/systemd -name 'docker' -exec rm -f {} ;
rm -rf /var/lib/docker   #删除以前已有的镜像和容器,非必要，慎删
rm -rf /var/run/docker

　　（2）安装Docker 18.09+

　　软件包安装：

yum install -y yum-utils  device-mapper-persistent-data lvm2

　　添加yum源：

yum-config-manager \
--add-repo \

https:</span><span style="color: #008000;">//</span><span style="color: #008000;">download.docker.com/linux/centos/docker-ce.repo</span></pre>

　　查看可安装的版本：目前最新版本已经是19.03

yum list docker-ce --showduplicates | sort -r

　　安装指定版本：18.09

yum install docker-ce docker-ce-18.09.9-3.el7 -y

　　启动Docker并设置开机自启动：

systemctl start docker
systemctl enable docker

　　查看Docker版本：

docker version

　　你可以看到已经是18.09版本了：

2.2 下载Exceptionless 5.0.0 Release包

　　传送门：Exceptionless release

2.3 安装Exceptionless 5.0.0

　　（1）修改docker-compose.yml文件，设置外部访问地址/域名（适配你的服务器IP地址或域名+SSL证书，这里我直接修改为我的阿里云服务器的外网IP地址，参考我的注释）

version: '3.4'

services:
api:

depends_on:
  </span>-<span style="color: #000000;"> elasticsearch
  </span>-<span style="color: #000000;"> redis
build:
  context: .
  target: api
image: exceptionless</span>/<span style="color: #000000;">api:latest
restart: on</span>-<span style="color: #000000;">failure
environment:
  EX_AppMode: Production
  EX_BaseURL: http:</span><span style="color: #008000;">//</span><span style="color: #008000;">192.168.16.170:5100 #UI地址，修改这里的IP地址为你的服务器IP地址</span>
  EX_ConnectionStrings__Cache: provider=<span style="color: #000000;">redis
  EX_ConnectionStrings__Elasticsearch: server</span>=http:<span style="color: #008000;">//</span><span style="color: #008000;">elasticsearch:9200</span>
  #EX_ConnectionStrings__Email: smtps:<span style="color: #008000;">//</span><span style="color: #008000;">user:password@smtp.host.com:587</span>
  EX_ConnectionStrings__MessageBus: provider=<span style="color: #000000;">redis
  #EX_ConnectionStrings__Metrics: provider</span>=statsd;server=<span style="color: #000000;">statsd;
  EX_ConnectionStrings__Queue: provider</span>=<span style="color: #000000;">redis
  EX_ConnectionStrings__Redis: server</span>=redis,abortConnect=<span style="color: #0000ff;">false</span><span style="color: #000000;">
  EX_ConnectionStrings__Storage: provider</span>=folder;path=/app/<span style="color: #000000;">storage
  EX_RunJobsInProcess: </span><span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
ports:
  </span>- <span style="color: #800080;">5000</span>:<span style="color: #800080;">80</span> # This can be commented out <span style="color: #0000ff;">if</span><span style="color: #000000;"> using reverse proxy.
volumes:
  </span>- appdata:/app/<span style="color: #000000;">storage

jobs:

depends_on:
  </span>-<span style="color: #000000;"> api
build:
  context: .
  target: job
image: exceptionless</span>/<span style="color: #000000;">job:latest
restart: on</span>-<span style="color: #000000;">failure
environment:
  EX_AppMode: Production
  EX_BaseURL: http:</span><span style="color: #008000;">//</span><span style="color: #008000;">192.168.16.170:5100 #UI地址，修改这里的IP地址为你的服务器IP地址</span>
  EX_ConnectionStrings__Cache: provider=<span style="color: #000000;">redis
  EX_ConnectionStrings__Elasticsearch: server</span>=http:<span style="color: #008000;">//</span><span style="color: #008000;">elasticsearch:9200</span>
  #EX_ConnectionStrings__Email: smtps:<span style="color: #008000;">//</span><span style="color: #008000;">user:password@smtp.host.com:587</span>
  EX_ConnectionStrings__MessageBus: provider=<span style="color: #000000;">redis
  #EX_ConnectionStrings__Metrics: provider</span>=statsd;server=<span style="color: #000000;">statsd;
  EX_ConnectionStrings__Queue: provider</span>=<span style="color: #000000;">redis
  EX_ConnectionStrings__Redis: server</span>=redis,abortConnect=<span style="color: #0000ff;">false</span><span style="color: #000000;">
  EX_ConnectionStrings__Storage: provider</span>=folder;path=/app/<span style="color: #000000;">storage
volumes:
  </span>- appdata:/app/<span style="color: #000000;">storage

ui:

image: exceptionless</span>/<span style="color: #000000;">ui:latest
environment:
  AppMode: Production
  EX_ApiUrl: http:</span><span style="color: #008000;">//</span><span style="color: #008000;">192.168.16.170:5000 #API地址，修改这里的IP地址为你的服务器IP地址</span>
  #EX_Html5Mode: <span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
  #EX_EnableSsl: </span><span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
  #EX_EnableAccountCreation: </span><span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
ports:
  </span>- <span style="color: #800080;">5100</span>:<span style="color: #800080;">80</span> # This can be commented out <span style="color: #0000ff;">if</span><span style="color: #000000;"> using reverse proxy.

reverseproxy:

depends_on:

- api

- ui

image: valian

/docker-nginx-auto- ssl

restart: on

- failure

ports:

- 80: 80

- 443: 443

volumes:

- ssldata:/etc/resty-auto- ssl

environment:

ALLOWED_DOMAINS:

' (ex-ui|ex-api).mydomainn.com '

SITES:

' ex-ui.mydomainn.com=ui;ex-api.mydomainn.com=api '

elasticsearch:

image: exceptionless</span>/elasticsearch:<span style="color: #800080;">1</span><span style="color: #000000;">
restart: on</span>-<span style="color: #000000;">failure
environment:
  cluster.name: </span><span style="color: #800000;">'</span><span style="color: #800000;">exceptionless</span><span style="color: #800000;">'</span><span style="color: #000000;">
  bootstrap.memory_lock: </span><span style="color: #800000;">'</span><span style="color: #800000;">true</span><span style="color: #800000;">'</span><span style="color: #000000;">
  discovery.type: single</span>-<span style="color: #000000;">node
  ES_JAVA_OPTS: </span><span style="color: #800000;">'</span><span style="color: #800000;">-Xms512m -Xmx512m</span><span style="color: #800000;">'</span><span style="color: #000000;">
  xpack.security.enabled: </span><span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
  xpack.graph.enabled: </span><span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
  xpack.watcher.enabled: </span><span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
ports:
  </span>- <span style="color: #800080;">9200</span>:<span style="color: #800080;">9200</span>
  - <span style="color: #800080;">9300</span>:<span style="color: #800080;">9300</span><span style="color: #000000;">
ulimits:
  memlock:
    soft: </span>-<span style="color: #800080;">1</span><span style="color: #000000;">
    hard: </span>-<span style="color: #800080;">1</span><span style="color: #000000;">
volumes:
  </span>- esdata:/usr/share/elasticsearch/<span style="color: #000000;">data

kibana:

depends_on:
  </span>-<span style="color: #000000;"> elasticsearch
image: exceptionless</span>/kibana:<span style="color: #800080;">1</span><span style="color: #000000;">
restart: on</span>-<span style="color: #000000;">failure
environment:
  xpack.security.enabled: </span><span style="color: #800000;">'</span><span style="color: #800000;">false</span><span style="color: #800000;">'</span><span style="color: #000000;">
ports:
  </span>- <span style="color: #800080;">5601</span>:<span style="color: #800080;">5601</span><span style="color: #000000;">

redis:

image: redis:alpine
restart: on</span>-<span style="color: #000000;">failure
ports:
  </span>- <span style="color: #800080;">6379</span>:<span style="color: #800080;">6379</span><span style="color: #000000;">

volumes:
esdata:

driver: local

appdata:

driver: local

ssldata:

driver: local</span></pre>

Note：在这个docker-compose.yml中定义了Exceptionless的最小化运行环境，但官方建议生产环境使用ElasticSearch集群，并适当修改ElasticSearch的内存限制。如果你的量很小真的不大，那么这个最小化的运行环境也够用了，没必要为了高可用而高可用。　　

　　此外，貌似官方已经将exceptionless/elasticsearch:1这个镜像移除了，大家可以使用这个镜像：edisonsaonian/exceptionless-elasticsearch:1

　　（2）将Release包上传到阿里云服务器，然后通过SSH执行一下shell命令（首先cd到这个release包的目录下）启动Exceptionless 5.0.0。

docker-compose up -d

　　整个过程会比较漫长，因为会经过34个Steps，拉取很多镜像，类似于Redis，ElasticSearch，Kibana及.NET Core SDK等等，请耐心等待。最终效果如下所示：

2.4 使用Exceptionless 5.0.0

　　（1）访问你的服务器IP:5100 即可访问Exceptionless Web管理登录界面，如果你能看到，那么代表部署成功了。注册一个账号，然后登陆吧。

　　（2）可以看到主页是全新的中文管理界面，感谢贡献者的努力

　　（3）创建一些示例项目，如“XDP.Product.API”，并获取API Key

　　（4）在你的ASP.NET Core WebAPI项目中配置API Key，并向Exceptionless API（这里是5000端口）发送Log

　　（5）在Exceptionless中查看Log

三、遗留问题：Email通知配置

　　使用过Exceptionless的童鞋都知道，Exceptionless提供了强大的Email通知机制，可以为用户提供及时的严重错误通知和每日报告。

　　在上面介绍的安装基础上，根据官方Wiki文档，按理说我们只需要确保docker-compose.yml中的api和jobs的AppMode为Production模式并设置SMTP就可以开启Email通知。

EX_AppMode: Production
EX_ConnectionStrings__Email: smtps://edisonchou7%40qq.com:zltqvl2321ed@smtp.qq.com:465

这里的%40是@的转义替代，在Exceptionless中会使用Decode进行解码为@，原因好像是因为它是通过@符号分割前方的用户名+密码和后方的Host+Port，也是醉了。

　　设置完成后，通过以下命令重启docker：

docker-compose up -d

　　docker-compose会自动帮我们重启更改过的容器，比如api和jobs。

　　但是，我试了很多次都发现还是无法正常发送Email通知，由于不影响使用，也就暂时没去深究了，有解决的朋友可以告知并 分享一下解决办法，谢谢。

四、小结

　　本文介绍了Exceptionless 5.0.0的容器化本地部署，主要参考自Exceptionless的Self-Host文档。

参考资料

1、Exceptionless release

2、Exceptionless Self-Hosting Documention

文章转载自阿里云 MVP周旭龙，查看原文

Exceptionless 5.0.0 本地Docker快速部署介绍

一、关于Exceptionless 5.0.0

二、快速本地部署步骤

2.1 安装Docker 18.09+

2.2 下载Exceptionless 5.0.0 Release包

2.3 安装Exceptionless 5.0.0

reverseproxy:

depends_on:

image: valian

restart: on

ports:

volumes:

environment:

ALLOWED_DOMAINS:

SITES:

2.4 使用Exceptionless 5.0.0

三、遗留问题：Email通知配置

四、小结

参考资料

阿里云MVP

热门文章

最新文章

相关课程

相关电子书

相关实验场景

推荐镜像

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

Exceptionless 5.0.0 本地Docker快速部署介绍

一、关于Exceptionless 5.0.0

二、快速本地部署步骤

2.1 安装Docker 18.09+

2.2 下载Exceptionless 5.0.0 Release包

2.3 安装Exceptionless 5.0.0

reverseproxy:

depends_on:

image: valian

restart: on

ports:

volumes:

environment:

ALLOWED_DOMAINS:

SITES:

2.4 使用Exceptionless 5.0.0

三、遗留问题：Email通知配置

四、小结

参考资料

阿里云MVP

热门文章

最新文章

相关课程

相关电子书

相关实验场景

推荐镜像