com.rollbar.notifier

Class Rollbar

java.lang.Object

com.rollbar.notifier.Rollbar

public class Rollbar
extends java.lang.Object

This is the current Rollbar notifier and the main starting point to send the data to Rollbar.

Constructor Summary

Constructors

Constructor and Description
Rollbar(Config config) Constructor.

Method Summary

Modifier and Type	Method and Description
void	close(boolean wait)
void	configure(Config config) Replace the configuration of this instance directly.
void	configure(ConfigProvider configProvider) Replace the configuration of this instance.
void	critical(java.lang.String message) Record a critical message.
void	critical(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> custom) Record a critical message with extra information attached.
void	critical(java.lang.Throwable error) Record a critical error.
void	critical(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom) Record a critical error with extra information attached.
void	critical(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description) Record a critical error with custom parameters and human readable description.
void	critical(java.lang.Throwable error, java.lang.String description) Record a critical error with human readable description.
void	debug(java.lang.String message) Record a debugging message.
void	debug(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> custom) Record a debugging message with extra information attached.
void	debug(java.lang.Throwable error) Record an error as debugging information.
void	debug(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom) Record a debug error with extra information attached.
void	debug(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description) Record a debug error with custom parameters and human readable description.
void	debug(java.lang.Throwable error, java.lang.String description) Record a debug error with human readable description.
void	error(java.lang.String message) Record an error message.
void	error(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> custom) Record a error message with extra information attached.
void	error(java.lang.Throwable error) Record an error.
void	error(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom) Record an error with extra information attached.
void	error(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description) Record an error with custom parameters and human readable description.
void	error(java.lang.Throwable error, java.lang.String description) Record an error with human readable description.
void	handleUncaughtErrors() Handle all uncaught errors on current thread with this `Rollbar`.
void	handleUncaughtErrors(java.lang.Thread thread) Handle all uncaught errors on thread with this `Rollbar`.
void	info(java.lang.String message) Record an informational message.
void	info(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> custom) Record an informational message with extra information attached.
void	info(java.lang.Throwable error) Record an error as an info.
void	info(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom) Record an info error with extra information attached.
void	info(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description) Record an info error with custom parameters and human readable description.
void	info(java.lang.Throwable error, java.lang.String description) Record an info error with human readable description.
static Rollbar	init(Config config) Method to initialize the library managed notifier instance.
com.rollbar.api.payload.data.Level	level(java.lang.Throwable error) Get the level of the error or message.
void	log(java.lang.String message) Record a debugging message at the level returned by level(java.lang.Throwable) (WARNING unless level is overridden).
void	log(java.lang.String message, com.rollbar.api.payload.data.Level level) Record a message at the level specified.
void	log(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> custom) Record a message with extra information attached at the default level returned by level(java.lang.Throwable), (WARNING unless level overridden).
void	log(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> custom, com.rollbar.api.payload.data.Level level) Record a message with extra information attached at the specified level.
void	log(java.lang.Throwable error) Log an error at the level returned by level(java.lang.Throwable).
void	log(java.lang.Throwable error, com.rollbar.api.payload.data.Level level) Log an error at level specified.
void	log(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom) Record an error with extra information attached at the default level returned by level(java.lang.Throwable).
void	log(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, com.rollbar.api.payload.data.Level level) Record an error with extra information attached at the level specified.
void	log(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description) Record an error with custom parameters and human readable description at the default level returned by level(java.lang.Throwable).
void	log(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description, com.rollbar.api.payload.data.Level level) Record an error or message with extra data at the level specified.
void	log(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description, com.rollbar.api.payload.data.Level level, boolean isUncaught) Record an error or message with extra data at the level specified.
void	log(java.lang.Throwable error, java.lang.String description) Record an error with human readable description at the default level returned by level(java.lang.Throwable).
void	log(java.lang.Throwable error, java.lang.String description, com.rollbar.api.payload.data.Level level) Record a debug error with human readable description at the specified level.
void	log(ThrowableWrapper error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description, com.rollbar.api.payload.data.Level level, boolean isUncaught) Record an error or message with extra data at the level specified.
void	warning(java.lang.String message) Record a warning message.
void	warning(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> custom) Record a warning message with extra information attached.
void	warning(java.lang.Throwable error) Record an error as a warning.
void	warning(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom) Record a warning error with extra information attached.
void	warning(java.lang.Throwable error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description) Record a warning error with custom parameters and human readable description.
void	warning(java.lang.Throwable error, java.lang.String description) Record a warning with human readable description.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Rollbar

public Rollbar(Config config)

Constructor.

Parameters:

config - the configuration used by the notifier.

Method Detail

init

public static Rollbar init(Config config)

Method to initialize the library managed notifier instance.

Parameters:

config - the configuration.

Returns:

the library managed instance.

handleUncaughtErrors

public void handleUncaughtErrors()

Handle all uncaught errors on current thread with this `Rollbar`.

handleUncaughtErrors

public void handleUncaughtErrors(java.lang.Thread thread)

Handle all uncaught errors on thread with this `Rollbar`.

Parameters:

thread - the thread to handle errors on.

configure

