wagoe.observability.logging.core — com.wagoe/wagoe-observability 1.0.0-beta-5

Core logging functions and utilities.

This namespace provides pure functions and higher-level abstractions over the logging protocols, making it easier for feature modules to perform common logging operations without dealing with protocol details directly.

audit-security-event clj

(audit-security-event audit-logger event-type severity details context)

Audit logs security events.

Args: audit-logger - IAuditLogger instance event-type - Security event type severity - Event severity details - Event details context - Additional context

Returns: nil

audit-system-event clj

(audit-system-event audit-logger system-id resource action result context)

Audit logs system events.

Args: audit-logger - IAuditLogger instance system-id - System/service identifier resource - Resource affected action - Action performed result - Action result context - Additional context

Returns: nil

audit-user-action clj

(audit-user-action audit-logger user-id resource action result context)

Audit logs user actions with full context.

Args: audit-logger - IAuditLogger instance user-id - User identifier resource - Resource acted upon action - Action taken result - Action result context - Additional context

Returns: nil

log-business-event clj

(log-business-event logger event-type entity details context)

Logs business domain events.

Args: logger - ILogger instance event-type - Type of business event entity - Business entity involved details - Event details context - Context map

Returns: nil

log-exception clj

(log-exception logger level message exception context)

Logs an exception with structured context.

Args: logger - ILogger instance level - Log level (:warn, :error, :fatal) message - Descriptive message exception - Exception/throwable context - Context map

Returns: nil

log-external-service-error clj

(log-external-service-error logger service-name operation error context)

Logs external service call errors.

Args: logger - ILogger instance service-name - Name of external service operation - Operation that failed error - Error information context - Context map

Returns: nil

log-function-entry clj

(log-function-entry logger fn-name args context)

Logs function entry with arguments.

Args: logger - ILogger instance fn-name - Function name string args - Function arguments context - Context map

Returns: nil

log-function-exit clj

(log-function-exit logger fn-name result context)

Logs function exit with result.

Args: logger - ILogger instance fn-name - Function name string result - Function result context - Context map

Returns: result (passed through)

log-performance-metric clj

(log-performance-metric logger metric-name value unit context)

Logs performance measurements.

Args: logger - ILogger instance metric-name - Name of the metric value - Metric value unit - Unit of measurement context - Context map

Returns: nil

log-request-metrics clj

(log-request-metrics logger method path status duration context)

Logs HTTP request performance metrics.

Args: logger - ILogger instance method - HTTP method path - Request path status - Response status duration - Request duration in ms context - Context map

Returns: nil

log-sampling clj

(log-sampling sample-rate logger level message context)

Logs with sampling rate.

Args: sample-rate - Sampling rate (0.0 to 1.0) logger - ILogger instance level - Log level message - Log message context - Context map

Returns: nil

log-user-action clj

(log-user-action logger user-id action resource result context)

Logs user actions for audit and analytics.

Args: logger - ILogger instance user-id - User identifier action - Action taken resource - Resource acted upon result - Action result context - Context map

Returns: nil

log-validation-error clj

(log-validation-error logger errors context)

Logs validation errors in a structured format.

Args: logger - ILogger instance errors - Validation error data context - Context map

Returns: nil

log-when clj

(log-when condition logger level message context)

Conditionally logs a message.

Args: condition - Boolean condition logger - ILogger instance level - Log level message - Log message context - Context map

Returns: nil

log-when-dev clj

(log-when-dev env logger level message context)

Logs only in development environment.

Args: env - Environment keyword logger - ILogger instance level - Log level message - Log message context - Context map

Returns: nil

log-with-timing clj

(log-with-timing logger level message context f)

Logs execution time of a function.

Args: logger - ILogger instance level - Log level keyword message - Log message context - Context map f - Function to time

Returns: Result of function f

merge-contexts clj

(merge-contexts & contexts)

Merges multiple context maps, with later maps taking precedence.

Args: contexts - Variable number of context maps

Returns: Merged context map

with-correlation-id clj

(with-correlation-id context correlation-id)

Adds or updates correlation ID in context.

Args: context - Existing context map correlation-id - Correlation ID string

Returns: Updated context map

with-function-logging clj

(with-function-logging logger fn-name context f & args)

Wraps a function with entry/exit logging.

Args: logger - ILogger instance fn-name - Function name string context - Context map f - Function to wrap & args - Arguments to pass to function

Returns: Result of function f

with-tags clj

(with-tags context tags)

Adds or merges tags in context.

Args: context - Existing context map tags - Map of tag key-value pairs

Returns: Updated context map

with-tenant-id clj

(with-tenant-id context tenant-id)

Adds or updates tenant ID in context.

Args: context - Existing context map tenant-id - Tenant ID string

Returns: Updated context map

with-trace-info clj

(with-trace-info context trace-id span-id)

Adds distributed tracing information to context.

Args: context - Existing context map trace-id - Trace ID string span-id - Span ID string

Returns: Updated context map

with-user-id clj

(with-user-id context user-id)

Adds or updates user ID in context.

Args: context - Existing context map user-id - User ID string

Returns: Updated context map