ISpectLogException class base

Log entry produced when a Dart Exception is captured by the logger.

Serialized with key: ISpectLogType.exception.key and LogLevel.error. The original Exception is stored on ISpectLogData.exception and the optional stack trace on ISpectLogData.stackTrace.

Inheritance

• Object
• ISpectLogData
• ISpectLogException

Available extensions

• ISpectDataX
• ISpectLogDataSerialization
• ISpectLogDataX

Constructors

ISpectLogException(Exception exception, {String? message, StackTrace? stackTrace})

Creates an exception log entry wrapping exception with an optional human-readable message and stackTrace.

Properties

additionalData → Map<String, dynamic>?

final, inherited

authProvider → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

blocType → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

curlCommand → String?

Available on ISpectLogData, provided by the ISpectDataX extension

Generates a cURL command for HTTP logs, or null for non-HTTP entries.

no setter

dbArgs → List<Object?>?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

dbStatement → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

dbStatementDigest → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

error → Error?

final, inherited

errorText → String?

no setter, inherited

eventType → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

exception → Object?

final, inherited

exceptionText → String?

no setter, inherited

formattedTime → String

late, final, inherited

hashCode → int

The hash code for this object.

no setter, inherited

header → String

Single-line header for console output.

no setter, inherited

httpHeaders → Map<String, dynamic>?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

httpLogText → String?

Available on ISpectLogData, provided by the ISpectDataX extension

Error/exception message with special handling for HTTP and Flutter errors.

no setter

httpStatusCode → int?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

id → String

ULID-style identifier — globally unique across processes, isolates, and reloaded log files. Lexicographically sortable by creation time.

final, inherited

isAnalytics → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isAuth → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isDb → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isError → bool

no setter, inherited

isGraphql → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isGrpc → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isHttpLog → bool

Available on ISpectLogData, provided by the ISpectDataX extension

no setter

isNavigation → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isNetwork → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isPayment → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isPush → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isRouteLog → bool

Available on ISpectLogData, provided by the ISpectDataX extension

no setter

isSse → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isState → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isStorage → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

isWs → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

key → String?

final, inherited

logLevel → LogLevel?

final, inherited

lowerMessage → String?

Cached lowercase message for efficient repeated case-insensitive search.

late, final, inherited

message → String?

final, inherited

messageText → String

no setter, inherited

paymentAmount → double?

Available on ISpectLogData, provided by the ISpectLogDataX extension

NB: num check — JSON may return int (100) instead of double (100.0).

no setter

paymentCurrency → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

pen → AnsiPen?

final, inherited

pushTitle → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

pushTopic → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

requestId → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

stackTrace → StackTrace?

final, inherited

stackTraceLogText → String?

Available on ISpectLogData, provided by the ISpectDataX extension

Stack trace text for log display. Returns null if unavailable.

no setter

stackTraceText → String?

no setter, inherited

storageBucket → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

storageSizeBytes → int?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

textMessage → String

Full message including error/exception and stack trace.

no setter, override

time → DateTime

final, inherited

traceCategory → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceCorrelationId → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceDurationMs → int?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceMeta → Map<String, dynamic>?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceOperation → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceSlow → bool?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceSource → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceSuccess → bool?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceTarget → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

traceTransactionId → String?

Available on ISpectLogData, provided by the ISpectLogDataX extension

no setter

typeText → String?

Available on ISpectLogData, provided by the ISpectDataX extension

Exception/error runtime type label, or null for non-error logs.

no setter

Methods

copy() → ISpectLogData

Available on ISpectLogData, provided by the ISpectDataX extension

Identity-preserving copy: equal to the original under ==.

copyWith({Object? message, LogLevel? logLevel, Object? exception, Error? error, StackTrace? stackTrace, DateTime? time, AnsiPen? pen, String? key, Map<String, dynamic>? additionalData, String? id}) → ISpectLogData

Available on ISpectLogData, provided by the ISpectDataX extension

Returns a copy with the given fields replaced.

curlCommandWith({RedactionService? redactor}) → String?

Available on ISpectLogData, provided by the ISpectDataX extension

Like curlCommand, but routes headers and body through redactor when one is provided.

generateText() → String

Available on ISpectLogData, provided by the ISpectDataX extension

Truncated summary for debugging/display.

hasCategory(String categoryId) → bool

Available on ISpectLogData, provided by the ISpectLogDataX extension

Check any custom category: log.hasCategory('my-service')

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

notifyObserver(ISpectObserver observer) → void

Dispatches to the appropriate ISpectObserver callback. Subclasses override to route to onException etc.

override

toJson({bool truncated = false}) → Map<String, dynamic>

Available on ISpectLogData, provided by the ISpectLogDataSerialization extension

Converts the log data into a JSON representation.

toMarkdown({Set<String>? redactKeys}) → String

Available on ISpectLogData, provided by the ISpectLogDataSerialization extension

Markdown — for issue trackers, documentation.

toString() → String

A string representation of this object.

inherited

toText({Set<String>? redactKeys}) → String

Available on ISpectLogData, provided by the ISpectLogDataSerialization extension

Plain text — for sharing, copying, human reading.

Operators

operator ==(Object other) → bool

The equality operator.

inherited