public void configure(ConfigProvider configProvider)

Replace the configuration of this instance. This ConfigBuilder passed to configProvider is preconfigured with the values of the current configuration. This method potentially blocks to acquire a locks when safely work with the configuration.

Parameters:

configProvider - the provider of a new configuration

configure

public void configure(Config config)

Replace the configuration of this instance directly.

Parameters:

config - the new configuration.

critical

public void critical(java.lang.Throwable error)

Record a critical error.

Parameters:

error - the error.

critical

public void critical(java.lang.Throwable error,
                     java.lang.String description)

Record a critical error with human readable description.

Parameters:

error - the error.

description - human readable description of error.

critical

public void critical(java.lang.Throwable error,
                     java.util.Map<java.lang.String,java.lang.Object> custom)

Record a critical error with extra information attached.

Parameters:

error - the error.

custom - the extra information.

critical

public void critical(java.lang.String message)

Record a critical message.

Parameters:

message - the message.

critical

public void critical(java.lang.String message,
                     java.util.Map<java.lang.String,java.lang.Object> custom)

Record a critical message with extra information attached.

Parameters:

message - the message.

custom - the extra information.

critical

public void critical(java.lang.Throwable error,
                     java.util.Map<java.lang.String,java.lang.Object> custom,
                     java.lang.String description)

Record a critical error with custom parameters and human readable description.

Parameters:

error - the error.

custom - the custom data.

description - the human readable description of error.

error

public void error(java.lang.Throwable error)

Record an error.

Parameters:

error - the error.

error

public void error(java.lang.Throwable error,
                  java.lang.String description)

Record an error with human readable description.

Parameters:

error - the error.

description - human readable description of error.

error

public void error(java.lang.Throwable error,
                  java.util.Map<java.lang.String,java.lang.Object> custom)

Record an error with extra information attached.

Parameters:

error - the error.

custom - the extra information.

error

public void error(java.lang.String message)

Record an error message.

Parameters:

message - the message.

error

public void error(java.lang.String message,
                  java.util.Map<java.lang.String,java.lang.Object> custom)

Record a error message with extra information attached.

Parameters:

message - the message.

custom - the extra information.

error

public void error(java.lang.Throwable error,
                  java.util.Map<java.lang.String,java.lang.Object> custom,
                  java.lang.String description)

Record an error with custom parameters and human readable description.

Parameters:

error - the error.

custom - the custom data.

description - the human readable description of error.

warning

public void warning(java.lang.Throwable error)

Record an error as a warning.

Parameters:

error - the error.

warning

public void warning(java.lang.Throwable error,
                    java.lang.String description)

Record a warning with human readable description.

Parameters:

error - the error.

description - human readable description of error.

warning

public void warning(java.lang.Throwable error,
                    java.util.Map<java.lang.String,java.lang.Object> custom)

Record a warning error with extra information attached.

Parameters:

error - the error.

custom - the extra information.

warning

public void warning(java.lang.String message)

Record a warning message.

Parameters:

message - the message.

warning

public void warning(java.lang.String message,
                    java.util.Map<java.lang.String,java.lang.Object> custom)

Record a warning message with extra information attached.

Parameters:

message - the message.

custom - the extra information.

warning

public void warning(java.lang.Throwable error,
                    java.util.Map<java.lang.String,java.lang.Object> custom,
                    java.lang.String description)

Record a warning error with custom parameters and human readable description.

Parameters:

error - the error.

custom - the custom data.

description - the human readable description of error.

info

public void info(java.lang.Throwable error)

Record an error as an info.

Parameters:

error - the error.

info

public void info(java.lang.Throwable error,
                 java.lang.String description)

Record an info error with human readable description.

Parameters:

error - the error.

description - human readable description of error.

info

public void info(java.lang.Throwable error,
                 java.util.Map<java.lang.String,java.lang.Object> custom)

Record an info error with extra information attached.

Parameters:

error - the error.

custom - the extra information.

info

public void info(java.lang.String message)

Record an informational message.

Parameters:

message - the message.

info

public void info(java.lang.String message,
                 java.util.Map<java.lang.String,java.lang.Object> custom)

Record an informational message with extra information attached.

Parameters:

message - the message.

custom - the extra information.

info

public void info(java.lang.Throwable error,
                 java.util.Map<java.lang.String,java.lang.Object> custom,
                 java.lang.String description)

Record an info error with custom parameters and human readable description.

Parameters:

error - the error.

custom - the custom data.

description - the human readable description of error.

debug

public void debug(java.lang.Throwable error)

Record an error as debugging information.

Parameters:

error - the error.

debug

public void debug(java.lang.Throwable error,
                  java.lang.String description)

Record a debug error with human readable description.

Parameters:

error - the error.

description - human readable description of error.

debug

public void debug(java.lang.Throwable error,
                  java.util.Map<java.lang.String,java.lang.Object> custom)

Record a debug error with extra information attached.

Parameters:

error - the error.

custom - the extra information.

debug

public void debug(java.lang.String message)

Record a debugging message.

Parameters:

message - the message.

debug

public void debug(java.lang.String message,
                  java.util.Map<java.lang.String,java.lang.Object> custom)

