로그 파일 작업

Tableau Server에서는 정상 작업 과정에서 로그 파일을 만듭니다. Tableau Server 관련 문제를 해결하거나 Tableau 지원 부서에서 문제 해결에 도움이 되는 로그를 요청하는 경우에만 서버 로그 파일을 사용해야 합니다.

tsm maintenance ziplogs 명령을 사용하여 압축된 로그 파일 아카이브를 생성할 수 있습니다. 압축된 아카이브에는 압축을 해제하고 살펴보거나 Tableau 지원 부서로 보낼 수 있는 로그 복사본이 들어 있습니다. 아카이브를 복사한 후에는 서버에서 아카이브를 삭제할 수 있습니다. 로그 파일 아카이브에 대한 자세한 내용은 로그 파일 스냅샷(로그 아카이브)를 참조하십시오.

이 항목 모음은 로그 파일 아카이브를 만드는 방법, 특정 로그 파일 콘텐츠 및 로그 파일을 조사하는 방법 및 시기에 대한 정보를 제공합니다.

Tableau Server 로그의 내용

모든 Tableau Server 프로세스는 자체 로그 파일에 수행 중인 작업에 대한 정보를 기록합니다. 이러한 로그 파일은 각 프로세스의 동작에 대한 자세한 정보를 제공합니다. 이러한 로그 파일에는 사용자의 요청을 처리하거나 자동화된 작업을 수행하는 동안 Tableau Server 구성 요소 간의 내부 통신에 대한 자세한 정보가 포함되어 있습니다. Tableau Server 로그에는 문제 해결에 유용한 기술 정보만 포함됩니다. 예를 들어 서로 다른 구성 요소의 상태, 서로 다른 프로세스에서 수행한 동작, 통신 시도, 데이터베이스에 대한 쿼리(결과 제외) 및 요청 타이밍이 포함됩니다.

로그 파일에는 데이터베이스 서버 이름, 해당 IP 주소 및 포트, Tableau Server 컴퓨터의 이름 또는 IP 주소, 사용자가 액세스하는 통합 문서 및 뷰의 URL과 이름과 같은 일부 구체적인 데이터가 포함될 수 있습니다.

로그 파일에는 비밀번호, 쿼리 결과 또는 뷰에 표시된 데이터와 같은 민감한 고객 데이터가 포함되지 않습니다.

tsm maintenance ziplogs 명령을 사용하면 사용자가 로그 파일의 압축된 아카이브를 생성할 수 있을 뿐만 아니라 -d 옵션이 지정된 경우 Tableau Server 리포지토리 데이터를 포함할 수도 있습니다. 리포지토리에는 Tableau Server의 메타데이터(예: 사용자 이름, 그룹, 프로젝트, Tableau Server에 대한 사용 권한, 추출 새로 고침 일정)가 포함됩니다. 또한 리포지토리에는 통합 문서에 대한 레이아웃 및 연결 정보도 포함되어 있지만 비밀번호, 데이터베이스의 실제 데이터 또는 뷰에 표시된 데이터와 같은 데이터는 없습니다.

뷰에 표시된 데이터는 추출 파일 또는 데이터베이스에서 가져오며 메모리에 캐시됩니다. 로그에 저장되지 않으며 라이브 연결의 경우 Tableau Server 컴퓨터의 별도 파일에 저장되지 않습니다. 추출 파일은 Tableau Server 컴퓨터에서 dataengine 폴더의 .hyper 파일로 저장되지만 압축된 로그 아카이브에는 포함되지 않습니다.

Tableau Server 문제 조사

