Skip to content

v0.1

Choose a tag to compare

@henrikrexed henrikrexed released this 19 Nov 15:45
· 5 commits to main since this release

Core Functionality

  • Security Event Exporter: Transforms OpenTelemetry logs into structured security events as JSON payloads
  • Event Batching: Efficiently batches multiple events in a single HTTP POST request for optimal performance
  • Telemetry Metrics: Built-in metrics for monitoring:
    • Logs received count
    • Events exported count
    • Events failed count
    • Conversion errors count
    • HTTP requests count and durations
    • HTTP errors count
  • Comprehensive Logging: Debug and error logging enabled via OpenTelemetry telemetry with configurable log levels
  • Production Ready: Includes retry logic, error handling, timeout management, and comprehensive testing

Configuration Options

  • HTTP Endpoint Configuration: Configurable endpoint for security event delivery
  • Custom Headers: Support for API tokens and custom HTTP headers (e.g., Authorization, X-API-Key)
  • Default Attributes: Add default attributes to all security events
  • Timeout Management: Configurable HTTP request timeout (default: 30 seconds)
  • Retry Settings: Configurable retry behavior for failed requests
  • Queue Settings: Configurable queue behavior for batching

Data Transformation

  • Converts OpenTelemetry log records to security event format
  • Preserves resource attributes (prefixed with resource.)
  • Preserves log attributes (prefixed with attributes.)
  • Includes trace and span context when available
  • Includes severity information and timestamps
  • Supports both string and byte message bodies

📚 Documentation