RollbarHandler
extends AbstractProcessingHandler
in package
Sends errors to Rollbar
If the context data contains a payload key, that is used as an array
of payload options to RollbarNotifier's report_message/report_exception methods.
Rollbar's context info will contain the context + extra keys from the log record merged, and then on top of that a few keys:
- level (rollbar level name)
- monolog_level (monolog level name, raw level, as rollbar only has 5 but monolog 8)
- channel
- datetime (unix timestamp)
Tags
Table of Contents
Properties
- $bubble : mixed
- $formatter : FormatterInterface
- $initialized : mixed
- $level : mixed
- $levelMap : mixed
- $processors : mixed
- $rollbarNotifier : RollbarNotifier
- Rollbar notifier
- $hasRecords : bool
- Records whether any log records have been added since the last flush of the rollbar notifier
Methods
- __construct() : mixed
- __destruct() : mixed
- close() : mixed
- Closes the handler.
- flush() : mixed
- getBubble() : bool
- Gets the bubbling behavior.
- getFormatter() : FormatterInterface
- Gets the formatter.
- getLevel() : int
- Gets minimum logging level at which this handler will be triggered.
- handle() : bool
- Handles a record.
- handleBatch() : mixed
- Handles a set of records at once.
- isHandling() : bool
- Checks whether the given record will be handled by this handler.
- popProcessor() : callable
- Removes the processor on top of the stack and returns it.
- pushProcessor() : self
- Adds a processor in the stack.
- reset() : mixed
- setBubble() : self
- Sets the bubbling behavior.
- setFormatter() : self
- Sets the formatter.
- setLevel() : self
- Sets minimum logging level at which this handler will be triggered.
- getDefaultFormatter() : FormatterInterface
- Gets the default formatter.
- processRecord() : array<string|int, mixed>
- Processes a record.
- write() : void
- Writes the record down to the log of the implementing handler
Properties
$bubble
protected
mixed
$bubble
= true
$formatter
protected
FormatterInterface
$formatter
$initialized
protected
mixed
$initialized
= false
$level
protected
mixed
$level
= \Monolog\Logger::DEBUG
$levelMap
protected
mixed
$levelMap
= array(\Monolog\Logger::DEBUG => 'debug', \Monolog\Logger::INFO => 'info', \Monolog\Logger::NOTICE => 'info', \Monolog\Logger::WARNING => 'warning', \Monolog\Logger::ERROR => 'error', \Monolog\Logger::CRITICAL => 'critical', \Monolog\Logger::ALERT => 'critical', \Monolog\Logger::EMERGENCY => 'critical')
$processors
protected
mixed
$processors
= array()
$rollbarNotifier
Rollbar notifier
protected
RollbarNotifier
$rollbarNotifier
$hasRecords
Records whether any log records have been added since the last flush of the rollbar notifier
private
bool
$hasRecords
= false
Methods
__construct()
public
__construct(RollbarNotifier $rollbarNotifier[, int $level = Logger::ERROR ][, bool $bubble = true ]) : mixed
Parameters
- $rollbarNotifier : RollbarNotifier
-
RollbarNotifier object constructed with valid token
- $level : int = Logger::ERROR
-
The minimum logging level at which this handler will be triggered
- $bubble : bool = true
-
Whether the messages that are handled can bubble up the stack or not
__destruct()
public
__destruct() : mixed
close()
Closes the handler.
public
close() : mixed
flush()
public
flush() : mixed
getBubble()
Gets the bubbling behavior.
public
getBubble() : bool
Return values
bool —true means that this handler allows bubbling. false means that bubbling is not permitted.
getFormatter()
Gets the formatter.
public
getFormatter() : FormatterInterface
Return values
FormatterInterfacegetLevel()
Gets minimum logging level at which this handler will be triggered.
public
getLevel() : int
Return values
inthandle()
Handles a record.
public
handle(array<string|int, mixed> $record) : bool
Parameters
- $record : array<string|int, mixed>
-
The record to handle
Return values
bool —true means that this handler handled the record, and that bubbling is not permitted. false means the record was either not processed or that this handler allows bubbling.
handleBatch()
Handles a set of records at once.
public
handleBatch(array<string|int, mixed> $records) : mixed
Parameters
- $records : array<string|int, mixed>
-
The records to handle (an array of record arrays)
isHandling()
Checks whether the given record will be handled by this handler.
public
isHandling(array<string|int, mixed> $record) : bool
Parameters
- $record : array<string|int, mixed>
-
Partial log record containing only a level key
Return values
boolpopProcessor()
Removes the processor on top of the stack and returns it.
public
popProcessor() : callable
Return values
callablepushProcessor()
Adds a processor in the stack.
public
pushProcessor(mixed $callback) : self
Parameters
- $callback : mixed
Return values
selfreset()
public
reset() : mixed
setBubble()
Sets the bubbling behavior.
public
setBubble(bool $bubble) : self
Parameters
- $bubble : bool
-
true means that this handler allows bubbling. false means that bubbling is not permitted.
Return values
selfsetFormatter()
Sets the formatter.
public
setFormatter(FormatterInterface $formatter) : self
Parameters
- $formatter : FormatterInterface
Return values
selfsetLevel()
Sets minimum logging level at which this handler will be triggered.
public
setLevel(int|string $level) : self
Parameters
- $level : int|string
-
Level or level name
Return values
selfgetDefaultFormatter()
Gets the default formatter.
protected
getDefaultFormatter() : FormatterInterface
Return values
FormatterInterfaceprocessRecord()
Processes a record.
protected
processRecord(array<string|int, mixed> $record) : array<string|int, mixed>
Parameters
- $record : array<string|int, mixed>
Return values
array<string|int, mixed>write()
Writes the record down to the log of the implementing handler
protected
write(array<string|int, mixed> $record) : void
Parameters
- $record : array<string|int, mixed>