로그 수준 변경

기본적으로 TSM(Tableau 서비스 관리자) 및 Tableau Server에서는 정보 수준에서 이벤트를 기록합니다. 자세한 정보를 수집해야 하는 경우(예: Tableau 지원 부서와 작업할 경우) 이 수준을 변경할 수 있습니다.

가장 좋은 방법은 지원 센터의 지시에 따라 문제를 해결할 때 외에는 로그 수준을 높이지 않는 것입니다. 특정 문제를 조사하는 경우에만 로그 수준을 디버그로 설정해야 합니다. 로그 수준을 변경하면 다음과 같은 영향을 줄 수 있습니다.

  • 로그 수준을 debug 또는 trace 수준으로 높이면 기록할 정보량이 증가하여 성능에 큰 영향을 줄 수 있습니다. 문제를 재현한 다음 로그 수준을 정보로 재설정합니다.
  • 로그 수준을 warn 또는 error로 설정하면 Tableau 지원에 사용할 수 없을 정도로 정보의 양이 줄어들 수 있습니다.

참고: DEBUG 수준에서 로깅하는 경우 Tableau가 시작될 때 전체 환경 정보가 수집됩니다. 즉, 환경 변수에 민감한 정보가 있는 경우 로그에 이 정보가 포함될 수 있습니다. 기본값인 INFO 수준의 로깅은 안전한 환경 정보만 수집합니다.

로그 수준

다음 로그 수준은 기록되는 정보량을 기준으로 오름차순으로 나열됩니다.

  • off (해제)
  • fatal (치명적)
  • error (오류)
  • warn (경고)
  • info (the default) (정보(기본값))
  • debug (디버그)
  • trace (추적)

로그 수준 변경

tsm configuration set 구성 키를 사용하여 TSM 및 Tableau Server 프로세스에 대한 로그 수준을 설정합니다. 사용하는 키는 로그 수준을 변경할 TSM 또는 Tableau Server의 구성 요소에 따라 다릅니다.

동적 로그 수준 구성

버전 2020.2에서 동적 구성이 도입되었습니다. 이 기능은 후속 릴리스에서 확장되었습니다. 이러한 구성 요소 중 하나 이상에 대한 로깅 수준만 변경하는 경우 적합한 Tableau 버전을 실행한다면 Tableau Server를 다시 시작하지 않고도 로깅 수준을 변경할 수 있습니다.

이러한 로깅 수준은 다음 버전부터 동적으로 구성할 수 있습니다.

  • 2020.2 - tsm 서비스(tsm.log.level) 및 control application 서비스(tsm.controllerapp.log.level)
  • 2020.3 - 백그라운더(backgrounder.log.level), 클러스터 컨트롤러(clustercontroller.log.level), 데이터 서버(dataserver.log.level), 파일 저장소(filestore.log.level), 데이터 원본 속성(tdsservice.log.level) 및 VizQL 서버(vizqlserver.log.level)
  • 2020.4 - 대화형 마이크로서비스 컨테이너(tomcatcontainer.log.level) 및 응용 프로그램 서버(vizportal.log.level)가 추가됩니다.

 

로깅 수준 변경을 위한 구성 키

다음 테이블에는 동적으로 구성 가능한 키와 동적으로 구성 불가능한 키가 모두 나와 있습니다.

구성 키영향 받는 로그의 위치

(경로는 /var/opt/tableau/tableau_server/data/tabsvc/logs/로 시작함)

tsm.log.level

clientfileservice, licenseservice, tabadminagent, tabadmincontroller, tabsvc에 대한 TSM 로그 수준 변경

/<service>/<service>_node<n>-<instance>.log

예: /clientfileservice/clientservice_node1-0.log

tsm.controlapp.log.level

control application에 대한 TSM 로그 수준 변경

/<service>/control_<service>_node<n>-<instance>.log

예: /clientfileservice/control_clientservice_node1-0.log

/filestore/control_filestore_node1-0.log

<process>.native_api.log.level

