ELK Stack 환경 설정 및 일반적인 문제 해결 가이드

[Tae4an]

📌 Issue Summary

ELK Stack (Elasticsearch, Logstash, Kibana) 및 Redis 환경 설정 시 발생할 수 있는 일반적인 문제들과 그 해결 방법을 정리한 문서입니다.

🔍 Common Issues and Solutions

1. Redis 인증 오류

문제 상황

127.0.0.1:6379> ping
(error) NOAUTH Authentication required.

해결 방법

• Docker 환경에서 직접 비밀번호 입력:

  docker exec -it redis redis-cli -a your_actual_password

• 환경변수 사용:

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

2. Elasticsearch 인증 오류

문제 상황

• 401 Authentication Error 발생
• Security exception 메시지 표시

해결 방법

• curl 요청 시 올바른 인증 정보 사용:

  curl -u elastic:${ELASTIC_PASSWORD} http://localhost:9200/_cluster/health?pretty

• 환경변수 설정 확인:

  source .env
  echo $ELASTIC_PASSWORD

3. Kibana System 인증 문제

문제 상황

• Kibana system 사용자 인증 실패
• Elasticsearch와 Kibana 간 통신 오류

해결 방법

1. kibana_system 사용자 비밀번호 재설정 스크립트 실행
2. 서비스 재시작:

   docker-compose down
   docker-compose up -d elasticsearch
   sleep 30
   docker exec elasticsearch /setup/setup-kibana.sh
   docker-compose up -d

4. Elasticsearch 메모리 설정

문제 상황

max virtual memory areas vm.max_map_count [65530] is too low

해결 방법

• 임시 해결:

  sudo sysctl -w vm.max_map_count=262144

• 영구 해결:

  echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf
  sudo sysctl -p

📋 권장 사항

1. 보안 관련

   • 강력한 비밀번호 사용
   • 환경변수를 통한 비밀번호 관리
   • 정기적인 비밀번호 변경

2. 모니터링

   • 정기적인 로그 확인
   • 시스템 리소스 모니터링
   • 오류 패턴 분석

3. 백업

   • 정기적인 데이터 백업
   • 설정 파일 백업
   • 복구 절차 문서화

🔗 관련 문서

• Elasticsearch 공식 문서
• Kibana 공식 문서
• Redis 공식 문서

Labels

documentation elk-stack troubleshooting security configuration