-
Notifications
You must be signed in to change notification settings - Fork 2.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
171 changed files
with
11,269 additions
and
84 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
27 changes: 0 additions & 27 deletions
27
core/runtime/src/main/java/io/quarkus/runtime/ConfigHelper.java
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,80 @@ | ||
//// | ||
This guide is maintained in the main Quarkus repository | ||
and pull requests should be submitted there: | ||
https://github.com/quarkusio/quarkus/tree/master/docs/src/main/asciidoc | ||
//// | ||
= Quarkus - Configuring Sentry Logging | ||
|
||
include::./attributes.adoc[] | ||
|
||
This guide explains sentry logging and how to configure it. | ||
|
||
== Run Time Configuration | ||
|
||
Run time configuration of logging is done through the normal `application.properties` file. | ||
|
||
include::{generated-dir}/config/quarkus-logging-sentry.adoc[opts=optional, leveloffset=+1] | ||
|
||
== Description | ||
|
||
Sentry is a really easy way to be notified of errors happening on you Quarkus application. | ||
|
||
It is a Open Source, Self-hosted and cloud-based error monitoring that helps software teams discover, triage, and prioritize errors in real-time. | ||
|
||
They offer a free starter price for cloud-based or you can self host it for free. | ||
|
||
== Configuration | ||
|
||
To start of, you need to get a Sentry DSN either by https://sentry.io/signup/[creating a Sentry account] or https://docs.sentry.io/server/[installing your self-hosted Sentry]. | ||
|
||
In order to configure Sentry logging, the `quarkus-logging-sentry` extension should be employed. Add this extension to your | ||
application POM as the following snippet illustrates. | ||
|
||
.Modifications to POM file to add the Sentry logging extension | ||
[source,xml] | ||
---- | ||
<build> | ||
<dependencies> | ||
<!-- ... your other dependencies are here ... --> | ||
<dependency> | ||
<groupId>io.quarkus</groupId> | ||
<artifactId>quarkus-logging-sentry</artifactId> | ||
</dependency> | ||
</dependencies> | ||
</build> | ||
---- | ||
|
||
[id="in-app-packages"] | ||
=== “In Application” Stack Frames | ||
Sentry differentiates stack frames that are directly related to your application (“in application”) from stack frames that come from other packages such as the standard library, frameworks, or other dependencies. The difference is visible in the Sentry web interface where only the “in application” frames are displayed by default. | ||
|
||
You can configure which package prefixes your application uses with the stacktrace.app.packages option, which takes a comma separated list. | ||
[source, properties] | ||
---- | ||
quarkus.log.sentry.in-app-packages=com.mycompany,com.other.name | ||
---- | ||
If you don’t want to use this feature but want to disable the warning, simply set it to "*": | ||
|
||
[source, properties] | ||
---- | ||
quarkus.log.sentry.in-app-packages=* | ||
---- | ||
|
||
== Example | ||
|
||
.All errors and warnings occuring in any the packages will be sent to Sentry with DSN `https://[email protected]/1234` | ||
[source, properties] | ||
` | ||
quarkus.log.sentry=true | ||
quarkus.log.sentry.dsn=https://[email protected]/1234 | ||
quarkus.log.sentry.in-app-packages=* | ||
---- | ||
.All errors occuring in the package `org.example` will be sent to Sentry with DSN `https://[email protected]/1234` | ||
[source, properties] | ||
---- | ||
quarkus.log.sentry=true | ||
quarkus.log.sentry.dsn=https://[email protected]/1234 | ||
quarkus.log.sentry.level=ERROR | ||
quarkus.log.sentry.in-app-packages=org.example | ||
---- |
Oops, something went wrong.