유효한 프로세스 이름은 backgrounder, vizportal, vizqlserver, dataserver입니다.

참고: 이러한 이름을 동적으로 구성할 수 없습니다.

/vizqlserver/*.txt

backgrounder.log.level

다음에 대한 로깅 수준 변경: 백그라운더

/backgrounder/*.log

clustercontroller.log.level

다음에 대한 로깅 수준 변경: 클러스터 컨트롤러

/clustercontroller/*.log

dataserver.log.level

다음에 대한 로깅 수준 변경: 데이터 서버

/dataserver/*.log

filestore.log.level

다음에 대한 로깅 수준 변경: 파일 저장소

/filestore/*.log

gateway.log.level

다음에 대한 로그 수준 변경: 게이트웨이 제어 프로세스

/gateway/*.log

gateway.httpd.loglevel

참고: 버전 2021.3.0에 추가되었습니다.

다음에 대한 로깅 수준 변경: 게이트웨이

/gateway/*.log

hyper.log.level

다음에 대한 로깅 수준 변경: Hyper

/hyper/*.log

tdsservice.log.level

다음에 대한 로깅 수준 변경: 데이터 원본 속성 서비스

/tdsservice/*.log

tomcatcontainer.log.level

다음의 마이크로서비스에 대한 로깅 수준 변경: 대화형 마이크로서비스 컨테이너 및 비대화형 마이크로서비스 컨테이너

/tomcatcontainer/*.log

vizportal.log.level

다음에 대한 로깅 수준 변경: 응용 프로그램 서버

/vizportal/*.log

vizqlserver.log.level

다음에 대한 로깅 수준 변경: VizQL 서버

/vizqlserver/*.log

자세한 내용은 tsm configuration set 옵션을 참조하십시오.

동적으로 구성 가능한 로그 수준만 변경하는 경우 서버를 중지하거나 시작할 필요가 없습니다(자세한 내용은 위의 동적 로그 수준 구성 참조). 다른 로그 수준만 변경하려는 경우 로그 수준을 변경하기 전에 Tableau Server를 중지하고 변경한 후 다시 시작해야 할 수 있습니다. 이 경우에는 메시지가 표시됩니다.

Tableau Server의 다중 노드 설치 환경에서는 초기 노드에서 로그 수준을 설정합니다.

로그 수준을 변경하려면

  1. (2020.2.0 이상에서 동적으로 구성 가능한 로그 수준의 경우 선택 사항) 명령 프롬프트를 열고 다음을 입력하여 Tableau Server를 중지합니다.

    tsm stop

  2. tsm configuration set -k <config.key> -v <config_value>를 입력하여 로그 수준을 설정합니다.

    여기서 <config.key>는 위 테이블의 키 중 하나이고 <config_value>는 유효한 로그 수준입니다.

    예:

    • tsm configuration set -k backgrounder.native_api.log.level -v debug                    
    • tsm configuration set -k tsm.log.level -v debug
    • tsm configuration set -k tsm.controlapp.log.level -v debug
  3. tsm pending-changes apply 명령을 실행하여 보류 중인 변경 내용을 적용합니다.
  4. (선택 사항, 서버가 중지된 경우에만 해당) 다음 명령을 실행하여 Tableau Server를 시작합니다.

    tsm start

로그 수준 재설정

문제를 재현하고 문제 관련 정보를 수집한 후 더 이상 성능이 영향을 받지 않고 추가적인 디스크 공간이 사용되지 않도록 로그 수준을 재설정합니다.

적절한 명령에 -d 옵션을 사용하여 로그 수준을 기본값(정보)으로 재설정합니다. 로그 수준을 재설정한 후 보류 중인 변경 내용을 적용해야 하며 Tableau Server 프로세스에 대한 로그 수준을 재설정하는 경우 변경하기 전에 서버를 중지하고 보류 중인 변경 내용을 적용한 후 서버를 시작해야 할 수 있습니다.

예:

  • tsm configuration set -k backgrounder.native_api.log.level -d
  • tsm configuration set -k tsm.log.level -d
피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!