Record a debugging message with extra information attached.

Parameters:

message - the message.

custom - the extra information.

debug

public void debug(java.lang.Throwable error,
                  java.util.Map<java.lang.String,java.lang.Object> custom,
                  java.lang.String description)

Record a debug error with custom parameters and human readable description.

Parameters:

error - the error.

custom - the custom data.

description - the human readable description of error.

log

public void log(java.lang.Throwable error)

Log an error at the level returned by level(java.lang.Throwable).

Parameters:

error - the error.

log

public void log(java.lang.Throwable error,
                java.lang.String description)

Record an error with human readable description at the default level returned by level(java.lang.Throwable).

Parameters:

error - the error.

description - human readable description of error.

log

public void log(java.lang.Throwable error,
                java.util.Map<java.lang.String,java.lang.Object> custom)

Record an error with extra information attached at the default level returned by level(java.lang.Throwable).

Parameters:

error - the error.

custom - the extra information.

log

public void log(java.lang.Throwable error,
                java.util.Map<java.lang.String,java.lang.Object> custom,
                com.rollbar.api.payload.data.Level level)

Record an error with extra information attached at the level specified.

Parameters:

error - the error.

custom - the extra information.

level - the level.

log

public void log(java.lang.Throwable error,
                com.rollbar.api.payload.data.Level level)

Log an error at level specified.

Parameters:

error - the error.

level - the level of the error.

log

public void log(java.lang.Throwable error,
                java.lang.String description,
                com.rollbar.api.payload.data.Level level)

Record a debug error with human readable description at the specified level.

Parameters:

error - the error.

description - human readable description of error.

level - the level.

log

public void log(java.lang.Throwable error,
                java.util.Map<java.lang.String,java.lang.Object> custom,
                java.lang.String description)

Record an error with custom parameters and human readable description at the default level returned by level(java.lang.Throwable).

Parameters:

error - the error.

custom - the custom data.

description - the human readable description of error.

log

public void log(java.lang.String message)

Record a debugging message at the level returned by level(java.lang.Throwable) (WARNING unless level is overridden).

Parameters:

message - the message.

log

public void log(java.lang.String message,
                java.util.Map<java.lang.String,java.lang.Object> custom)

Record a message with extra information attached at the default level returned by level(java.lang.Throwable), (WARNING unless level overridden).

Parameters:

message - the message.

custom - the extra information.

log

public void log(java.lang.String message,
                com.rollbar.api.payload.data.Level level)

Record a message at the level specified.

Parameters:

message - the message.

level - the level.

log

public void log(java.lang.String message,
                java.util.Map<java.lang.String,java.lang.Object> custom,
                com.rollbar.api.payload.data.Level level)

Record a message with extra information attached at the specified level.

Parameters:

message - the message.

custom - the extra information.

level - the level.

log

public void log(java.lang.Throwable error,
                java.util.Map<java.lang.String,java.lang.Object> custom,
                java.lang.String description,
                com.rollbar.api.payload.data.Level level)

Record an error or message with extra data at the level specified. At least ene of `error` or `description` must be non-null. If error is null, `description` will be sent as a message. If error is non-null, description will be sent as the description of the error. Custom data will be attached to message if the error is null. Custom data will extend whatever Config.custom() returns.

Parameters:

error - the error (if any).

custom - the custom data (if any).

description - the description of the error, or the message to send.

level - the level to send it at.

log

public void log(java.lang.Throwable error,
                java.util.Map<java.lang.String,java.lang.Object> custom,
                java.lang.String description,
                com.rollbar.api.payload.data.Level level,
                boolean isUncaught)

Record an error or message with extra data at the level specified. At least ene of `error` or `description` must be non-null. If error is null, `description` will be sent as a message. If error is non-null, description will be sent as the description of the error. Custom data will be attached to message if the error is null. Custom data will extend whatever Config.custom() returns.

Parameters:

error - the error (if any).

custom - the custom data (if any).

description - the description of the error, or the message to send.

level - the level to send it at.

isUncaught - whether or not this data comes from an uncaught exception.

log

public void log(ThrowableWrapper error,
                java.util.Map<java.lang.String,java.lang.Object> custom,
                java.lang.String description,
                com.rollbar.api.payload.data.Level level,
                boolean isUncaught)

Record an error or message with extra data at the level specified. At least ene of `error` or `description` must be non-null. If error is null, `description` will be sent as a message. If error is non-null, description will be sent as the description of the error. Custom data will be attached to message if the error is null. Custom data will extend whatever Config.custom() returns.

Parameters:

error - the error (if any).

custom - the custom data (if any).

description - the description of the error, or the message to send.

level - the level to send it at.

isUncaught - whether or not this data comes from an uncaught exception.

level

public com.rollbar.api.payload.data.Level level(java.lang.Throwable error)

Get the level of the error or message. By default: CRITICAL for Error, ERROR for other Throwable, WARNING for messages. Override to change this default.

Parameters:

error - the error.

Returns:

the level.

close

public void close(boolean wait)
           throws java.lang.Exception

Throws:

java.lang.Exception