docs: Add detailed explanation of Spring Boot management configuration

Add comprehensive documentation section explaining:
- Endpoints configuration (exposure, base-path)
- Health endpoint (show-details, probes for Kubernetes)
- Prometheus configuration (access control, export)
- Metrics configuration (tags, percentiles-histogram)
- Distributed tracing (sampling probability, Zipkin endpoint)
- Logging pattern (traceId/spanId integration)
- Production best practices

Includes:
- Code examples with YAML configuration
- Output examples (JSON, Prometheus format, logs)
- PromQL query examples for Grafana
- Security considerations
- Comparison with default Spring Boot patterns

Author: claude

docs/observability.md

@@ -91,6 +91,207 @@ Application expose các endpoints sau:
 - `/actuator/env` - Environment properties
 - `/actuator/loggers` - Log levels configuration
 
+### Spring Boot Management Configuration
+
+Cấu hình chi tiết trong `src/main/resources/application.yml`:
+
+#### 1. Endpoints Configuration
+
+```yaml
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,info,prometheus,metrics,env,loggers
+      base-path: /actuator
+```
+
+**`exposure.include`**: Danh sách endpoints được expose qua HTTP
+- `health` - Kiểm tra sức khỏe app (database, disk space, etc.)
+- `info` - Thông tin về application
+- `prometheus` - Metrics theo Prometheus format
+- `metrics` - Tất cả metrics có sẵn
+- `env` - Environment variables và properties
+- `loggers` - Xem và thay đổi log levels động
+
+**Mặc định**: Spring Boot chỉ expose `health` và `info`
+
+**Lưu ý bảo mật**: Không expose tất cả endpoints ở production. Chỉ expose những gì cần thiết và xem xét thêm authentication.
+
+**`base-path`**: Prefix cho tất cả actuator endpoints (default: `/actuator`)
+
+#### 2. Health Endpoint
+
+```yaml
+endpoint:
+  health:
+    show-details: always
+    probes:
+      enabled: true
+```
+
+**`show-details`**: Mức độ chi tiết hiển thị
+- `never` - Chỉ hiện status (UP/DOWN)
+- `when-authorized` - Hiện chi tiết khi user có quyền (khuyến nghị cho production)
+- `always` - Luôn hiện chi tiết (dùng cho development)
+
+**`probes.enabled`**: Kích hoạt Kubernetes liveness/readiness probes
+- `/actuator/health/liveness` - Check app còn sống không (restart nếu DOWN)
+- `/actuator/health/readiness` - Check app sẵn sàng nhận request (ngừng route traffic nếu DOWN)
+
+**Ví dụ output với `show-details: always`**:
+```json
+{
+  "status": "UP",
+  "components": {
+    "db": {
+      "status": "UP",
+      "details": {
+        "database": "PostgreSQL",
+        "validationQuery": "isValid()"
+      }
+    },
+    "diskSpace": {
+      "status": "UP",
+      "details": {
+        "total": 500000000000,
+        "free": 250000000000
+      }
+    }
+  }
+}
+```
+
+#### 3. Prometheus Configuration
+
+```yaml
+endpoint:
+  prometheus:
+    access: unrestricted
+prometheus:
+  metrics:
+    export:
+      enabled: true
+```
+
+**`access: unrestricted`**: Cho phép Alloy/Prometheus scrape metrics không cần authentication
+- `restricted` - Cần authentication
+- `unrestricted` - Không cần authentication (dùng cho internal network)
+
+**`export.enabled`**: Kích hoạt export metrics theo Prometheus format
+
+**Output tại `/actuator/prometheus`**:
+```
+# HELP jvm_memory_used_bytes The amount of used memory
+# TYPE jvm_memory_used_bytes gauge
+jvm_memory_used_bytes{area="heap",id="PS Eden Space"} 1.25829120E8
+
+# HELP http_server_requests_seconds
+# TYPE http_server_requests_seconds summary
+http_server_requests_seconds_count{method="GET",uri="/api/users"} 42.0
+http_server_requests_seconds_sum{method="GET",uri="/api/users"} 2.1
+```
+
+#### 4. Metrics Configuration
+
+```yaml
+metrics:
+  tags:
+    application: ${spring.application.name}
+  distribution:
+    percentiles-histogram:
+      http.server.requests: true
+```
+
+**`tags.application`**: Thêm tag `application=playground` vào TẤT CẢ metrics
+- Lợi ích: Dễ filter metrics trong Grafana khi có nhiều applications
+- Ví dụ: `jvm_memory_used_bytes{application="playground",area="heap"}`
+
+**`percentiles-histogram`**: Generate histogram buckets cho HTTP requests
+- Kích hoạt metric: `http_server_requests_seconds_bucket`
+- Cho phép tính percentiles (p50, p95, p99) trong Prometheus/Grafana
+
+**Query Grafana để tính p95 latency**:
+```promql
+histogram_quantile(0.95,
+  sum(rate(http_server_requests_seconds_bucket[5m])) by (le, uri)
+)
+```
+
+#### 5. Distributed Tracing
+
+```yaml
+tracing:
+  sampling:
+    probability: 1.0
+zipkin:
+  tracing:
+    endpoint: http://localhost:9411/api/v2/spans
+```
+
+**`sampling.probability`**: Tỷ lệ sample traces (0.0 đến 1.0)
+- `1.0` = Sample 100% requests (development/testing)
+- `0.1` = Sample 10% requests (production - giảm overhead)
+- `0.01` = Sample 1% requests (high traffic production)
+
+**Lưu ý**: 100% sampling có thể gây overhead cao ở production!
+
+**`zipkin.endpoint`**: URL của Zipkin server để gửi traces
+
+**Tracing Flow**:
+```
+Request → Generate traceId/spanId → Add to logs → Send to Zipkin
+```
+
+**Trong logs (với pattern tracing)**:
+```
+2025-11-25T10:00:00.000+07:00 INFO [playground,abc123,def456] ... Processing request
+```
+- `abc123` = traceId (track request qua nhiều services)
+- `def456` = spanId (track operations trong request)
+
+#### 6. Logging Pattern
+
+```yaml
+logging:
+  pattern:
+    level: "%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]"
+```
+
+**Format**: `LEVEL [app-name,traceId,spanId]`
+
+**Ví dụ output**:
+```
+2025-11-25T10:00:00.000 DEBUG [playground,648ae8bc12345,648ae8bc12345] 87402 --- [main] c.k.s.p.UserService : Finding user
+```
+
+**So sánh với mặc định**:
+- Mặc định: `DEBUG 87402 --- [main] c.k.s.p.UserService : Finding user`
+- Với tracing: `DEBUG [playground,648ae8bc12345,648ae8bc12345] 87402 --- [main] c.k.s.p.UserService : Finding user`
+
+**Lợi ích**:
+- Trace request qua nhiều microservices
+- Correlate logs từ nhiều services cùng một request
+- Dễ dàng filter logs theo traceId trong log aggregation tools
+
+#### Production Best Practices
+
+Cho production environment, nên điều chỉnh:
+
+```yaml
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,prometheus,metrics  # Chỉ expose cần thiết
+  endpoint:
+    health:
+      show-details: when-authorized  # Bảo mật thông tin
+  tracing:
+    sampling:
+      probability: 0.1  # Giảm overhead, chỉ sample 10%
+```
+
 ### Grafana Alloy
 
 Alloy scrape metrics từ Spring Boot application mỗi 15 giây và forward đến Mimir.