Repository files navigation

The definition of the word exceptionless is: to be without exception.Exceptionless providesreal-time error reporting for your Java apps. It organizes the gathered information into simple actionable data thatwill help your app become exceptionless!

Refer to the Exceptionless documentation here:Exceptionless Docs.

This project is available to install through Maven.

<!-- https://mvnrepository.com/artifact/com.exceptionless/exceptionless-client --><dependency>    <groupId>com.exceptionless</groupId>    <artifactId>exceptionless-client</artifactId>    <version>0.1.0</version></dependency>

Check the latest version of the libraryhere

classExampleApp {publicstaticvoidmain(String[]args) {privatestaticfinalExceptionlessClientclient =ExceptionlessClient.from(System.getenv("EXCEPTIONLESS_SAMPLE_APP_API_KEY"),System.getenv("EXCEPTIONLESS_SAMPLE_APP_SERVER_URL"));// Submit different events using submitXXX methodsclient.submitLog("Test log");// Submit custom methods using our createXXX methodsclient.submitEvent(EventPluginContext.from(client.createLog("test-log").referenceId("test-reference-id").build()));    }}

Builder Pattern

We love our builders!!! This project heavily utilized the use of builders instead of traditional object creationusingnew. We do this with the help of Project Lombok's@Builder annotation. Read more about theprojecthere. Read more about theannotationhere. Read more about the builderpatternhere.

Example: Customizing your Event Queue implementation

EventQueueIF queue = //get your implementationConfiguration configuration = Configuration.builder()        .serverUrl("http://your-server-url")        .apiKey("your-api-key")        .queue(queue)        .build();ExceptionlessClient client = ExceptionlessClient.builder().configuration(configuration).build();

In this library we have made sure that all the values which are not set by builders fallback to reasonable defaults. Sodon't feel the pressure to supply values for all the fields.Note: Whenever customizing the clientusingConfiguration never forget to supply yourserverUrl andapiKey using aConfiguration object asshown above.

1. You will need to install:
   • Intellij
   • Note: In Intellij you can directlydownload JDK 11 from the IDE. Intellij also comes with a bundled Maven installation and built-in Lombok support.
2. Clone the repo
3. Verify your setup usingmvn clean verify

1. You will need to install:
   • VSCode
   • JDK 11. Make sure that yourjava --version and$JAVA_HOME environment variable point to the correct jdk.
   • VSCode Java extension pack
   • VSCode Lombok extension
2. Clone the repo
3. Verify your setup usingmvn clean verify

You can observeNoClassDefFoundError in your Spring-boot apps because Spring-boot uses v3 ofOkHttpClient while thisclient uses v4. In that case you have to explicitly declare v4 of the library in youpom.xml/build.gradle.

<dependencies>    <dependency>        <groupId>com.exceptionless</groupId>        <artifactId>exceptionless-client</artifactId>        <version>0.1.0</version>    </dependency>    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-web</artifactId>    </dependency><!-- EXPLICIT DECLARATION-->    <dependency>        <groupId>com.squareup.okhttp3</groupId>        <artifactId>okhttp</artifactId>        <version>4.9.1</version>    </dependency></dependencies>

We are usingProject Lombok to automatically generate a lot of code. Intellij can give you IntelliSense by default but for VSCode you may have to installthis extension.

By default the Exceptionless Client will report all available metadata including potential PII data. You can fine tunethe collection of information via Data Exclusions or turning off collection completely.

Please visitthedocsfor detailed information on how to configure the client to meet your requirements.

If you need help, please contact us via in-appsupport,open an issueorjoin our chat on Discord. We’re always here to help if you have any questions!

Thanks to all the people who have contributed!