🔧 Redis + ELK Stack 트러블슈팅 가이드

[Tae4an]

1️⃣ TCP 연결 실패

🚨 에러 메시지

WARN in net.logstash.logback.appender.LogstashTcpSocketAppender[REDIS] - Log destination localhost/<unresolved>:5044: connection failed

🔍 원인 분석

• Spring Boot에서 Logstash로 직접 TCP 연결 시도
• Logstash TCP input 설정 누락 또는 포트 미오픈

✅ 해결 방법

Redis Appender로 설정 변경:

<appender name="REDIS" class="com.cwbase.logback.RedisAppender">
    <!-- Redis 설정 -->
</appender>

2️⃣ Redis URL 파싱 에러

🚨 에러 메시지

Invalid destination 'redis://qpalz': unparseable port (was '//qpalz')

🔍 원인 분석

• logback-spring.xml의 Redis 연결 URL 형식 오류
• LogstashAccessTcpSocketAppender 사용 시 발생

✅ 해결 방법

개별 속성으로 설정:

<appender name="REDIS" class="com.cwbase.logback.RedisAppender">
    <host>${SERVER_URL}</host>
    <port>6379</port>
    <password>${REDIS_PASSWORD}</password>
    <key>logstash</key>
    <type>redis</type>
    <layout class="net.logstash.logback.layout.LogstashLayout">
        <customFields>{"application":"test"}</customFields>
    </layout>
</appender>

3️⃣ Logback 초기화 실패

🚨 에러 메시지

Logging system failed to initialize using configuration from 'classpath:logback-spring.xml'

🔍 원인 분석

• Appender 클래스 문제
• Redis 연결 문자열 형식 오류

✅ 해결 방법

1. 의존성 추가:

implementation 'com.cwbase:logback-redis-appender:1.1.5'

2. Appender 설정 변경:

<appender name="REDIS" class="com.cwbase.logback.RedisAppender">
    <host>${SERVER_URL}</host>
    <port>6379</port>
    <password>${REDIS_PASSWORD}</password>
    <key>logstash</key>
    <type>redis</type>
    <layout class="net.logstash.logback.layout.LogstashLayout">
        <customFields>{"application":"test"}</customFields>
    </layout>
</appender>

4️⃣ 환경변수 문제

🚨 에러 메시지

• spring.config.import is missing

✅ 해결 방법

1. application.yml 설정:

spring:
  data:
    redis:
      host: ${SERVER_URL}
      port: 6379
      password: ${REDIS_PASSWORD}

2. 환경변수 설정:

export SERVER_URL=your_server_url
export REDIS_PASSWORD=your_redis_password

5️⃣ 로그 전송 실패

🔍 디버깅 단계

1. Redis 연결 확인:

docker exec -it redis redis-cli -a ${REDIS_PASSWORD}
ping

2. Logstash 로그 확인:

docker logs -f logstash

3. Redis 로그 확인:

LLEN logstash
LRANGE logstash -1 -1

✅ 해결 방법

1. 로그 레벨 설정:

<root level="INFO">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="ASYNC_REDIS" />
</root>

<logger name="com.example" level="DEBUG" additivity="false">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="ASYNC_REDIS" />
</logger>

2. Redis 연결 정보 확인:

docker inspect redis | grep IPAddress

📝 체크리스트

1. Redis 연결 정보 정확성 확인
2. Logstash 파이프라인 설정 검증
3. 로그 레벨 설정 확인
4. 환경변수 설정 확인
5. Docker 네트워크 연결 상태 점검

💡 Best Practices

• Redis Appender 사용 권장
• 환경변수는 application.yml에서 관리
• Docker 컨테이너 간 네트워크 설정 주의
• 로그 레벨 적절히 설정