Exceptionless.Java

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

Using Exceptionless

Refer to the Exceptionless documentation here: Exceptionless Docs.

Warning! This package is still in Beta and not yet published to Maven Central. If you need it right now feel free to contact us on Discord or create an Issue

Show me the code

class ExampleApp {
    public static void main(String[] args) {
        private static final ExceptionlessClient client =
                ExceptionlessClient.from(
                        System.getenv("EXCEPTIONLESS_SAMPLE_APP_API_KEY"),
                        System.getenv("EXCEPTIONLESS_SAMPLE_APP_SERVER_URL"));

        // Submit different events using submitXXX methods
        client.submitLog("Test log");

        // Submit custom methods using our createXXX methods
        client.submitEvent(
                EventPluginContext.from(
                        client.createLog("test-log").referenceId("test-reference-id").build()));

        // Submit async events using submitXXXAsync methods
        client.submitLogAsync("Test log");
    }
}

Builder Pattern

We love our builders!!! This project heavily utilized the use of builders instead of traditional object creation using new. We do this with the help of Project Lombok's @Builder annotation. Read more about the project here. Read more about the annotation here. Read more about the builder pattern here.

Example: Customizing your Event Queue implementation

EventQueueIF queue = //get your implementation
Configuration 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. So don't feel the pressure to supply values for all the fields. Note: Whenever customizing the client using Configuration never forget to supply your serverUrl and apiKey using a Configuration object as shown above.

Spring Boot Users

You can observe NoClassDefFoundError in your Spring-boot apps because Spring-boot uses v3 of OkHttpClient while this client uses v4. In that case you have to explicitly declare v4 of the library in you pom.xml/build.gradle.

<dependencies>
    <dependency>
        <groupId>com.exceptionless</groupId>
        <artifactId>exceptionless-client</artifactId>
        <version>1.0-beta1</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>

General Data Protection Regulation

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

Please visit the docs for detailed information on how to configure the client to meet your requirements.

Support

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

Thanks

Thanks to all the people who have contributed!