Sentry快速開始並集成釘釘群機器人

来源:https://www.cnblogs.com/cjsblog/archive/2019/03/25/10585213.html
-Advertisement-
Play Games

Sentry（直譯為：哨兵）是一個開源錯誤跟蹤服務，幫助開發人員實時監控和修複崩潰 Sentry本質上是一種幫助您實時監控和修複崩潰的服務 1. 安裝客戶端SDK 這裡我們安裝Java平臺的SDK，而且使用logback的方式集成 https://docs.sentry.io/clients/jav ...


Sentry（直譯為：哨兵）是一個開源錯誤跟蹤服務，幫助開發人員實時監控和修複崩潰

Sentry本質上是一種幫助您實時監控和修複崩潰的服務

1.  安裝客戶端SDK

這裡我們安裝Java平臺的SDK，而且使用logback的方式集成

https://docs.sentry.io/clients/java/

1.1.  Logback

https://docs.sentry.io/clients/java/modules/logback/

首先，引入maven依賴

<dependency>
    <groupId>io.sentry</groupId>
    <artifactId>sentry-logback</artifactId>
    <version>1.7.16</version>
</dependency>

接著，添加logback.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- Configure the Console appender -->
    <appender name="Console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- Configure the Sentry appender, overriding the logging threshold to the WARN level -->
    <appender name="Sentry" class="io.sentry.logback.SentryAppender">
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>WARN</level>
        </filter>
    </appender>

    <root level="INFO">
        <appender-ref ref="Console" />
        <appender-ref ref="Sentry" />
    </root>
</configuration>

最後，添加sentry.properties配置

主要是設置DSN（Data Source Name）

設置DSN的方式有多種（比如：sentry.properties，或者環境變數SENTRY_DSN，或者運行時參數）

具體參見  https://docs.sentry.io/clients/java/config/#setting-the-dsn

1.2.  Spring

https://docs.sentry.io/clients/java/modules/spring/

用Spring Boot的話這樣寫即可

@Bean
public ServletContextInitializer sentryServletContextInitializer() {
    return new io.sentry.spring.SentryServletContextInitializer();
}

1.3.  示例配置

配置項很多，在此不一一列舉，更多請參見  https://docs.sentry.io/clients/java/config/#setting-the-dsn

有兩個必須配置的選項：dsn 和 stacktrace.app.packages

https://docs.sentry.io/clients/java/config/#in-application-stack-frames

工程結構

pom.xml

logback.xml

sentry.properties

 接下來，啟動項目，並訪問，令其報錯，然後通過Web管理後臺查看

同時，也收到了郵件

點進去，查看詳情，可以看到異常信息，還可以看到配置文件中我們帶的參數，還可以對異常進行處理

1.4.  手動捕獲異常

/**
  * An example method that throws an exception.
  */
void unsafeMethod() {
    throw new UnsupportedOperationException("You shouldn't call this!");
}

/**
  * Examples using the (recommended) static API.
  */
void logWithStaticAPI() {
    // Note that all fields set on the context are optional. Context data is copied onto
    // all future events in the current context (until the context is cleared).

    // Record a breadcrumb in the current context. By default the last 100 breadcrumbs are kept.
    Sentry.getContext().recordBreadcrumb(
        new BreadcrumbBuilder().setMessage("User made an action").build()
    );

    // Set the user in the current context.
    Sentry.getContext().setUser(
        new UserBuilder().setEmail("[email protected]").build()
    );

    // Add extra data to future events in this context.
    Sentry.getContext().addExtra("extra", "thing");

    // Add an additional tag to future events in this context.
    Sentry.getContext().addTag("tagName", "tagValue");

    /*
     This sends a simple event to Sentry using the statically stored instance
     that was created in the ``main`` method.
     */
    Sentry.capture("This is a test");

    try {
        unsafeMethod();
    } catch (Exception e) {
        // This sends an exception event to Sentry using the statically stored instance
        // that was created in the ``main`` method.
        Sentry.capture(e);
    }
}

/**
  * Examples that use the SentryClient instance directly.
  */
void logWithInstanceAPI() {
    // Retrieve the current context.
    Context context = sentry.getContext();

    // Record a breadcrumb in the current context. By default the last 100 breadcrumbs are kept.
    context.recordBreadcrumb(new BreadcrumbBuilder().setMessage("User made an action").build());

    // Set the user in the current context.
    context.setUser(new UserBuilder().setEmail("[email protected]").build());

    // This sends a simple event to Sentry.
    sentry.sendMessage("This is a test");

    try {
        unsafeMethod();
    } catch (Exception e) {
        // This sends an exception event to Sentry.
        sentry.sendException(e);
    }
}

