LOG_Builder.LogEntry
Class · Group: Logging
Learn it: Fast Start - Logging and Logging guide
global inherited sharing class LOG_Builder.LogEntryFluent builder for constructing rich log entries with context. Provides a chainable API for setting log level, location, record association, and contextual metadata before emitting the log.
Example
LOG_Builder.build()
.error(caughtException)
.at('PaymentService.charge')
.forRecord(paymentId)
.withContext('amount', payment.Amount__c)
.emit();Methods
| Method | Description |
|---|---|
| global LOG_Builder.LogEntry at(String classMethod) | Sets the originating class and method for the log entry. |
| global LOG_Builder.LogEntry debug(List<String> messages) | Sets the log level to DEBUG with the given batch of messages. |
| global LOG_Builder.LogEntry debug(String message) | Sets the log level to DEBUG with the given message. |
| global void emit() | Emits the log entry with all configured properties. |
| global void emitAt(String classMethod) | A shortcut that sets the class and method and emits the entry in one call. |
| global LOG_Builder.LogEntry error(Exception error) | Sets the log level to ERROR with the given exception. |
| global LOG_Builder.LogEntry error(List<String> messages) | Sets the log level to ERROR with the given batch of messages. |
| global LOG_Builder.LogEntry error(String message) | Sets the log level to ERROR with the given message. |
| global LOG_Builder.LogEntry forRecord(Id recordId) | Associates a record ID with the log entry. |
| global LOG_Builder.LogEntry forRecord(String recordId) | Associates a record ID (as String) with the log entry. |
| global LOG_Builder.LogEntry info(List<String> messages) | Sets the log level to INFO with the given batch of messages. |
| global LOG_Builder.LogEntry info(String message) | Sets the log level to INFO with the given message. |
| global LOG_Builder.LogEntry warn(List<String> messages) | Sets the log level to WARN with the given batch of messages. |
| global LOG_Builder.LogEntry warn(String message) | Sets the log level to WARN with the given message. |
| global LOG_Builder.LogEntry withContext(String key, Object value) | Adds a context key-value pair to this log entry. |
| global LOG_Builder.LogEntry withFingerprint(String key) | Sets a grouping fingerprint for this entry, which turns on flood control. |
| global LOG_Builder.LogEntry withSummary(String shortMessage) | Sets a brief summary message for the log entry. |
at
global LOG_Builder.LogEntry at(String classMethod)Sets the originating class and method for the log entry.
Parameters
| Parameter | Type | Description |
|---|---|---|
classMethod | String | The class and method in format 'ClassName.methodName' |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
debug
global LOG_Builder.LogEntry debug(List<String> messages)Sets the log level to DEBUG with the given batch of messages.
Parameters
| Parameter | Type | Description |
|---|---|---|
messages | List | The debug messages to log |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
global LOG_Builder.LogEntry debug(String message)Sets the log level to DEBUG with the given message.
Parameters
| Parameter | Type | Description |
|---|---|---|
message | String | The debug message |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
emit
global void emit()Emits the log entry with all configured properties. Any per-entry context is temporarily set as global context for the duration of the log call, then cleaned up to prevent leaking into subsequent logs.
emitAt
global void emitAt(String classMethod)A shortcut that sets the class and method and emits the entry in one call. Equivalent to .at(classMethod).emit().
Parameters
| Parameter | Type | Description |
|---|---|---|
classMethod | String | The class and method in format 'ClassName.methodName' |
Example
LOG_Builder.build().error(caughtException).emitAt('PaymentService.charge');error
global LOG_Builder.LogEntry error(Exception error)Sets the log level to ERROR with the given exception.
Parameters
| Parameter | Type | Description |
|---|---|---|
error | Exception | The exception to log |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
global LOG_Builder.LogEntry error(List<String> messages)Sets the log level to ERROR with the given batch of messages.
Parameters
| Parameter | Type | Description |
|---|---|---|
messages | List | The error messages to log |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
global LOG_Builder.LogEntry error(String message)Sets the log level to ERROR with the given message.
Parameters
| Parameter | Type | Description |
|---|---|---|
message | String | The error message |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
forRecord
global LOG_Builder.LogEntry forRecord(Id recordId)Associates a record ID with the log entry.
Parameters
| Parameter | Type | Description |
|---|---|---|
recordId | Id | The related record ID |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
global LOG_Builder.LogEntry forRecord(String recordId)Associates a record ID (as String) with the log entry.
Parameters
| Parameter | Type | Description |
|---|---|---|
recordId | String | String representation of the related record ID |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
info
global LOG_Builder.LogEntry info(List<String> messages)Sets the log level to INFO with the given batch of messages.
Parameters
| Parameter | Type | Description |
|---|---|---|
messages | List | The informational messages to log |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
global LOG_Builder.LogEntry info(String message)Sets the log level to INFO with the given message.
Parameters
| Parameter | Type | Description |
|---|---|---|
message | String | The informational message |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
warn
global LOG_Builder.LogEntry warn(List<String> messages)Sets the log level to WARN with the given batch of messages.
Parameters
| Parameter | Type | Description |
|---|---|---|
messages | List | The warning messages to log |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
global LOG_Builder.LogEntry warn(String message)Sets the log level to WARN with the given message.
Parameters
| Parameter | Type | Description |
|---|---|---|
message | String | The warning message |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
withContext
global LOG_Builder.LogEntry withContext(String key, Object value)Adds a context key-value pair to this log entry. Context is scoped to this entry only and does not affect other logs.
Complex types (Maps, Lists, SObjects) are turned into JSON automatically inside LOG_Engine.setGlobalContext. Callers MUST NOT turn them into JSON first with JSON.serialize(value), or the value is encoded twice. Pass the value object directly and let the engine decide how to store it. Use the LOG_Engine.CONTEXT_* constants for key instead of your own text, so that log entries from every part of the framework use the same key names and can be searched together.
Parameters
| Parameter | Type | Description |
|---|---|---|
key | String | The context key (use a LOG_Engine.CONTEXT_* constant where one exists). |
value | Object | The context value (any type; auto-serialised when complex). |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
withFingerprint
global LOG_Builder.LogEntry withFingerprint(String key)Sets a grouping fingerprint for this entry, which turns on flood control. Flood control stops the same event from filling the log: the first time the event happens it is saved as a full detail row, and repeats are added up in one counter row per day. Use a key that names the kind of event and never changes (e.g. 'payment-retry-loop'). Never use data that changes each time, such as record ids or timestamps: that would make every entry unique and produce MORE rows than plain logging. Keys are trimmed. Keys longer than 200 characters, or starting with the reserved 'bypass:' prefix, are replaced by their SHA-256 hash. When a key is hashed, the original key is saved in this entry's context (LOG_Engine.CONTEXT_FINGERPRINT_SOURCE), so you can still match the stored hash to the key you supplied.
Parameters
| Parameter | Type | Description |
|---|---|---|
key | String | The stable grouping key. |
Returns LOG_Builder.LogEntry — This LogEntry for chaining
Example
LOG_Builder.build().warn('Retry failed').withFingerprint('order-sync-retry').emitAt('OrderSync.run');withSummary
global LOG_Builder.LogEntry withSummary(String shortMessage)Sets a brief summary message for the log entry. On an entry that carries an exception, the summary becomes the short message and the exception's text stays the message.
Parameters
| Parameter | Type | Description |
|---|---|---|
shortMessage | String | The summary message |
Returns LOG_Builder.LogEntry — This LogEntry for chaining