Node.js 수집기 에이전트 설치 및 시작
관리자는 Node.js 수집기 에이전트를 설치하고 선택적 구성 작업을 수행합니다.
apmdevops104kr
관리자는 Node.js 수집기 에이전트를 설치하고 선택적 구성 작업을 수행합니다.
Node.js 에이전트 같은 일부 에이전트의 경우에는 응용 프로그램 성능 데이터를 제공하기 위해 함께 작동하는 두 가지 에이전트 구성 요소가 있습니다. 이 두 구성 요소는 프로브 에이전트와 수집기 에이전트입니다.
- 프로브 에이전트는 응용 프로그램 데이터를 메트릭 형태로 수집하여 수집기 에이전트로 전송합니다.
- 수집기 에이전트는 프로브 에이전트 데이터를 수신한 후 처리를 위해 Enterprise Manager로 전송합니다.
수집기 에이전트를 설치하면 로컬 JRE(Java Runtime Environment)도 설치되어 사용됩니다. 단일 수집기 에이전트가 여러 프로브 에이전트(예: Node.js 및 PHP)를 처리할 수 있습니다.
수집기 에이전트 디렉터리 구조
Node.js 수집기 에이전트는 설치, 제거, 업그레이드 및 롤백에 특정 디렉터리를 사용합니다. 수집기 에이전트를 설치하면 Introscope는 extensions 디렉터리와 backup 및 deploy 하위 디렉터리를 생성합니다.
Node.js 수집기 에이전트를 설치하면 Introscope는 NodeExtension 디렉터리와 하위 디렉터리를 생성합니다.
- <에이전트 홈>
- core/config
- ext
- extensions- 에이전트 확장을 관리하기 위한 하위 디렉터리와 파일이 포함됩니다.
- backup- 제거, 업그레이드 및 롤백된 에이전트 확장에 대한 이전 버전의 .tar.gz 파일이 포함됩니다.
- deploy- deploy 디렉터리에 저장되는 모든 확장에 대한 배포 및 tar.gz 파일이 포함됩니다.
- metadata- 에이전트 확장을 가져온 후에 APM Command Center에서 사용하는 bundle.json, description.md 및 installInstructions.md 파일이 포함됩니다. 확장 정보를 보려는 경우 텍스트 편집기에서 description.md 및 installInstructions.md 파일을 검토할 수 있습니다.
- lib- 에이전트 확장 JAR 파일이 포함됩니다.
- directives- 에이전트 확장 PBD 파일이 포함됩니다.
Node.js 수집기 에이전트 파일
수집기 에이전트는 다음과 같은 파일을 사용합니다.
- IntroscopeCollectorAgent.profileNode.js 에이전트 프로필은 <설치 홈>/CollectorAgent-<버전>/core/config 디렉터리에 있습니다.
- bundle.propertiesbundles.properties 파일은 <설치 홈>/extensions/NodeExtension 디렉터리에 있습니다. bundle.properties 파일의 속성에는 확장과 관련된 속성이 포함될 수 있습니다. bundles.properties에는 동적(핫) 속성과 제어되는(콜드) 속성이 모두 포함할 수 있습니다. 제어되는 속성을 적용하려면 응용 프로그램을 다시 시작해야 합니다.
- ProbeBuilder 지시문Node.js PBD 파일은 <에이전트 홈>/extensions/NodeExtension/directives 디렉터리에 있습니다. 이 파일은 Node.js 에이전트가 계측할 수 있는 Node.js 메서드 및 클래스를 결정합니다.
- nodejs-toggles.pbd
- nodejs-common.pbd
- nodejs-mongodb.pbd
Node.js 수집기 에이전트 설치 및 시작
Node.js 수집기 에이전트를 설치하면 로컬 JRE(Java Runtime Environment)도 설치되어 사용됩니다.
Node.js 수집기 에이전트는 여러 개의 Node.js 프로브 에이전트 연결을 지원합니다.
추가 정보:
수집기 에이전트 크기 조정 권장 사항다음 단계를 따르십시오.
- CollectorAgent-<버전> 패키지 파일의 내용을 원하는 설치 위치에 추출합니다. 운영 체제 명령을 사용하여 파일을 추출합니다.UNIX:tar xzvpf CollectorAgent-<version>-unix.tar.gzWindows: CollectorAgent-<버전>-windows.zip의 압축을 풉니다.MAC:tar xzvpf CollectorAgent-<version>-mac.tar.gz
- /bin 디렉터리로 이동합니다.
- Node.js 수집기 에이전트를 시작합니다.UNIX: 셸 스크립트를 사용하여 Node.js 수집기 에이전트를 설치하고 시작합니다. 다음 명령을 입력합니다.sh CollectorAgent.shWindows: CollectorAgent.cmd 파일을 실행합니다.MAC:셸 스크립트를 사용하여 Node.js 수집기 에이전트를 설치하고 시작합니다. 다음 명령을 입력합니다.sh CollectorAgent.shEnterprise Manager는 해당 로그에서 Node.js 수집기 에이전트 연결에 대한 세부 정보를 보고합니다.
- (선택 사항) Node.js 수집기 에이전트의 상태를 확인합니다. 예를 들어 다음과 같은 명령을 사용하십시오.<INSTALL_DIR>/CollectorAgent-<version>-<OS>/bin/CollectorAgent.sh status
- (선택 사항) Node.js 수집기 에이전트를 중지합니다. 예를 들어 다음과 같은 명령을 사용하십시오.<INSTALL_DIR>/CollectorAgent-<version>-<OS>/bin/CollectorAgent.sh stop
(Linux만 해당되는 선택 사항) Node.js 수집기 에이전트를 서비스로 설치합니다.
Linux에서는 Node.js 수집기 에이전트를 서비스로 설치할 수 있습니다. 서비스로 설치된 Node.js 수집기 에이전트는 설치 후 자동으로 시작됩니다. Node.js 수집기 에이전트가 시작된 후에는 더 이상 root가 아닌 계정에서 이를 제어할 수 없습니다. Node.js 수집기 에이전트를 제어하려면 권한 있는 계정이나
sudo
를 사용해야 합니다.다음 단계를 따르십시오.
- 루트 또는 슈퍼 사용자로 다음 명령을 입력합니다.[root@nodejs_app bin]# ./CollectorAgent.sh install다음과 같은 메시지가 나타납니다.Installing CollectorAgent as service.CollectorAgent installed as collector_agent서비스가 설치된 후에는 호스트가 시작될 때마다 서비스가 자동으로 시작됩니다.예를 들어 Linux 서비스 명령을 통해 모든 기능에 액세스할 수 있습니다.[root@nodejs_app bin]# service collector_agent status[root@nodejs_app bin]# service collector_agent stop[root@nodejs_app bin]# service collector_agent start
- (선택 사항) Linux 서비스에서 Node.js 수집기 에이전트를 제거합니다. 다음 명령을 입력합니다.[root@nodejs_app bin]# ./CollectorAgent.sh uninstall서비스를 더 이상 사용할 수 없습니다.
(선택 사항) Node.js 수집기의 기본 호스트 이름 및 포트 변경
Node.js 수집기 에이전트 설치에는 기본 호스트 이름으로 localhost가 사용되고 기본 포트로 5001이 사용됩니다. 구현에 맞게 이러한 기본값을 변경할 수 있습니다.
다음 단계를 따르십시오.
- 구성 디렉터리로 이동합니다. 예:<설치 홈>/CollectorAgent-<버전>/core/config
- IntroscopeCollectorAgent.profile파일을 텍스트 편집기에서 엽니다.
- 다음 섹션을 찾습니다.# Enterprise Manager Locations and Names
- 다음 예와 같이 데이터를 전송할 Enterprise Manager의 호스트 이름 및 포트를 지정합니다.agentManager.url.1=localhost:5001
- 파일을 저장하고 닫습니다.
- 응용 프로그램 서버를 다시 시작합니다.