1.5.  文檔

Sentry還有很多很多配置，更多請參見  https://docs.sentry.io/

錯誤數據  https://docs.sentry.io/enriching-error-data/context/?platform=electron

集成  https://docs.sentry.io/workflow/releases/?platform=electron

用戶和組  https://docs.sentry.io/accounts/membership/

 

好，接下來說重點

在剛纔的告警中，僅僅只是使用郵件的方式進行通知，這是不夠的，因為你會發現在平時的工作中很少有人去實時關註郵件，因為實在是太多了（GitLab、Jira、Wiki、還有各種會議郵件抄送，都懶得打開），這還是上班時間，下班以後就更不好說了，因此，更通常的做法是採用釘釘群機器人通知。每當出現異常告警，釘釘群機器人都會@指定的負責人，這樣效率更高，能夠更快速的響應線上問題，其實最主要是一般釘釘都是隨時線上的。

很可惜！Sentry預設的服務中是不支持釘釘的，它並沒有集成釘釘。我也是找到好久才發現的

項目告警裡面的集成也沒有

後來，我看到有一個 WebHooks ，於是我就把釘釘群機器人的回調地址填到這裡，發現不行

後來，我猜測應該是數據格式不對，但又不支持自定義發送的數據格式

沒有辦法，最後我決定不用Sentry的伺服器，自己搭建服務端，自定義的應該能夠支持釘釘

 

2.  搭建Sentry服務端

https://docs.sentry.io/server/installation/

2.1.  安裝前的準備

PostgreSQL ： 需要 postgres:9.5

https://www.postgresql.org/download/

https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

Redis ： 需要2.8.9以上的版本

brew install redis

https://redis.io/download

2.2.  採用Python安裝

官方提供兩種安裝方式：Docker 和 Python，這裡我採用Python方式安裝

https://docs.sentry.io/server/installation/python/

2.2.1.  安裝Python 2.7 

brew install python2

2.2.2.  設置虛擬環境

pip install -U virtualenv
virtualenv /www/sentry/
source /www/sentry/bin/activate

2.2.3.  安裝Sentry

pip install -U sentry

git地址：https://github.com/getsentry/sentry

初始化配置

sentry init /etc/sentry

配置postgressql

sentry.conf.py

配置Redis

配置郵件

創建資料庫

接下來的三條命令在我們剛纔設置的虛擬環境下執行

# If you kept the database ``NAME`` as ``sentry``
$ createdb -E utf-8 sentry

$ SENTRY_CONF=/etc/sentry sentry upgrade

# create a new user
$ SENTRY_CONF=/etc/sentry sentry createuser

2.2.4.  啟動Web服務

SENTRY_CONF=/etc/sentry sentry run web

2.2.5.  啟動後臺Worker進程

SENTRY_CONF=/etc/sentry sentry run worker

2.2.6.  啟動Cron進程

SENTRY_CONF=/etc/sentry sentry run cron

以下是我安裝過程中執行的一些命令

2.2.7.  訪問 http://localhost:9000/

登錄（PS：用戶名和密碼就是我們在安裝Sentry的時候設置的用戶名和密碼，這裡我設置用戶名和密碼分別是：[email protected]/12345678）

設置（Root URL是將來上報事件的伺服器地址，沒有功能變數名稱的話可以就寫localhost:9000）

進入主界面，可以先設置一下語言和時區

新建一個項目

查看客戶端秘鑰

接下來可以查看並修改系統設置

 

 

3.  釘釘群機器人

Webhook可以理解為是一種回調機制，一個回調地址

https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.p2lr6t&treeId=257&articleId=105733&docType=1

添加一個自定義的機器人

於是我們就可以拿到一個webhook地址，這個地址裡面帶著access_token

按照釘釘的消息格式，我們就可以給這個群發消息

https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.karFPe&treeId=257&articleId=105735&docType=1

 

4.  Sentry集成釘釘插件

4.1.  安裝sentry_dingding插件

我找到兩個相似的插件

插件一：https://github.com/anshengme/sentry-dingding

這個插件相對新一點兒，最近一次提交是5個月前

安裝方式有兩種，

第一種： pip install sentry-dingding

第二種： pip install git+https://github.com/anshengme/sentry-dingding.git

插件二：https://github.com/evilbs/sentry-dingtalk

安裝方式也有兩種，

第一種： pip install git+https://github.com/evilbs/sentry-dingtalk.git

第二中： 先git clone到本地，然後執行 pip install 本地目錄

最後，無論哪個插件，無論哪種方式，這條命令必須在虛擬路徑下執行

安裝完成後可以通過sentry plugins list命令查看

接下來，安裝完了還不算完，最重要的是檢查一下有沒有錯誤

