---
schema_version: "1"
id: bfb4d074fd82f1e686cce4d20464e214cfeaadcd873505bbacb692d704eb1872
title: 로그 수준 변경
collection: tableau
version: next
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/next/ko-kr/server-linux/logs_debug_level.md
canonical_url: https://help.tableau.com/v0.0/server-linux/ko-kr/logs_debug_level.htm
source_site: help.tableau.com
content_type: documentation
content_hash: ce30cf4a141df24d9b632277c04f708a532a5ff912dd030a2bc02a91e5b4ef15
description: Change logging levels for Tableau Services Manager and Tableau Server.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 로그 수준 변경

기본적으로 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`)가 추가됩니다.

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

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

<table class="table--plain"><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>구성 키</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>영향 받는 로그의 위치</b><p>(경로는 <code>/var/opt/tableau/tableau_server/data/tabsvc/logs/</code>로 시작함)</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tsm.log.level</code></p><p>activationservice, appzookeeper, backuprestore, clientfileservice, databasemaintenance, licenseservice, siteimportexport, tabadminagent, tabadmincontroller, tabsvc에 대한 TSM 로그 수준 변경</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>/&lt;service&gt;/&lt;service&gt;_node&lt;n&gt;-&lt;instance&gt;.log</code></p><p>예:<code> /clientfileservice/clientservice_node1-0.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tsm.controlapp.log.level</code></p><p>control application에 대한 TSM 로그 수준 변경</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>/&lt;service&gt;/control_&lt;service&gt;_node&lt;n&gt;-&lt;instance&gt;.log</code></p><p>예:<code> /clientfileservice/control_clientservice_node1-0.log</code></p><p><code> /filestore/control_filestore_node1-0.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code> &lt;process&gt;.native_api.log.level</code></p><p>유효한 프로세스 이름은 backgrounder, vizportal, vizqlserver, dataserver입니다.</p><p><strong>참고:</strong>&nbsp;이러한 이름을 동적으로 구성할 수 없습니다.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/vizqlserver/*.txt</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>backgrounder.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;백그라운더</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/backgrounder/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>clustercontroller.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;클러스터 컨트롤러</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/clustercontroller/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>dataserver.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;데이터 서버</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/dataserver/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>filestore.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;파일 저장소</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/filestore/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>gateway.log.level</code></p><p>다음에 대한 로그 수준 변경:&nbsp;게이트웨이 제어 프로세스</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/gateway/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>gateway.httpd.loglevel</code></p><p><strong>참고:</strong>&nbsp;버전 2021.3.0에 추가되었습니다.</p><p>다음에 대한 로깅 수준 변경:&nbsp;게이트웨이</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/gateway/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>hyper.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;Hyper</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/hyper/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tdsservice.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;데이터 원본 속성 서비스</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/tdsservice/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tomcatcontainer.log.level</code></p><p>다음의 마이크로서비스에 대한 로깅 수준 변경:&nbsp;대화형 마이크로서비스 컨테이너 및 비대화형 마이크로서비스 컨테이너</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/tomcatcontainer/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>vizportal.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;응용 프로그램 서버</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/vizportal/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>vizqlserver.log.level</code></p><p>다음에 대한 로깅 수준 변경:&nbsp;VizQL 서버</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/vizqlserver/*.log</code></td></tr></tbody></table>

자세한 내용은 [tsm configuration set 옵션](https://help.tableau.com/v0.0/server-linux/ko-kr/cli_configuration-set_tsm.htm)을 참조하십시오.

동적으로 구성 가능한 로그 수준만 변경하는 경우 서버를 중지하거나 시작할 필요가 없습니다(자세한 내용은 위의 [동적 로그 수준 구성](#DynamicLogLevel) 참조). 다른 로그 수준만 변경하려는 경우 로그 수준을 변경하기 전에 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`

## 로그 수준 재설정

문제를 재현하고 관련 정보를 수집한 후 지속적인 성능 저하를 방지하고 추가적인 디스크 공간이 사용되지 않도록 로그 수준을 재설정할 수 있습니다.

Tableau Server 2026.2 이상에서는 `tsm maintenance log-levels` 명령을 사용하여 모든 서비스 로깅 수준을 보고 기본값으로 재설정할 수 있습니다. 자세한 내용은 [tsm maintenance](https://help.tableau.com/v0.0/server-linux/ko-kr/cli_maintenance_tsm.htm)를 참조하십시오.

- 재설정하기 전에 모든 로그 수준 구성을 보려면 다음을 실행합니다.
    
    `tsm maintenance log-levels list`
- 모든 로그 수준 구성을 기본값으로 설정하려면 다음을 실행합니다.
    
    `tsm maintenance log-levels reset`

이전 버전의 Tableau Server인 경우 또는 특정 키를 재설정하려는 경우 `tsm configuration set` 명령을 `-d` 옵션과 함께 실행 하십시오.

예:

- tsm configuration set -k backgrounder.native\_api.log.level -d
- tsm configuration set -k tsm.log.level -d

로그 수준을 재설정한 후 보류 중인 변경 내용을 적용해야 합니다. Tableau Server 프로세스의 로그 수준을 재설정하는 경우 보류 중인 변경 내용 목록을 확인하십시오. 업데이트를 위해 다시 시작해야 하는 경우 서버를 중지하고 변경 사항을 적용한 다음 업데이트를 다시 시작합니다.