에이전트 인시던트
라이선스가 없는 에이전트(중요)
호환되지 않는 에이전트 버전(중요)
에이전트 중단됨(경고)
회사 가치인 평등에 맞추려는 노력의 일환으로 가능한 경우 비포용적인 용어를 변경했습니다. 특정 위치에서 용어를 변경하면 해당 변경이 너무 큰 영향을 미칠 수 있으므로 기존 용어를 유지합니다. 따라서 CLI 명령 및 옵션, 설치 폴더, 구성 파일 및 기타 인스턴스에는 계속해서 이러한 용어가 표시될 수 있습니다. 자세한 내용은 Tableau 도움말 정보(링크가 새 창에서 열림)를 참조하십시오.
라이선스가 없는 에이전트
Tableau Server에 Tableau Resource Monitoring Tool를 사용할 수 있는 라이선스가 적절하게 허가되지 않은 것이 감지될 경우 Agents Unlicensed(라이선스가 없는 에이전트) 인시던트가 중요 인시던트로 기록됩니다.
Resource Monitoring Tool를 사용하여 Tableau Server를 모니터링하려면 Tableau Server에 Tableau Advanced Management 라이선스가 부여되어야 합니다.
에이전트는 더 이상 라이선스 없음 상태의 데이터를 수집하거나 RMT 서버로 전송하지 않습니다. 그러나 환경에 적절하게 라이선스가 허가되었을 때 수집된 이전 데이터를 계속 볼 수 있습니다.
이 문제를 해결하려면 유효한 Advanced Management 제품 키를 사용하여 Tableau Server에 라이선스를 부여하십시오. 자세한 내용은 Tableau Server의 Tableau Advanced Management 정보를 참조하십시오.
참고: Tableau Server에 유효한 라이선스를 추가한 후 인시던트가 지워지려면 최대 1시간이 걸릴 수 있습니다.
Agents Unlicensed 인시던트를 발생시킬 수 있는 다른 가능한 원인이 있습니다.
Tableau Server API 자격 증명이 잘못되었을 수 있습니다. 환경 구성 페이지에서 사용자 이름 및 암호가 올바른지, 사용되는 계정에 Tableau Server에 대한 서버 관리자 역할이 있는지 확인합니다.
Tableau Server REST API에 연결할 수 없습니다. Tableau Server가 REST API를 사용하도록 설정되어 있고 Tableau Server가 실행 중인지 확인합니다.
REST API 연결 문제를 해결하려면 Admin 메뉴에서 Environments을 선택하고 수정하려는 환경에 대한 Edit Environment을 클릭하고 Environment Details 탭에서 페이지 오른쪽에 있는 Tableau Server REST API 섹션의 Test Connection 단추를 클릭합니다.
RMT 서버가 네트워크 연결 또는 유사한 문제로 인해 Tableau Server에 연결할 수 없습니다.
호환되지 않는 에이전트 버전
환경에 있는 하나 이상의 에이전트가 RMT 서버 버전과 호환되지 않는 버전을 사용 중인 경우 에이전트 비호환 인시던트가 중요 상태로 기록됩니다.
이 문제를 해결하려면 에이전트 버전이 현재 RMT 서버 버전과 호환되는 버전인지 확인해야 합니다.
이 문제를 해결하려면 다음 중 하나를 사용하십시오.
- 에이전트가 최소 호환 버전보다 이전 버전인 경우 에이전트를 인시던트 보고서에 나열된 최소 호환 버전으로 업그레이드해야 합니다.
- 에이전트가 RMT 서버 버전보다 이후 버전인 경우 RMT 서버를 동일한 최신 버전으로 업그레이드하는 것이 좋습니다. 현재 사용 중인 버전에 따라 다른 에이전트를 업그레이드해야 할 수 있습니다.
에이전트 업그레이드:
다음 단계에 따라 에이전트를 업그레이드합니다.
- 에이전트 설치 프로그램을 다운로드하여 에이전트를 업그레이드해야 하는 Tableau Server 노드에 복사합니다. 에이전트는 RMT 서버와 같은 버전이거나 RMT 서버 버전과 호환되는 버전을 사용해야 합니다. 인시던트 세부 정보에는 최소 호환 버전이 나와 있습니다.
다음 명령을 사용하여 모든 Tableau Server 노드에서 Tableau Resource Monitoring Tool 에이전트 서비스를 중지합니다.
rmtadmin stop --agent
업그레이드해야 하는 에이전트에서 에이전트 설치 프로그램을 실행합니다.
참고: 기본이 아닌 위치를 사용하는 경우 EULA 페이지에서 Customize를 클릭하여 사용자 지정 설치 위치를 제공합니다. 에이전트 설치 위치로 \Tableau\Tableau Resource Monitoring Tool을 사용하는 것이 좋습니다. 기본 위치가 아닌 위치의 예: D:\Tableau\Tableau Resource Monitoring Tool
에이전트가 실행 중이고 업그레이드되었는지 확인합니다. 관리 -> 환경 -> 환경 편집 -> 서버 탭으로 이동하여 에이전트 등록 상태를 보고 Tableau Server 노드의 전체 목록과 에이전트 상태를 볼 수 있습니다.
RMT Server 업그레이드
하나 이상의 에이전트가 최신 버전인 경우 RMT 서버를 업그레이드합니다.
다음 단계에 따라 RMT 서버를 업그레이드합니다.
업그레이드를 시작하기 전에 브라우저에서 Resource Monitoring Tool에 로그인하고 작동 중인지 확인합니다.
RMT 서버가 설치된 컴퓨터에 RMT 서버 설치 프로그램을 복사합니다.
- 모든 에이전트에서 Tableau Resource Monitoring Tool 에이전트 Windows 서비스를 중지합니다.
RMT 서버에서 Tableau Resource Monitoring Tool Windows 서비스를 중지합니다.
참고: 서비스가 중지되면 서비스 중지 후 tabrmt-agent 또는 tabrmt-master를 통해 실행되는 Resource Monitoring Tool 프로세스가 없는지 확인하는 것이 좋습니다. 여기에 PostgreSQL 또는 RabbitMQ는 포함되지 않습니다.
- RMT 서버에서 실행 중인 모든 프로세스를 완전히 중지하려면 시간이 조금 걸릴 수 있으니 작업 관리자에서 Resource Monitoring Tool로 실행되는 프로세스가 이름에 표시되지 않을 때까지 기다린 후 다음 단계로 이동하십시오.
RMT 서버에서 설치 프로그램을 실행합니다. 그러면 모든 필요한 필수 요건이 설치되거나 업그레이드된 후 RMT 서버가 업그레이드됩니다.
참고: 기본이 아닌 위치를 사용하는 경우 EULA 페이지에서 Customize를 클릭하여 사용자 지정 설치 위치를 제공합니다. RMT 서버 설치를 위한 위치로 \Tableau\Tableau Resource Monitoring Tool을 사용하는 것이 좋습니다. 기본 위치가 아닌 위치의 예: D:\Tableau\Tableau Resource Monitoring Tool
에이전트와 RMT 서버가 실행 중인지 확인합니다. 업그레이드가 완료된 후 자동으로 다시 시작되지 않는 경우 에이전트 및 RMT 서버를 시작합니다.
에이전트 메시지 큐 자격 증명 회전 실패
버전 2021.3부터는 보안 모범 사례를 준수하기 위해 에이전트와 Rabbit MQ 간의 연결에 대한 자격 증명이 해당 에이전트에 대해 고유해야 합니다. 고유 자격 증명은 새로 설치하는 동안 만들어지거나 2021.3으로 업그레이드할 때 업데이트됩니다.
업그레이드 중에 네트워크 문제가 있는 경우 자격 증명 업데이트 프로세스가 실패할 수 있으므로 심각한 인시던트 보고서가 발생할 수 있습니다. 하지만 업그레이드 프로세스가 중단되지 않고 업그레이드 프로세스가 계속됩니다. 업그레이드가 완료되면 Resource Monitoring Tool이 매일 다시 시도하여 고유한 자격 증명을 만듭니다. 초기 실패에 대한 심각한 인시던트 보고서가 작성되고 이후에 다시 시도할 때마다 오류가 발생합니다. 이 기간 동안 에이전트는 새 자격 증명이 생성될 때까지 이전 자격 증명을 사용하여 계속 작업합니다.
문제가 저절로 해결될 수도 있지만, 문제가 계속되면 다음을 수행하십시오.
- 에이전트가 RMT 서버에 연결할 수 있는지 확인합니다.
에이전트와 RMT 서버 간의 방화벽 문제를 확인합니다.
에이전트 중단됨
에이전트 중단됨 인시던트는 Tableau Resource Monitoring Tool가 Tableau Server의 에이전트와 통신할 수 없는 경우 경고 인시던트로 기록됩니다.
이 문제를 해결하려면 다음 단계를 따르십시오.
- 에이전트를 호스팅하는 하드웨어가 실행 중이고 RMT 서버와 통신할 수 있는지 확인합니다.
- 에이전트 서비스가 성공적으로 등록되었고 실행 중인지 확인합니다. 관리 -> 환경 -> 환경 편집 -> 서버 탭으로 이동하여 에이전트 등록 상태를 보고 Tableau Server 노드의 전체 목록과 에이전트 상태를 볼 수 있습니다.
에이전트 폴링 및 인시던트 생성 시간
- 에이전트는 5분마다 Resource Monitoring Tool Server에 하트비트 메시지를 보냅니다.
- Resource Monitoring Tool Server는 에이전트의 최근 하트비트 메시지가 15분 미만인지 확인합니다.
- 에이전트에서 받은 최신 하트비트 메시지가 15분 미만인 경우 에이전트는 온라인 상태로 간주되고 인시던트가 생성되지 않으며 기존의 모든 에이전트 중단됨 인시던트가 지워집니다.
- 에이전트에서 받은 최신 하트비트 메시지가 15분 이상 지난 경우 첫 번째 실패 시도로 간주됩니다. 그 후 1분마다 두 번 더 검사를 수행합니다. 세 번의 시도(첫 번째 시도와 두 번의 재시도) 후에도 여전히 최근 하트비트 메시지가 없으면 에이전트 중단됨 인시던트가 생성됩니다.
참고: 위에서 설명한 폴링 간격을 기준으로 에이전트가 오프라인 상태가 된 후 에이전트 중단됨 인시던트가 생성되는 데 약 17분(15+1+1)이 걸립니다.
이 작업을 수행할 수 있는 사용자
Resource Monitoring Tool 관리자 또는 서버/환경 관리 역할이 있는 Resource Monitoring Tool 사용자