Sentry的安装、配置、使用
前言
上一篇文章介绍了ExceptionLess这个日志收集系统:ExceptionLess的安装、配置、使用
由于ExceptionLess官方提供的客户端只有.Net/.NetCore平台和js的,本文继续介绍另一个日志收集系统:Sentry
Sentry 是一个实时事件日志记录和聚合平台。(官方说的是错误监控 Error Monitor)它专门用于监视错误和提取执行适当的事后操作所需的所有信息,而无需使用标准用户反馈循环的任何麻烦。
Sentry使用Python(Django)开发,功能非常丰富,相比起ExceptionLess来说也重得多(这也是我们在.NetCore平台使用ExceptionLess的原因),其支持的平台很全,基本主流编程语言/框架都有,看图
除了.NetCore项目,其他的我都使用Sentry来收集日志和报错信息,整体使用下来还是非常不错的,(就是有点耗内存),请准备好一台内存足够大的服务器,起码8G吧~
安装
和ExceptionLess一样,Sentry也可以在线使用,只需要注册一个账号就行了
不过既然是开源免费的,还是自己部署一套比较自由,速度也比较快(Sentry服务器在国外)
老规矩,使用docker做本地部署,最开始用这玩意的时候安装折腾得很,后来官方自己出了个方便的安装脚本,现在安装应该是很容易了。
首先拉取这个项目到本地:https://github.com/getsentry/self-hosted
然后进入项目目录,执行./install.sh
,经过漫长的pull和build,根据提示输入管理员的用户名和密码,就完事了
官方提供的这个方案也是通过docker-compose管理容器的,以后我们也可以通过docker-compose相关的命令来手动启停系统。
跑起来后访问http://ip:9000
就可以看到登录界面(端口根据实际配置可能不一样)
用刚才创建的用户名密码登录就行了
配置
Sentry的配置项是真的多,到现在大部分我都还没搞清楚,我只是简单的配置了邮件、端口这些,就可以用得飞起了
接上面的,把官方提供的那个self-host
项目clone下来之后,可以看到里面有个sentry
文件夹,配置文件就在这目录里。
邮件配置在config.yml
文件中,(比ExceptionLess好的一点是邮箱地址终于不需要转义了)
这里以腾讯企业邮箱配置为例,在配置中找到# Mail Server #
这个“节点”
mail.backend: 'smtp' # Use dummy if you want to disable email entirely
mail.host: 'smtp.exmail.qq.com'
mail.port: 465
mail.username: 'demo@demo.com'
mail.password: 'password'
mail.use-tls: false
# mail.use-ssl: false
mail.from: 'demo@demo.com'
这样就可以正常发邮件了~
那么端口要怎么改呢,旧版的onpremise(也就是这个self-host项目)是直接在docker-compose.yml里改的,不过现在不推荐修改这个文件了(官方的这个compose配置文件我甚至看不懂)
现在通过环境变量设置,使用ll -a
列出项目目录下所有文件,可以发现有个.env
文件,环境变量就在这文件里配置,里面有一行配置端口的
SENTRY_BIND=9000
直接修改就完事了~
使用
Sentry的界面比ExceptionLess的复杂很多,里面的信息也更多,让人看得眼花缭乱
作为日志收集工具的话,主要就是看“问题”页面,可以筛选某个项目,也可以看全部,这点比ExceptionLess直观一些
点击某一个问题进去可以看到错误详情
如果是Python这类动态语言,甚至可以直接看到是哪段代码报错,太方便了
然后性能页面可以细化到每个请求的相应时间、错误频率、访问的用户数量等
然后再点进去某一个URL还能看到访问这个URL的用户的一些信息,包括IP地址,用户名(如果已登录),页面停留时间,用户都是哪些时间段访问啥的,指标太多了,有些不太懂,反正功能是很强的就对了~
大概就这些吧,其他功能我还没有深入,等后续继续学习后再来更新博客。
项目集成
首先可以看官网文档,还是比较全的,而且大部分语言都提供了集成的Demo。
一些Demo:https://github.com/getsentry/sentry-dotnet/tree/main/samples
直接上几个项目集成的例子吧
本身在Sentry中创建项目时,系统也会显示一个简单的集成指引,这里把我魔改的代码放上来
Django项目
首先根据指引需要安装一个pip包
pip install sentry-sdk
我习惯将项目配置settings.py
放在config
包下,然后把拆分出来的配置一个个都列在这个包中,方便管理
在config
下创建sentry.py
,代码如下
import logging
import sentry_sdk
from sentry_sdk.integrations.django import DjangoIntegration
from sentry_sdk.integrations.logging import LoggingIntegration
from sentry_sdk.integrations.redis import RedisIntegration
sentry_logging = LoggingIntegration(
level=logging.INFO, # Capture info and above as breadcrumbs
event_level=logging.ERROR # Send errors as events
)
sentry_sdk.init(
# 反正dsn这行无脑复制sentry上显示的就行
dsn="http://key@sentry地址/id",
integrations=[DjangoIntegration(), RedisIntegration(), sentry_logging],
# 这里设置为1代表捕捉100%的transaction 用于性能监控
traces_sample_rate=1,
send_default_pii=True,
)
然后在settings.py
里引入就完事了
from config import sentry
Flutter项目
根据指引首先要添加依赖
dependencies:
sentry_flutter: ^5.1.0
PS:现在这个依赖出了6.x版本了,初始化的时候是用异步操作的,我还没更新,就先用5.x版本了
这是原本main.dart
中的App初始化代码
void main() {
WidgetsFlutterBinding.ensureInitialized();
if (Platform.isAndroid) {
// 以下两行 设置android状态栏为透明的沉浸。
SystemUiOverlayStyle systemUiOverlayStyle = SystemUiOverlayStyle(statusBarColor: Colors.transparent);
SystemChrome.setSystemUIOverlayStyle(systemUiOverlayStyle);
}
Global.init().then((value) => runApp(MyApp()));
}
引入Sentry之后,需要包装一层
import 'package:sentry_flutter/sentry_flutter.dart';
void main() {
WidgetsFlutterBinding.ensureInitialized();
SentryFlutter.init(
(options) {
options.dsn = 'http://1335793bf7684f21918248b11cebbf9c@sentry.sblt.deali.cn:9800/9';
},
appRunner: () {
if (Platform.isAndroid) {
SystemUiOverlayStyle systemUiOverlayStyle = SystemUiOverlayStyle(statusBarColor: Colors.transparent);
SystemChrome.setSystemUIOverlayStyle(systemUiOverlayStyle);
}
Global.init().then((value) => runApp(MyApp()));
}
);
}
也就是把原本启动App的代码放在SentryFlutter的appRunner
里执行。
AspNetCore项目
虽然AspNetCore项目我们使用ExceptionLess来采集日志,不过在切换到ExceptionLess之前,也用了一段时间的Sentry,Sentry支持的平台那么丰富,在AspNetCore中使用自然也是没问题的。
根据官方指引首先安装依赖
dotnet add package Sentry.AspNetCore -v 3.19.0
然后将sentry的配置写在appsettings.json
中
"Sentry": {
"Dsn": "https://examplePublicKey@o0.ingest.sentry.io/0",
"MaxRequestBodySize": "Always",
"SendDefaultPii": true,
"MinimumBreadcrumbLevel": "Debug",
"MinimumEventLevel": "Warning",
"AttachStackTrace": true,
"Debug": true,
"DiagnosticsLevel": "Error"
}
跟ExceptionLess不同,sentry不用注册服务和添加中间件的方式,而是实现了IWebHostBuilder
的扩展方法,在ConfigureWebHostDefaults
时就hook到系统中,理论上功能会更强,ExceptionLess通过中间件只能捕捉到类似URL不存在这类HTTP异常,如果是程序中报错是需要手动catch后submit的;而sentry是采用hook的形式(官网说的),可以捕捉到未处理的异常并且上报。(根据微软文档中AspNetCore的启动过程推测出的,理解得不深如果有错误请大佬们指正~)
所以对于AspNetCore3.1项目,修改Program.cs
文件,添加一行代码 webBuilder.UseSentry();
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder => {
webBuilder.UseSentry();
webBuilder.UseStartup<Startup>();
});
对于AspNetCore6项目,也是Program.cs
文件(.Net6也只有这文件)
var builder = WebApplication.CreateBuilder(args);
builder.WebHost.UseSentry();
搞定,然后sentry就会捕捉异常并提交
也可以手动提交,比如
void Demo([FromServices] IHub sentry) {
// 提交普通信息
sentry.CaptureMessage("hello", SentryLevel.Debug);
try {
// 会出错的代码
}
catch (Exception err) {
sentry.CaptureException(err);
}
}
当然根据文档也可以不用依赖注入
using Sentry;
try {
// 会出错的代码
}
catch (Exception err) {
SentrySdk.CaptureException(err);
}
OK,先这些吧,其他例子直接看官网就行~
Sentry的安装、配置、使用的更多相关文章
- 安装配置sentry服务
环境 系统环境:Centos6.7 Hadoop版本:CDH5.10 jdk版本:jdk7 注:本文并未集成kerberos组件 安装Sentry Server 选择安装hive的节点进行安装测试: ...
- 安装配置apache sentry服务
环境 系统环境:Centos6.7 Hadoop版本:CDH5.10 jdk版本:jdk7 注:本文并未集成kerberos组件 安装Sentry Server 选择安装hive的节点进行安装测试: ...
- sentry的安装和使用以及各种问题处理
官方的git地址:https://github.com/getsentry/onpremise 需要先安装docker 1.10版本以上 假设你已经安装完docker,那么接下来 安装docker-c ...
- CDH6.2安装配置第二篇:CDH安装的前期配置
本篇介绍cdh安装之前需要的一些必要配置,当然这些配置也可以用shell脚本来配置.在安装之前请先配置好yum源,在文中用的统一都是阿里源.在安装的时候,要确保主机的内存是4G以上,要不然会无限重启c ...
- Hive安装配置指北(含Hive Metastore详解)
个人主页: http://www.linbingdong.com 本文介绍Hive安装配置的整个过程,包括MySQL.Hive及Metastore的安装配置,并分析了Metastore三种配置方式的区 ...
- Hive on Spark安装配置详解(都是坑啊)
个人主页:http://www.linbingdong.com 简书地址:http://www.jianshu.com/p/a7f75b868568 简介 本文主要记录如何安装配置Hive on Sp ...
- ADFS3.0与SharePoint2013安装配置(原创)
现在越来越多的企业使用ADFS作为单点登录,我希望今天的内容能帮助大家了解如何配置ADFS和SharePoint 2013.安装配置SharePoint2013这块就不做具体描述了,今天主要讲一下怎么 ...
- Hadoop的学习--安装配置与使用
安装配置 系统:Ubuntu14.04 java:1.7.0_75 相关资料 官网 下载地址 官网文档 安装 我们需要关闭掉防火墙,命令如下: sudo ufw disable 下载2.6.5的版本, ...
- redis的安装配置
主要讲下redis的安装配置,以及以服务的方式启动redis 1.下载最新版本的redis-3.0.7 到http://redis.io/download中下载最新版的redis-3.0.7 下载后 ...
- Windows环境下的NodeJS+NPM+Bower安装配置
npm作为一个NodeJS的模块管理,之前我由于没有系统地看资料所以导致安装配置模块的时候走了一大段弯路,所以现在很有必要列出来记录下.我们要先配置npm的全局模块的存放路径以及cache的路径,例如 ...
随机推荐
- 服务器BIOS和BMC等知识详解
一个执着于技术的公众号 引言:以BIOS为核心的固件产业,是信创产业链的重要组成部分,可被誉为信创产业的"山海关".在计算机体系中,BIOS 有着比操作系统更为底层和基础性的作用, ...
- 【算法】基数排序(Radix Sort)(十)
基数排序(Radix Sort) 基数排序是按照低位先排序,然后收集:再按照高位排序,然后再收集:依次类推,直到最高位.有时候有些属性是有优先级顺序的,先按低优先级排序,再按高优先级排序.最后的次序就 ...
- 无线:WEP
WEP是Wired Equivalent Privacy的简称,有线等效保密(WEP)协议是对在两台设备间无线传输的数据进行加密的方式,用以防止非法用户窃听或侵入无线网络.不过密码分析学家已经找出 W ...
- # k8s-jenkins在kubernetes中持续部署
k8s-jenkins在kubernetes中持续部署 1. k8s-jenkins在kubernetes中持续部署 Kubernetes Continuous Deploy插件:用于将资源配置部署到 ...
- 一文讲透为Power Automate for Desktop (PAD) 实现自定义模块 - 附完整代码
概述 Power Automate for Desktop (以下简称PAD)是微软推出的一款针对Windows桌面端的免费RPA(机器人流程自动化)工具,它目前默认会随着Windows 11安装,但 ...
- 【AC自动机】背单词
题意: 0 s v:添加价值为v的字符串s 1 t:查询t中含的s的权值和.(不停位置算多次) 思路: 在线AC自动机. 同学用过一个妙妙子的分块算法. 这里用二进制分组:通常用作把在线数据结构问题转 ...
- SQL中的数字、字母和汉字
知识点001 当变量的数据类型为VARCHAR时,变量赋值后,变量中的字符所占字节数,数字和字母是1个bytes,汉字是2个bytes; 当变量的数据类型为NVARCHAR时,变量赋值后,变量中的字符 ...
- Flink整合面向用户的数据流SDKs/API(Flink关于弃用Dataset API的论述)
动机 Flink提供了三种主要的sdk/API来编写程序:Table API/SQL.DataStream API和DataSet API.我们认为这个API太多了,建议弃用DataSet API,而 ...
- SpringCloud微服务实战——搭建企业级开发框架(四十一):扩展JustAuth+SpringSecurity+Vue实现多租户系统微信扫码、钉钉扫码等第三方登录
前面我们详细介绍了SSO.OAuth2的定义和实现原理,也举例说明了如何在微服务框架中使用spring-security-oauth2实现单点登录授权服务器和单点登录客户端.目前很多平台都提供了单 ...
- 菜鸟学git的基本命令及常见错误
Git init //在当前项目工程下履行这个号令相当于把当前项目git化,变身!\ git config --global user.name "xxx" # 配置用户名 git ...