본문으로 건너뛰기

exemONE Cloud Agent 독립 설치 방법 및 설정

개요​

exemone-cloud-agent는 AWS, Azure 클라우드 환경의 리소스를 모니터링하기 위한 에이전트로, bin 파일을 이용하여 서버에 단독으로 독립 설치할 수 있습니다.

전제 조건: AWS 모니터링을 위해서는 'AWS 필요 권한'을 사전 확인 후 진행해야 합니다.

1. 지원 환경​

1-1. 클라우드 플랫폼 지원 현황​

클라우드지원 여부
AWS✅ 지원
Azure✅ 지원
OCI❌ 미지원
NCP❌ 미지원
GCP❌ 미지원
SCP❌ 미지원

1-2. OS 및 통신 방식​

항목내용
지원 OSLinux만 지원
통신 방식gRPC (Port: 9009)
통신 대상exemONE 수집 서버 (Receiver)

통신 구조:

2. 설치 방법​

Cloud Agent 독립 설치는 아래 순서로 진행합니다.

2-1. Agent 등록​

메뉴 경로: Setting > Agent > Agent List & Management > Add Agent

Agent 추가 화면에서 Add Agent를 선택하여 Agent를 추가합니다.

Agent 생성 화면에서 Agent ID 및 Access Token을 확인합니다.

  • Access Token은 Regenerate 선택 후 확인하며, 확인 후 반드시 Save해야 합니다.

2-2. Cloud 계정 등록​

메뉴 경로: Cloud > Account > Add Account

Agent 항목에는 2-1단계에서 추가한 Agent를 등록합니다.

2-3. 서버에 exemone-cloud-agent 설치​

설치 방식은 bin 파일과 docker bin 파일 두 가지를 지원합니다.

2-3-1. bin 파일로 설치​

# bin 파일 실행 권한 부여
$ chmod +x setup_exemone-cloud-agent_v3.0.508.15.bin

# bin 파일 실행
[exemone@rocky9 ~]$ ./setup_exemone-cloud-agent_v3.0.508.15.bin
=====================================================
exemone-cloud-agent Install
=====================================================

new install start
Would you like to do a new install? (y/n)
y
xmSuccess(0): Installation is complete.

설치 완료 후 conf/agent.yaml 파일에 Agent ID, Access Token, Receiver 정보를 입력합니다.

주의: 값 입력 시 agent_id: → : 뒤에 반드시 한 칸 띄워야 합니다.

agent.yaml 경로 (bin 파일 설치 시):

설정 완료 후 에이전트를 시작합니다.

./start.sh

2-3-2. docker bin 파일로 설치​

# bin 파일 실행 권한 부여
$ chmod +x setup_exemone-cloud-agent_v3.0.508.15_docker.bin

# bin 파일 실행
[exemone@rocky9 ~]$ ./setup_exemone-cloud-agent_v3.0.508.15_docker.bin
=====================================================
exemone-cloud-agent Install
=====================================================

new install start
Would you like to do a new install? (y/n)
y
version information=v3.0.508.15
.
.
.
Loaded image: maxgauge/exemone-cloud-agent:v3.0.508.15
xmSuccess(0): Installation is complete.

설치 완료 후 conf/agent.yaml 파일에 Agent ID, Access Token, Receiver 정보를 입력합니다.

주의: 값 입력 시 agent_id: → : 뒤에 반드시 한 칸 띄워야 합니다.

agent.yaml 경로 (docker bin 파일 설치 시):

설정 완료 후 에이전트를 시작하고 컨테이너 상태를 확인합니다.

./start.sh
docker ps

3. 주의사항 / 참고​

항목내용
지원 클라우드AWS, Azure만 지원. OCI, NCP, GCP, SCP는 미지원
지원 OSexemone-cloud-agent는 Linux만 지원
통신 포트Receiver와의 통신은 gRPC Port 9009 사용
agent.yaml 입력 주의agent_id: 뒤에 반드시 한 칸 띄워야 함
Access Token 저장Regenerate 후 반드시 Save 버튼 클릭 필수

참고 문서