同樣，在虛擬路徑下執行 sentry upgrade

但是，當你執行以後，你會發現報錯了

redis版本衝突是什麼鬼？意思是，Python2.7需要的redis版本是2.10.5，而redis-py-cluster需要依賴的redis版本最新是2.10.6

怎麼辦呢？重新安裝一下吧

pip uninstall redis
pip install redis==2.10.5

再執行 sentry upgrade，還是版本衝突，於是又改redis-py-cluster的版本

pip uninstall redis-py-cluster
pip install redis-py-cluster==1.3.5

問題又來了，說Sentry 9.0.0需要的redis-py-cluster版本最小是1.3.4，不能大於或等於1.4.0

幾經折騰，終於找到一個既滿足sentry 9.0.0，又滿足python2.7對redis的版本要求，就是1.3.4版本

再次執行sentry upgrade成功

重啟Web服務

lsof -i tcp:9000
kill -9 
sentry run web
sentry run worker

刷新頁面，終於看到了

填寫token

發個消息看看效果

此處應有掌聲，啊哈哈哈~~

 

5.  參考文檔

https://docs.sentry.io/server/

https://docs.sentry.io/server/installation/python/

https://pypi.org/

https://github.com/anshengme/sentry-dingding

https://logback.qos.ch/codes.html#appender_order

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • JS使用cookie實現只出現一次的廣告代碼效果
    我們上網經常會遇到第一次需要登錄而之後不用再登錄的網站的情況，其實是運用了Cookie 存儲 web 頁面的用戶信息，Cookie 以名/值對形式存儲,當瀏覽器從伺服器上請求 web 頁面時， 屬於該頁面的 cookie 會被添加到該請求中。服務端通過這種方式來獲取用戶的信息l。 今天的這個效果：第 ...
  • jQuery中頁面返回頂部的方法總結
    當頁面過長時，通常會在頁面下方有一個返回頂部的button，總結一下，大概三種實現方法，下麵說下各方法及優缺點。 方法一 錨點定位 ? 1 <a href="#" class="top" id="top">返回頂部</a> ? 1 <a href="#" class="top" id="top">返 ...
  • 簡單幾步用純CSS3實現3D翻轉效果
    作為前端開發人員的必修課，CSS3翻轉能帶我們完成許多基本動效，本期我們將用CSS3實現hover翻轉效果~ 第一步非常簡單，我們簡單畫1個演示方塊，為其 添加transition和transform屬性 ： ? 1 2 3 4 5 6 7 8 9 10 11 // 本示例均使用Sass語法 .bl ...
  • jQuery元素操作
    jQuery中創建元素及追加元素 DOM中可以動態創建元素:document.createElement(“標簽的名字”); jQuery中同樣可以創建元素標簽,並且返回的就是jQuery對象,可以直接調用方法進行使用 1.append 方法用來在元素的末尾追加元素（最後一個子節點）。增加元素末尾 ...
  • 個人博客建站最全解析
    大家好~又見面了。 今天呢我想給大家，也給我自己， 對我的個人網站yanyy.cn/yanyy 做一個全面的整理和分析。 也給有這方面想法的朋友一個參考。 做網站的有愛好也有帶有目的性的。 不過我還是希望大家能夠傳播正能量~ 進入正題 網站首頁 看到上圖，是網站的首頁。 首頁上用戶直接看得到的部分有 ...
  • react中圖片校驗碼實現以及new Buffer()使用方法
    圖片校驗碼原理就是圖片是後端生成的前端只是前後端傳過來的數據流做些處理展示即可，先直接上核心代碼圖： 這裡就是簡單得對axios的一些預設項屬性重寫：最後你只需要將resolve的內容插入頁面的<img src="resolve（data:img/png;base64,&{base64}）">即可， ...
  • Friendly Date Ranges 讓日期區間更友好
    把常見的日期格式如：YYYY-MM-DD 轉換成一種更易讀的格式。 易讀格式應該是用月份名稱代替月份數字，用序數詞代替數字來表示天 (1st 代替 1). 記住不要顯示那些可以被推測出來的信息: 如果一個日期區間里結束日期與開始日期相差小於一年，則結束日期就不用寫年份了；在這種情況下，如果月份開始和 ...
  • 2019年北航OO第一次博客總結
    一、基於度量對程式結構的分析 1. 第一次作業 1.1 基於類的分析的度量 首先，基於類的屬性個數，方法個數，每個方法的規模，每個方法的控制分支數目，類總代碼規模等特征對本次作業的結構進行分析。 1.2 基於類間內聚和耦合的度量 我使用了MetricsReloaded插件來對代碼的複雜度進行了分析。 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類