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 RollbarLogger's log method.
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 : bool
- $formatter : FormatterInterface|null
- $initialized : bool
- $level : Level
- $processors : array<string|int, callable>
- $rollbarLogger : RollbarLogger
- $hasRecords : bool
- Records whether any log records have been added since the last flush of the rollbar notifier
Methods
- __construct() : mixed
- __destruct() : mixed
- __sleep() : mixed
- close() : void
- Closes the handler.
- flush() : void
- getBubble() : bool
- Gets the bubbling behavior.
- getFormatter() : FormatterInterface
- getLevel() : Level
- Gets minimum logging level at which this handler will be triggered.
- handle() : bool
- Handles a record.
- handleBatch() : void
- Handles a set of records at once.
- isHandling() : bool
- Checks whether the given record will be handled by this handler.
- popProcessor() : callable
- pushProcessor() : HandlerInterface
- reset() : void
- setBubble() : $this
- Sets the bubbling behavior.
- setFormatter() : HandlerInterface
- setLevel() : $this
- Sets minimum logging level at which this handler will be triggered.
- getDefaultFormatter() : FormatterInterface
- Gets the default formatter.
- processRecord() : LogRecord
- resetProcessors() : void
- toRollbarLevel() : "debug"|"info"|"warning"|"error"|"critical"
- Translates Monolog log levels to Rollbar levels.
- write() : void
- Writes the (already formatted) record down to the log of the implementing handler
Properties
$bubble
protected
bool
$bubble
= true
$formatter
protected
FormatterInterface|null
$formatter
= null
$initialized
protected
bool
$initialized
= false
$level
protected
Level
$level
= \Monolog\Level::Debug
$processors
protected
array<string|int, callable>
$processors
= []
Tags
$rollbarLogger
protected
RollbarLogger
$rollbarLogger
$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(RollbarLogger $rollbarLogger[, int|string|Level $level = Level::Error ][, bool $bubble = true ]) : mixed
Parameters
- $rollbarLogger : RollbarLogger
-
RollbarLogger object constructed with valid token
- $level : int|string|Level = Level::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
__sleep()
public
__sleep() : mixed
close()
Closes the handler.
public
close() : void
Tags
flush()
public
flush() : void
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()
public
getFormatter() : FormatterInterface
Tags
Return values
FormatterInterfacegetLevel()
Gets minimum logging level at which this handler will be triggered.
public
getLevel() : Level
Return values
Levelhandle()
Handles a record.
public
handle(LogRecord $record) : bool
Parameters
- $record : LogRecord
-
The record to handle
Tags
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) : void
Parameters
- $records : array<string|int, mixed>
-
The records to handle
Tags
isHandling()
Checks whether the given record will be handled by this handler.
public
isHandling(LogRecord $record) : bool
Parameters
- $record : LogRecord
-
Partial log record having only a level initialized
Tags
Return values
boolpopProcessor()
public
popProcessor() : callable
Tags
Return values
callablepushProcessor()
public
pushProcessor(callable $callback) : HandlerInterface
Parameters
- $callback : callable
Tags
Return values
HandlerInterfacereset()
public
reset() : void
Tags
setBubble()
Sets the bubbling behavior.
public
setBubble(bool $bubble) : $this
Parameters
- $bubble : bool
-
true means that this handler allows bubbling. false means that bubbling is not permitted.
Return values
$thissetFormatter()
public
setFormatter(FormatterInterface $formatter) : HandlerInterface
Parameters
- $formatter : FormatterInterface
Tags
Return values
HandlerInterfacesetLevel()
Sets minimum logging level at which this handler will be triggered.
public
setLevel(Level|LogLevel::* $level) : $this
Parameters
- $level : Level|LogLevel::*
-
Level or level name
Tags
Return values
$thisgetDefaultFormatter()
Gets the default formatter.
protected
getDefaultFormatter() : FormatterInterface
Overwrite this if the LineFormatter is not a good default for your handler.
Return values
FormatterInterfaceprocessRecord()
protected
processRecord(LogRecord $record) : LogRecord
Parameters
- $record : LogRecord
Return values
LogRecordresetProcessors()
protected
resetProcessors() : void
toRollbarLevel()
Translates Monolog log levels to Rollbar levels.
protected
toRollbarLevel(Level $level) : "debug"|"info"|"warning"|"error"|"critical"
Parameters
- $level : Level
Return values
"debug"|"info"|"warning"|"error"|"critical"write()
Writes the (already formatted) record down to the log of the implementing handler
protected
write(LogRecord $record) : void
Parameters
- $record : LogRecord