엔드포인트 VM에서 사용자 지정 스크립트를 실행하고 메트릭으로 사용될 수 있는 사용자 지정 데이터를 수집할 수 있습니다.
사전 요구 사항
- 사용자 지정 스크립트를 사용하여 실행하는 모든 스크립트는 단일 정수 값을 출력해야 합니다. 출력이 단일 정수 값이 아닌 경우 사용자 인터페이스에 오류가 표시됩니다.
- 사용자 지정 스크립트는 Telegraf의 exec 플러그인을 사용하여 엔드포인트 VM의 운영 체제에서 스크립트를 실행합니다. Linux 운영 체제에서 특정 권한을 가진 "arcuser" 라는 특수 사용자가 Telegraf 에이전트 설치를 위해 생성됩니다. 그 결과 exec 플러그인이 해당 "arcuser" 사용자를 사용하여 스크립트를 실행합니다. "arcuser" 가 사용자 지정 스크립트를 사용하는 스크립트를 실행할 수 있는지 확인합니다( "arcuser" 에 스크립트를 실행하는 데 필요한 사용 권한이 있어야 함). 예를 들어 클라우드 프록시에서 자동 생성된 "arcuser" 는 /root 디렉토리에 저장된 스크립트를 실행할 권한이 없습니다.
- Windows 운영 체제에서는 시스템 사용자가 Telegraf 에이전트를 설치하는 데 사용됩니다. 그 결과 exec 플러그인이 해당 시스템 사용자를 사용하여 스크립트를 실행합니다. 시스템 사용자에게 권한이 있고 사용자 지정 스크립트를 실행할 수 있는지 확인합니다.
- 스크립트는 /opt/vmware 폴더에 배치되어야 합니다.
- 사용자가 powershell -File 접두사를 사용한 경우 Windows 운영 체제에서 PowerShell 스크립트를 실행하려면 환경 변수 PATH를 설정해야 합니다. 환경 변수 PATH 변수의 "%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\"을 예로 들 수 있습니다.
사용자 지정 스크립트를 실행하는 방법
- Telegraf 에이전트 관리 탭에서 으로 필터링합니다.
- 에이전트가 설치된 엔드포인트 VM에 대해 드롭다운 화살표를 확장합니다. 사용자 지정 모니터링 섹션이 표시됩니다.
- 사용자 지정 스크립트 옵션에 대한 세로 줄임표를 클릭한 다음 추가를 클릭합니다.
- 사용자 지정 서비스 관리 대화상자에서 모니터링할 Windows 서비스를 추가하고 구성할 수 있습니다.
인스턴스 설정
| 옵션 | 설명 |
|---|---|
| 상태 | 사용자 지정 스크립트 실행을 활성화합니다. |
| 표시 이름 | 스크립트에 적합한 이름을 추가합니다. *은(는) 잘못된 문자이므로 이름에 사용하면 안 됩니다. |
| 파일 경로 | End point VM의 스크립트 파일 경로를 입력합니다. 예:
Linux 엔드포인트 VM의 경우:
/opt/vmware/scripts/customscript.pyWindows 엔드포인트 VM의 경우: c:\scripts\customscript.ps1 |
| 접두사 | 필요한 경우 접두사를 입력합니다. 예: Linux 엔드포인트 VM의 경우: python2.7, /bin/bash 또는 perl 등 Windows 엔드포인트 VM의 경우: powershell -File |
| 인수 | 스크립트에 인수를 나열합니다. |
| 시간 초과 | 엔드포인트 VM에 스크립트 실행 시간 제한을 입력합니다. |
스크립트를 저장하면 사용자 지정 스크립트 아래에 나타납니다. 직접 추가한 사용자 지정 스크립트에 대한 세로 줄임표에서 편집 또는 삭제 옵션을 클릭하여 스크립트를 편집하거나 삭제할 수 있습니다. 스크립트를 추가하고 저장한 후 사용자 지정 스크립트에 대한 드롭다운 화살표를 클릭하여 스크립트 목록과 해당 상태를 봅니다.
참고:
- 오류 전파가 작동하려면 사용자 지정 스크립트가 모든 오류를 ERROR|<Error_message> 형식으로 내보내야 합니다. 스크립트가 지정된 형식으로 오류를 내보내지 않으면 VMware Aria Operations에서 사용자 인터페이스에 Unable to parse the error message. Please check the endpoint 오류 메시지를 표시합니다. 이는 클라우드 프록시가 정확한 오류 메시지를 전파할 때까지 설계에 따른 것입니다.
- Bash 스크립트는
shebang (#!/bin/bash)으로 시작해야 합니다.
모든 메트릭 탭
데이터가 성공적으로 수집되면 모든 메트릭 탭에서 엔드포인트 VM의 메트릭으로 스크립트를 볼 수 있습니다. 스크립트 메트릭은 엔드포인트 VM당 단일 개체인 사용자 지정 스크립트로 호출되는 개체 아래에 생성됩니다. 엔드포인트 VM에 대한 스크립트의 모든 메트릭은 생성한 사용자 지정 스크립트가 모두 포함된 사용자 지정 스크립트 개체 아래에 배치됩니다. 특정 메트릭에 대한 출력을 볼 수 있습니다. 스크립트 폴더의 메트릭 이름은 사용자가 스크립트 구성을 생성하는 동안 지정하는 표시 이름입니다. 예를 들어 표시 이름을 Python 스크립트로 설정하면 데이터가 성공적으로 수집된 경우 이름이 Python 스크립트인 메트릭이 생성됩니다.
