Java Logging Best Practices
Implement effective Java logging following standardized frameworks, meaningful log levels, core practices (parameterized logging, exception handling, no sensitive data), flexible configuration, security-conscious logging, monitoring and alerting, and comprehensive logging validation through testing.
What is covered in this Skill?
- Standardized framework selection: SLF4J facade with Logback or Log4j2
- Meaningful and consistent log levels: ERROR, WARN, INFO, DEBUG, TRACE
- Core practices: parameterized logging, proper exception handling, avoiding sensitive data
- Configuration: environment-specific (logback.xml, log4j2.xml), output formats, log rotation
- Security: mask sensitive data, control log access, secure transmission, GDPR/HIPAA compliance
- Log monitoring and alerting: centralized aggregation (ELK, Splunk, Loki), automated alerts
- Logging validation through testing: assert log messages, verify formats, test levels, measure performance impact
Scope: The reference is organized by examples (good/bad code patterns) for each core area. Apply recommendations based on applicable examples.
Constraints
Before applying any logging recommendations, ensure the project compiles. Compilation failure is a blocking condition. After applying improvements, run full verification.
- MANDATORY: Run
./mvnw compile or mvn compile before applying any change
- SAFETY: If compilation fails, stop immediately — do not proceed until resolved
- VERIFY: Run
./mvnw clean verify or mvn clean verify after applying improvements
- BEFORE APPLYING: Read the reference for detailed good/bad examples, constraints, and safeguards for each logging pattern
When to use this skill
- Improve logging
- Apply logging
- Refactor logging
- Add logging support
Workflow
- Compile project before logging changes
Run ./mvnw compile or mvn compile and stop immediately if compilation fails.
- Read logging reference and assess current observability
Read references/180-java-observability-logging.md and evaluate framework usage, log levels, sensitive-data handling, and config gaps.
- Apply logging and observability improvements
Implement selected framework/configuration/practice changes, including secure logging and monitoring integration where applicable.
- Verify with full build
Run ./mvnw clean verify or mvn clean verify after applying improvements.
Reference
For detailed guidance, examples, and constraints, see references/180-java-observability-logging.md.
1---2name: 180-java-observability-logging3description: Use when you need to implement or improve Java logging and observability — including selecting SLF4J with Logback/Log4j2, applying proper log levels (ERROR, WARN, INFO, DEBUG, TRACE), parameterized logging, secure logging without sensitive data exposure, environment-specific configuration, log aggregation and monitoring, or validating logging through tests. This should trigger for requests such as Improve logging; Apply logging; Refactor logging; Add logging support. Part of cursor-rules-java project4license: Apache-2.05---6# Java Logging Best Practices
7
8Implement effective Java logging following standardized frameworks, meaningful log levels, core practices (parameterized logging, exception handling, no sensitive data), flexible configuration, security-conscious logging, monitoring and alerting, and comprehensive logging validation through testing.
9
10**What is covered in this Skill?**
11
12- Standardized framework selection: SLF4J facade with Logback or Log4j2
13- Meaningful and consistent log levels: ERROR, WARN, INFO, DEBUG, TRACE
14- Core practices: parameterized logging, proper exception handling, avoiding sensitive data
15- Configuration: environment-specific (logback.xml, log4j2.xml), output formats, log rotation
16- Security: mask sensitive data, control log access, secure transmission, GDPR/HIPAA compliance
17- Log monitoring and alerting: centralized aggregation (ELK, Splunk, Loki), automated alerts
18- Logging validation through testing: assert log messages, verify formats, test levels, measure performance impact
19
20**Scope:** The reference is organized by examples (good/bad code patterns) for each core area. Apply recommendations based on applicable examples.
21
22## Constraints
23
24Before applying any logging recommendations, ensure the project compiles. Compilation failure is a blocking condition. After applying improvements, run full verification.
25
26- **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any change
27- **SAFETY**: If compilation fails, stop immediately — do not proceed until resolved
28- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements
29- **BEFORE APPLYING**: Read the reference for detailed good/bad examples, constraints, and safeguards for each logging pattern
30
31## When to use this skill
32
33- Improve logging
34- Apply logging
35- Refactor logging
36- Add logging support
37
38## Workflow
39
401. **Compile project before logging changes**
41
42Run `./mvnw compile` or `mvn compile` and stop immediately if compilation fails.
43
442. **Read logging reference and assess current observability**
45
46Read `references/180-java-observability-logging.md` and evaluate framework usage, log levels, sensitive-data handling, and config gaps.
47
483. **Apply logging and observability improvements**
49
50Implement selected framework/configuration/practice changes, including secure logging and monitoring integration where applicable.
51
524. **Verify with full build**
53
54Run `./mvnw clean verify` or `mvn clean verify` after applying improvements.
55
56## Reference
57
58For detailed guidance, examples, and constraints, see [references/180-java-observability-logging.md](references/180-java-observability-logging.md).
majiayu000