com.rollbar.notifier

Class Rollbar

java.lang.Object

com.rollbar.notifier.RollbarBase<java.lang.Void,Config>

com.rollbar.notifier.Rollbar

public class Rollbar
extends RollbarBase<java.lang.Void,Config>

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

Field Summary

Fields inherited from class com.rollbar.notifier.RollbarBase

bodyFactory, config, configReadLock, configReadWriteLock, configWriteLock, payloadTruncator

Constructor Summary

Constructors

Constructor and Description
Rollbar(Config config) Constructor.

Method Summary

Modifier and Type	Method and Description
void	close(boolean wait)
Config	config() Get the current config.
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 custom data 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 custom data 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 data 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 custom data 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 custom data 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 data 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 custom data 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 custom data 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 data 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 custom data 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 custom data 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 data 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(Config config, 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(com.rollbar.notifier.config.Config, 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 custom data attached at the default level returned by level(com.rollbar.notifier.config.Config, 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 custom data attached at the specified level.
void	log(java.lang.Throwable error) Log an error at the level returned by level(com.rollbar.notifier.config.Config, 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 custom data attached at the default level returned by level(com.rollbar.notifier.config.Config, 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 custom data 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 data and human readable description at the default level returned by level(com.rollbar.notifier.config.Config, 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(com.rollbar.notifier.config.Config, 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	sendJsonPayload(java.lang.String json) Send JSON payload.
protected java.lang.Void	sendPayload(Config config, com.rollbar.api.payload.Payload payload)
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 custom data 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 custom data 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 data 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 com.rollbar.notifier.RollbarBase

buildData, level, process, processAppPackages, wrapThrowable

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.

Overrides:

configure in class RollbarBase<java.lang.Void,Config>

Parameters:

config - the new configuration.

level

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

Get the level of the error or message. The Config passed in contains the defaults to use for the cases of an Error, Throwable, or a Message. The default in the Config if otherwise left unspecified is: CRITICAL for Error, ERROR for other Throwable, WARNING for messages. Use the methods on ConfigBuilder to change these defaults

Parameters:

config - the current Config.

error - the error.

Returns:

the level.

config

public Config config()

Get the current config.

Returns:

the config.

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 custom data attached.

Parameters:

error - the error.

custom - the custom data.

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 custom data attached.

Parameters:

message - the message.

custom - the custom data.

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 data 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 custom data attached.

Parameters:

error - the error.

custom - the custom data.

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 custom data attached.

Parameters:

message - the message.

custom - the custom data.

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 data 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 custom data attached.

Parameters:

error - the error.

custom - the custom data.

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 custom data attached.

Parameters:

message - the message.

custom - the custom data.

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 data 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 custom data attached.

Parameters:

error - the error.

custom - the custom data.

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 custom data attached.

Parameters:

message - the message.

custom - the custom data.

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 data 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 custom data attached.

Parameters:

error - the error.

custom - the custom data.

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 custom data attached.

Parameters:

message - the message.

custom - the custom data.

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 data 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(com.rollbar.notifier.config.Config, 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(com.rollbar.notifier.config.Config, 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 custom data attached at the default level returned by level(com.rollbar.notifier.config.Config, java.lang.Throwable).

Parameters:

error - the error.

custom - the custom data.

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 custom data attached at the level specified.

Parameters:

error - the error.

custom - the custom data.

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 data and human readable description at the default level returned by level(com.rollbar.notifier.config.Config, 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(com.rollbar.notifier.config.Config, 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 custom data attached at the default level returned by level(com.rollbar.notifier.config.Config, java.lang.Throwable), (WARNING unless level overridden).

Parameters:

message - the message.

custom - the custom data.

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 custom data attached at the specified level.

Parameters:

message - the message.

custom - the custom data.

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 CommonConfig.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 CommonConfig.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 CommonConfig.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.

close

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

Throws:

java.lang.Exception

sendJsonPayload

public void sendJsonPayload(java.lang.String json)

Send JSON payload.

Parameters:

json - the json payload.

sendPayload

protected java.lang.Void sendPayload(Config config,
                                     com.rollbar.api.payload.Payload payload)

Specified by:

sendPayload in class RollbarBase<java.lang.Void,Config>