6 - Apache Superset의 일반적인 문제 해결 방법

Apache Superset을 사용하면서 발생할 수 있는 일반적인 문제와 해결 방법을 알려드리겠습니다.

1. Docker 관련 문제

Docker 빌드 실패

Docker 빌드가 실패하는 경우 다음 사항을 확인하세요:

• Docker에 최소 12GB RAM이 할당되어 있는지 확인
• Node 버전이 최신 버전(v20)인지 확인
• Debian 패키지 업데이트 중 발생하는 문제일 수 있으므로 재빌드 시도

Github Issue #30189

2. 성능 관련 문제

대시보드 로딩 속도가 느린 경우

• 데이터베이스 성능 확인 및 최적화
• 쿼리 타임아웃 설정 조정: SUPERSET_WEBSERVER_TIMEOUT 값을 조정
• 필터 설정 확인: "Select first filter value by default" 옵션이 활성화된 경우 로딩 지연 발생 가능

Github Issue #29636

쿼리 타임아웃 문제

SQL Lab에서 장시간 실행 쿼리의 경우 타임아웃 설정을 조정할 수 있습니다:

SQLLAB_ASYNC_TIME_LIMIT_SEC = 60 * 60 * 6  # 6시간

대시보드나 차트 로딩 시 타임아웃 발생 시:

SUPERSET_WEBSERVER_TIMEOUT = 60  # 초 단위

FAQ

3. 알림 및 보고서 문제

보고서 스크린샷 실패

• 워커 로그 확인: docker logs superset_worker --since 1h
• 웹 브라우저와 웹드라이버 설치 확인: Firefox 헤드리스 브라우저와 geckodriver가 올바르게 설치되었는지 확인
• WEBDRIVER_BASEURL 설정 확인: 워커가 Superset 앱에 접근할 수 있는 올바른 URL 설정

Alerts and Reports Troubleshooting

이메일 전송 문제

이메일 서버 연결 문제가 발생할 경우:

• SMTP 설정 확인
• 테스트 이메일 전송으로 구성 확인
• 클라우드 호스트의 경우 SMTP 포트(25) 차단 여부 확인

Alerts and Reports Troubleshooting

4. 데이터베이스 연결 문제

데이터베이스 연결 오류

• 호스트명, 포트, 사용자 이름, 비밀번호가 올바른지 확인
• 방화벽 설정 확인
• 필요한 데이터베이스 드라이버가 설치되어 있는지 확인

Issue Codes

메타데이터 로드 실패

일부 데이터베이스(예: ODPS)에서 메타데이터 로드 실패 시:

• 데이터베이스 엔진 사양 확인
• 커스텀 엔진 사양이 올바르게 구현되었는지 확인

Github Issue #31641

5. 프록시 관련 문제

프록시 설정 문제가 발생하는 경우:

• 프록시 URL 설정 확인
• 연결 거부(ECONNREFUSED) 또는 연결 재설정(ECONNRESET) 오류 확인

Github Issue #29913

6. 로그 관련 문제

경고 메시지 문제

로그에 반복적인 경고 메시지가 표시되는 경우(예: "Class 'werkzeug.local.LocalProxy' is not mapped"):

• Redis를 백엔드로 사용하는 경우 RATELIMIT_STORAGE_URI 설정 추가:

  RATELIMIT_STORAGE_URI = 'redis://{REDIS_HOST}:{REDIS_PORT}'

Github Issue #26020

도움 받는 방법

문제 해결이 어려운 경우 다음 채널을 통해 도움을 요청할 수 있습니다:

• Stack Overflow에서 'apache-superset' 태그 사용
• Slack 커뮤니티 참여
• GitHub 이슈 또는 GitHub 디스커션 활용
• 메일링 리스트 참여

Contributing to Superset

문제 해결 시 로그를 확인하고 오류 메시지를 분석하는 것이 중요합니다. 대부분의 문제는 구성 설정 조정이나 환경 설정 변경으로 해결할 수 있습니다.