Tableau Server와 관련하여 발생할 수 있는 문제의 범위와 복잡성은 모든 문제를 조사하는 것이 간단하지 않다는 것을 의미하지만, 일반적인 조사 단계는 다음과 같습니다.

  1. 기존 로그 파일을 정리하여 크기를 줄입니다. 자세한 내용은 불필요한 파일 제거를 참조하십시오.

    중요: 문제를 해결할 때 Tableau 지원 부서에서 도움을 받고 싶은 경우 로그를 정리하기 전에 압축된 로그 아카이브를 만들어야 합니다. 정리는 지원 부서에 필요한 중요한 정보를 삭제할 수 있습니다. 로그 아카이브 만들기에 대한 자세한 내용은 로그 파일 스냅샷(로그 아카이브)을 참조하십시오.

  2. 적절한 로깅 수준을 설정합니다. 적절한 수준은 Tableau 지원 부서에서 알려 드립니다. 서로 다른 로그 수준의 영향을 비롯한 자세한 내용은 로그 수준 변경을 참조하십시오.
  3. 로그에서 문제와 관련된 이벤트를 캡처할 수 있도록 해결 중인 문제를 재현합니다.
  4. 로그의 아카이브를 생성합니다. 자세한 내용은 로그 파일 스냅샷(로그 아카이브)를 참조하십시오.

    중요: 로그 파일을 찾을 때 이 아카이브를 사용합니다. 서버에서 바로 파일을 편집하거나 이동 또는 삭제할 수 없습니다.

  5. TSM 관리 컨트롤러 로그 (\tabadmincontroller\tabadmincontroller_node<n>-<n>.log)를 검토하여 TSM에서 시작된 작업을 비롯하여 명령줄, 웹 UI 또는 API에서 TSM에 의해 수행된 구성 또는 배포를 파악할 수 있습니다. 컨트롤러 로그로 시작합니다. 가장 유용한 정보를 얻을 수 있는 위치는 다음과 같습니다.

    참고: tsm.logtabadmincontroller_*.log만큼 자세하지 않지만 유용하고 보완적인 문제 해결 정보를 제공할 수 있습니다.

  6. Apache 로그 (\httpd\access.####_##_##_##_##_##.log\httpd\error.log)를 통해 조사 중인 문제와 관련된 요청을 파악합니다.

    Apache 로그는 발생한 문제에 적용되지 않는 많은 양의 "노이즈"를 포함합니다.

    • 문제와 관련된 것으로 보이는 요청을 찾은 경우 vizqlserver 디렉터리에서 Apache 로그의 고유한 요청 ID를 포함하는 항목을 검색합니다.
    • 요청 ID와 관련된 응답 코드 및 메시지를 조사합니다.
    • 문제와 관련된 데이터 원본 또는 대시보드를 확인하거나 통합 문서 이름을 검색합니다. 관련 타임스탬프를 찾습니다.
    • 문제와 관련된 것으로 보이는 요청을 찾은 경우 해당 요청에 해당되는 응답 코드를 확인합니다. (200은 정상이며 500은 문제가 있음을 나타냅니다.)
    • 식별한 요청과 관련된 고유한 요청 ID(요청 맨 끝에 24자의 알파벳 문자열)를 확인합니다.
  7. 로그 아카이브를 검토하여 다른 메시지 및 가능한 오류에 대해 더 자세히 알아봅니다.

    • Apache 로그의 요청 ID를 사용하여 관련 로그 항목이 포함된 파일의 로그 아카이브 폴더(vizqlserver)를 검색합니다. 문제 징후(예를 들어, 오류 메시지 또는 오래 실행되는 쿼리)를 파악합니다.
    • 무료 오픈 소스 도구인 Logshark는 로그 아카이브를 검토할 때 유용한 옵션이 될 수 있습니다. 자세한 내용은 Tableau Blueprint에서 Tableau Server 문제 해결(링크가 새 창에서 열림)을 참조하십시오.
  8. 스크립트 로깅을 검토합니다.

    Tableau Server에는 스크립트 디렉터리에 포함된 대부분의 스크립트에 대한 로그가 포함됩니다. 기본적으로 다음과 같습니다.C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\ 이러한 로그는 다음 위치에 저장됩니다.

    • <install_drive>\<install\path>\logs\
      기본적으로 다음과 같습니다. 
    • C:\ProgramData\Tableau\Tableau Server\logs\
  9. 지원 문의

    문제를 직접 해결할 수 없거나 Tableau 지원 부서에서 요청하는 경우 압축된 아카이브를 Tableau로 전송합니다.

이 섹션의 다른 문서

피드백을 제공해 주셔서 감사합니다!