Package cloud.opencode.base.log.marker

package cloud.opencode.base.log.marker
Log Markers - Log Event Categorization 日志标记 - 日志事件分类

This package provides marker support for categorizing and filtering log events. Markers allow semantic tagging of log messages for better organization and filtering.

本包提供标记支持，用于分类和过滤日志事件。 标记允许对日志消息进行语义标记，以便更好地组织和过滤。

Key Classes | 核心类

  • Marker - Marker interface
  • Markers - Marker factory and predefined markers

Predefined Markers | 预定义标记

  • SECURITY - Security-related events (login, access control)
  • PERFORMANCE - Performance-related events (slow queries)
  • AUDIT - Audit events (data changes, compliance)
  • BUSINESS - Business logic events
  • SYSTEM - System events (startup, shutdown)
  • DATABASE - Database operations
  • NETWORK - Network operations

Usage Examples | 使用示例

// Using predefined markers
log.info(Markers.SECURITY, "User {} logged in from {}", userId, ip);
log.warn(Markers.PERFORMANCE, "Slow query detected: {}ms", duration);
log.info(Markers.AUDIT, "Data updated by {}", userId);

// Creating custom markers
Marker customMarker = Markers.getMarker("PAYMENT");
log.info(customMarker, "Payment processed: {}", transactionId);

// Marker hierarchy
Marker parent = Markers.getMarker("TRANSACTION");
Marker child = Markers.getMarker("PAYMENT");
parent.add(child);
// child.contains(parent) returns true

Filtering by Marker | 按标记过滤

Configure your logging framework to filter by marker:

<!-- Logback example -->
<filter class="ch.qos.logback.core.filter.EvaluatorFilter">
    <evaluator class="ch.qos.logback.classic.boolex.OnMarkerEvaluator">
        <marker>SECURITY</marker>
    </evaluator>
    <onMatch>ACCEPT</onMatch>
</filter>
Since:
JDK 25, opencode-base-log V1.0.0
Author:
OpenCode Cloud Group
See Also:
  • Class
    Description
    Marker
    Marker Interface - Log Event Marker 标记接口 - 日志事件标记
    Markers
    Markers - Marker Factory and Predefined Markers 标记工厂和预定义标记