소개

1. 개요

exemone-db-agent는 클라우드 리소스와 관리형 데이터베이스를 모니터링하는 에이전트입니다.

2. 패키지

2.1. binary 패키지​

• 패키지명: exemone-db-agent-{version}.tar.gz
• 패키지를 압축 풀면 생성되는 패키지 구조

2.1.1. conf​

• agent의 config를 설정하기 위한 파일

2.1.2. libs​

• 지원하는 Database의 드라이버 파일

2.1.3. license​

• agent의 라이센스 파일

2.1.4. logs​

• agent 로그 파일이 위치합니다
  • agent.log : 기본 로그 파일
  • panic.log : panic발생시 생성되는 로그 파일

2.1.5. queries/original​

• db-agent가 수집에 사용하는 쿼리 파일이 위치합니다.
• 고객사 별 쿼리를 지원할 수 있으며 방식은 별도 가이드를 참고하기 바랍니다.
  • [DB Agent] 수집 SQL 쿼리 수정 가이드(쿼리 Export)

2.1.6. history.txt​

• script실행 내역을 저장합니다.

2.1.7. install.txt​

• install시 사용할 정보를 입력하는 파일입니다. 아래 설정이 가능합니다
  • install path
  • Receiver endpoint

2.1.8. .env​

• install시 사용할 버전정보를 입력하는 파일입니다.

2.1.9. setup.sh, start.sh, stop.sh, version.sh​

• 에이전트 기동에 사용하는 스크립트입니다.

2.2. Container 이미지​

• Linux AMD64 및 ARM64용 컨테이너 이미지를 제공합니다.
• 실행 바이너리는 컨테이너의 /usr/local/bin/exemone-db-agent에 위치합니다.
• 기본 설정 템플릿은 /opt/exemone/configs에 포함되며, 사용자 설정과 로그는 /home/exemone 볼륨을 통해 관리합니다.
• 컨테이너는 기본적으로 exemone 일반 사용자 권한으로 실행됩니다.

3. 지원 환경

3.1. 실행 환경​

Go 런타임은 실행 바이너리에 포함되므로 운영 서버에 Go를 별도로 설치할 필요는 없습니다.

3.2. 지원 DB​

• Oracle
  • Oracle 12c 이상
• MySQL/MariaDB
  • MySQL 5.7 이상
  • MariaDB 10 이상
• PostgreSQL
  • PostgreSQL 9.6 이상
• ClickHouse
  • exemone: v3.0.507 이후 지원
  • clickhouse: v24.8.6.70 지원
• Microsoft SQL Server
  • SQL Server 2012 이상
• Altibase
  • altibase 6.3 이상 7.1 지원
• Tibero
  • tibero 5, 6, 7 지원
• MongoDB
  • 4.0.0 이상 지원
• AWS Redshift
• Redis
  • Redis 3.0.0 이상
• Single Store
  • exemone: v3.0.508 이후 지원
  • 8.9 이상 지원( 8.9 이전 버전 확인 필요)
• CUBRID
  • 9.2.1 이상
  • session sql_text 수집은 cubrid 10.2.8 이상 지원

3.3. 지원 OS​

• On Promise
• AWS
• Azure
• OCI
• NCP
• KT Cloud
• SCP