項目集成sentry

本文章將介紹基於Sentry官方提供的在線服務集成sentry，本地搭建sentry將在下篇文章中介紹。

Sentry是個什么東西，自行百度了解。

1、注冊，登錄

網址：https://sentry.io/
注冊一個賬號 

 

2、創建一個project 

 

3、獲取project的DSN

 

4、maven配置依賴

<dependency>
    <groupId>io.sentry</groupId>
    <artifactId>sentry-log4j</artifactId>
    <version>1.7.10</version>
</dependency>

普通java項目需要引入的jar包包括：sentry-1.7.16.jar、sentry-log4j-1.7.17-SNAPSHOT.jar、jackson-annotations-2.1.0.jar、jackson-core-2.1.2.jar、jackson-databind-2.1.0.jar等，根據需要引入。

5、log4j集成sentry時需要在log4j中增加下列配置：

# Enable the Console and Sentry appenders
log4j.rootLogger=INFO, Console, Sentry

# Configure the Console appender
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d{HH:mm:ss.SSS} [%t] %-5p: %m%n

# Configure the Sentry appender, overriding the logging threshold to the WARN level
log4j.appender.Sentry=io.sentry.log4j.SentryAppender
log4j.appender.Sentry.threshold=WARN

如果是log4j.xml，則

<?xml version="1.0" encoding="UTF-8"?>
<configuration  package="org.apache.logging.log4j.core,io.sentry.log4j2">
    <properties>
        <property name="PATTERN">[%-5p]%d{yyyy-MM-dd HH:mm:ss,SSS} %l%n%m%n
        </property>
    </properties>

    <appenders>

        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout charset="UTF-8" pattern="${PATTERN}" />
        </Console>

        <RollingFile name="crawler_logger_appender"
            fileName="logs/crawler.log"
            filePattern="logs/crawler-%d{yyyyMMdd-HH}.log">
            <PatternLayout charset="UTF-8">
                <Pattern>"${PATTERN}"</Pattern>
            </PatternLayout>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="10 MB" />
            </Policies>
        </RollingFile>

        <Sentry name="Sentry" />
    </appenders>

    <loggers>
        <logger name="com.xxx" level="ERROR">
            <AppenderRef ref="Console" />
        </logger>

        <root level="ERROR">
            <AppenderRef ref="Console" />
            <AppenderRef ref="crawler_logger_appender"></AppenderRef>
        </root>


        <AsyncLogger name="sentrylogger" additivity="false"
            level="ERROR" includeLocation="true">
            <AppenderRef ref="Sentry" />
        </AsyncLogger>
        
        <AsyncLogger name="crawlerlogger" additivity="false"
            level="ERROR" includeLocation="true">
            <AppenderRef ref="crawler_logger_appender" />
        </AsyncLogger>
    </loggers>
</configuration>

 

如果指定sentrylogger形式的日志才需要發送到sentry，其他日志不需要發送時，則按照下面的格式配置：

log4j.logger.sentrylogger=INFO,Sentry

## Enable the Console and Sentry appenders
#log4j.rootLogger=INFO, Console, Sentry
#
## Configure the Console appender
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d{HH:mm:ss.SSS} [%t] %-5p: %m%n
##
## Configure the Sentry appender, overriding the logging threshold to the INFO level 
log4j.appender.Sentry=io.sentry.log4j.SentryAppender log4j.appender.Sentry.threshold=INFO

 

6、設置DSN

在文件系統或類路徑上的屬性文件中（默認為sentry.properties）：

dsn=https://public:private@host:port/1

通過Java系統屬性（在Android上不可用）：

-Dsentry.dsn=https://public:private@host:port/1 -jar app.jar

通過系統環境變量（在Android上不可用）：

SENTRY_DSN=https://public:private@host:port/1 java -jar app.jar

代碼中：

import io.sentry.Sentry;
 
Sentry.init("https://public:private@host:port/1");

 

7、demo代碼：

package io.sentry.example.basic;

import io.sentry.Sentry;
import io.sentry.SentryClient;
import io.sentry.SentryClientFactory;
import io.sentry.context.Context;
import io.sentry.event.BreadcrumbBuilder;
import io.sentry.event.UserBuilder;

public class MyClass {
    private static SentryClient sentry;

    public static void main(String... args) {
        /*
        It is recommended that you use the DSN detection system, which
        will check the environment variable "SENTRY_DSN", the Java
        System Property "sentry.dsn", or the "sentry.properties" file
        in your classpath. This makes it easier to provide and adjust
        your DSN without needing to change your code. See the configuration
        page for more information.
        */
        Sentry.init("https://8219291bc5224fa8ab7188ffbf4aa025:[e-mail]/1361356");

        // You can also manually provide the DSN to the ``init`` method.
        // String dsn = "https://<SENTRY_PUBLIC_KEY>:<SENTRY_PRIVATE_KEY>@sentry.io/<PROJECT_ID>";
        // Sentry.init(dsn);

        /*
        It is possible to go around the static ``Sentry`` API, which means
        you are responsible for making the SentryClient instance available
        to your code.
        */
        sentry = SentryClientFactory.sentryClient();

        MyClass myClass = new MyClass();
        myClass.logWithStaticAPI();
    }

    /**
     * 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("[e-mail]").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 by weichangjin");

        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);
        }
    }

}

 

自測成功！