Cacti on Joonlog

Cacti Conainer 구축

Wed, 30 Jul 2025 09:00:00 +0900

Containerd 사용

Git 소스 코드

1
2


dnf install -y git-all
git clone https://github.com/scline/docker-cacti.git

Containerd 환경 구축

https://containerd.io/downloads/ 여기서 다운로드도 가능

https://medium.com/@DannielWhatever/using-containerd-without-docker-9d08332781b4

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo dnf remove $pkg -y; done
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install -y containerd.io
containerd config default | sudo tee /etc/containerd/config.toml

### containerd root 디렉토리 외에 data 디렉토리에서 동작하도록 설정
sed -i 's|^root = .*|root = "/data/container/containerd"|' /etc/containerd/config.toml
sed -i 's|^state = .*|state = "/data/container/containerd-state"|' /etc/containerd/config.toml
mkdir -p /data/container/containerd
mkdir -p /data/container/containerd-state
mkdir -p /data/container/nerdctl
echo 'export NERDCTL_DATA_ROOT=/data/container/nerdctl' >> ~/.bashrc
source ~/.bashrc

# nerdctl 설치
wget https://github.com/containerd/nerdctl/releases/download/v0.17.0/nerdctl-0.17.0-linux-amd64.tar.gz
tar Cxzvvf /usr/bin nerdctl-0.17.0-linux-amd64.tar.gz
echo "source <(nerdctl completion bash)" >> ~/.bashrc

# CNI 설치
wget https://github.com/containernetworking/plugins/releases/download/v1.0.1/cni-plugins-linux-amd64-v1.0.1.tgz
mkdir -p /opt/cni/bin
tar Cxzvvf /opt/cni/bin cni-plugins-linux-amd64-v1.0.1.tgz

# buildkit 설치
wget https://github.com/moby/buildkit/releases/download/v0.10.0-rc1/buildkit-v0.10.0-rc1.linux-amd64.tar.gz
tar Cxzvvf /usr/bin buildkit-v0.10.0-rc1.linux-amd64.tar.gz
nohup /usr/bin/builkitd < /dev/null > /var/log/buildkitd 2>&1 &

systemctl enable --now containerd

Cacti Container 구조

cacti master와 master용 DB
cacti poller와 poller용 DB

docker-compose-master.yaml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73


version: '3.5'

services:
 cacti-master:
 image: "smcline06/cacti"
 container_name: cacti_master
 hostname: cactimaster
 depends_on:
 - db-master
 ports:
 - "80:80"
 - "443:443"
 environment:
 - DB_NAME=cacti_master
 - DB_USER=cactiuser
 - DB_PASS=cactipassword
 - DB_HOST=db-master
 - DB_PORT=3306
 - DB_ROOT_PASS=rootpassword
 - INITIALIZE_DB=1
 - TZ=Asia/Seoul
 volumes:
 - cacti-master-data:/cacti
 - cacti-shared-rra:/cacti/rra
 - cacti-master-spine:/spine
 - cacti-master-backups:/backups
 networks:
 - cacti-net

 db-master:
 image: "mariadb:10.3"
 container_name: cacti_master_db
 hostname: db-master
 ports:
 - "3306:3306"
 command:
 - mysqld
 - --character-set-server=utf8mb4
 - --collation-server=utf8mb4_unicode_ci
 - --max_connections=200
 - --max_heap_table_size=128M
 - --max_allowed_packet=32M
 - --tmp_table_size=128M
 - --join_buffer_size=128M
 - --innodb_buffer_pool_size=1G
 - --innodb_doublewrite=ON
 - --innodb_flush_log_at_timeout=3
 - --innodb_read_io_threads=32
 - --innodb_write_io_threads=16
 - --innodb_buffer_pool_instances=9
 - --innodb_file_format=Barracuda
 - --innodb_large_prefix=1
 - --innodb_io_capacity=5000
 - --innodb_io_capacity_max=10000
 environment:
 - MYSQL_ROOT_PASSWORD=rootpassword
 - TZ=Asia/Seoul
 volumes:
 - cacti-db-master:/var/lib/mysql
 networks:
 - cacti-net

volumes:
 cacti-db-master:
 cacti-master-data:
 cacti-shared-rra:
 cacti-master-spine:
 cacti-master-backups:

networks:
 cacti-net:
 name: cacti-net
 external: true

docker-compose-poller.yaml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80


version: '3.5'

services:
 cacti-poller:
 image: "smcline06/cacti"
 container_name: cacti_poller
 hostname: cactipoller
 depends_on:
 - db-poller
 ports:
 - "8080:80"
 - "8443:443"
 environment:
 - DB_NAME=cacti_poller
 - DB_USER=cactipolleruser
 - DB_PASS=cactipollerpassword
 - DB_HOST=db-poller
 - DB_PORT=3306
 - RDB_NAME=cacti_master
 - RDB_USER=cactiuser
 - RDB_PASS=cactipassword
 - RDB_HOST=db-master
 - RDB_PORT=3306
 - DB_ROOT_PASS=rootpassword
 - REMOTE_POLLER=1
 - INITIALIZE_DB=1
 - TZ=Asia/Seoul
 volumes:
 - cacti-poller-data:/cacti
 - cacti-shared-rra:/cacti/rra
 - cacti-poller-spine:/spine
 - cacti-poller-backups:/backups

 networks:
 - cacti-net

 db-poller:
 image: "mariadb:10.3"
 container_name: cacti_poller_db
 hostname: db-poller
 command:
 - mysqld
 - --character-set-server=utf8mb4
 - --collation-server=utf8mb4_unicode_ci
 - --max_connections=200
 - --max_heap_table_size=128M
 - --max_allowed_packet=32M
 - --tmp_table_size=128M
 - --join_buffer_size=128M
 - --innodb_buffer_pool_size=1G
 - --innodb_doublewrite=ON
 - --innodb_flush_log_at_timeout=3
 - --innodb_read_io_threads=32
 - --innodb_write_io_threads=16
 - --innodb_buffer_pool_instances=9
 - --innodb_file_format=Barracuda
 - --innodb_large_prefix=1
 - --innodb_io_capacity=5000
 - --innodb_io_capacity_max=10000
 environment:
 - MYSQL_ROOT_PASSWORD=rootpassword
 - TZ=Asia/Seoul
 volumes:
 - cacti-db-poller:/var/lib/mysql
 networks:
 - cacti-net

volumes:
 cacti-db-poller:
 cacti-poller-data:
 cacti-shared-rra:
 name: containerd-cacti_cacti-shared-rra
 external: true
 cacti-poller-spine:
 cacti-poller-backups:

networks:
 cacti-net:
 name: cacti-net
 external: true

cacti-net CNI

ip 지정해서 쓰기 위한 사전 세팅

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44


cat <<EOF > /etc/cni/net.d/cacti-net.conflist
{
 "cniVersion": "0.4.0",
 "name": "cacti-net",
 "nerdctlID": 2,
 "nerdctlLabels": {
 "com.docker.compose.network": "cacti-net",
 "com.docker.compose.project": "cacti"
 },
 "plugins": [
 {
 "type": "bridge",
 "bridge": "cactibr0",
 "isGateway": true,
 "ipMasq": true,
 "ipam": {
 "type": "host-local",
 "ranges": [
 [
 {
 "subnet": "10.99.0.0/24",
 "gateway": "10.99.0.1"
 }
 ]
 ],
 "routes": [
 { "dst": "0.0.0.0/0" }
 ]
 }
 },
 {
 "type": "portmap",
 "capabilities": { "portMappings": true }
 },
 {
 "type": "firewall"
 },
 {
 "type": "tuning"
 }
 ]
}

EOF

cacti 컨테이너 실행

1
2
3
4
5


nerdctl compose -f docker-compose-master.yaml up -d
nerdctl compose -f docker-compose-poller.yaml up -d

# netstat으로 port 확인 안됨
iptables -t nat -L -n -v

SNMP 체크

1

snmpwalk -v2c -c public <ip>:<port> system

Cacti Conainer의 Script Tools

Tue, 29 Jul 2025 09:00:00 +0900

Backup

백업
1

docker exec <docker image ID or name> ./backup.sh
- 루트 Cacti/Spine 디렉토리 복사 및 cacti DB 덤프 수행
- cacti container의 /backups 디렉토리 아래에 tar.gz 형식으로 압축 백업 저장
- BACKUP_RETENTION 값 조정. 기본값 7개

백업 복원

1

docker exec <docker image ID or name> ./restore.sh /backups/<filename>

백업 목록 조회

1

docker exec <docker image ID or name> ls /backups

Update

1

docker exec <docker image ID or name> ./upgrade.sh

버전 지정 시 upgrade.sh 수정
- Cacti Version Links
- Spine Version Links

Template

시작 시 스크립트가 가져와서 설치됨

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


├── templates
│ ├── template_name.xml
│ ├── resource
│ │ └── script_queries
│ │ └── ...
│ │ └── script_server
│ │ └── ...
│ │ └── snmp_queries
│ │ └── ...
│ ├── scripts
│ │ └── ...

Plugins

plugins 디렉토리에 플러그인을 넣는 것으로 부팅 시 자동 로드
Cacti GUI에서 플러그인 활성화 필요
컨테이너 동작 후 플러그인 추가하려면 docker volume을 통해 마운트 필요

Settings

sql 변경사항을 settings 디렉토리 아래에 배치하여 초기 설치 시 설정 가능

start.sh가 설치 시 모든 *.sql을 병합하기 때문

ex) settings/spine.sql은 spine 활성화하기 위한 sql

1
2
3
4
5
6
7


--
-- Enable spine poller from docker installation
--

REPLACE INTO `%DB_NAME%`.`settings` (`name`, `value`) VALUES('path_spine', '/spine/bin/spine');
REPLACE INTO `%DB_NAME%`.`settings` (`name`, `value`) VALUES('path_spine_config', '/spine/etc/spine.conf');
REPLACE INTO `%DB_NAME%`.`settings` (`name`, `value`) VALUES('poller_type', '2');

Cacti Conainer 환경변수

Mon, 28 Jul 2025 09:00:00 +0900

Cacti Master

환경 변수	기능
DB_NAME	MySQL DB 이름. Cacti, Spine Poller 공유
DB_USER	MySQL DB 사용자. Cacti, Spine Poller 공유
DB_PASS	MySQL DB 비밀번호. Cacti, Spine Poller 공유
DB_HOST	DB IP/FQDN/호스트/컨테이너이름
DB_PORT	MySQL DB 포트. 기본값 3306
DB_ROOT_PASS	`INITIALIZE_DB`가 1로 설정된 경우 필요
INITIALIZE_DB	`0: false` / `true: 1`. true면 컨테이너는 대상 데이터베이스에 대한 `DB_ROOT_PASS`를 요구. DB 초기화 설정
TZ	타임존 설정
BACKUP_RETENTION	보관할 백업 파일의 수
REMOTE_POLLER	`0: false` / `true: 1`
PHP_MEMORY_LIMIT	PHP 메모리 제한 조정, 기본값은 128M
PHP_MAX_EXECUTION_TIME	PHP 최대 실행 시간 조정, 기본값은 30초
PHP_SNMP	0으로 설정하면 PHP-SNMP 제거. 기본값은 php-snmp 활성화. 일부 스크립트나 snmpv3가 제대로 동작하기 위해 필요

Cacti Pollers

환경 변수	기능
DB_NAME	MySQL DB 이름. Cacti, Spine Poller 공유
DB_USER	MySQL DB 사용자. Cacti, Spine Poller 공유
DB_PASS	MySQL DB 비밀번호. Cacti, Spine Poller 공유
DB_HOST	MySQL DB IP/FQDN/호스트/컨테이너이름
DB_PORT	MySQL DB 포트. 기본값 3306
CACTI_URL_PATH	기본값은 cacti. ex) http:///cacti. 루트 URL 변경만 허용되므로 “cacti” 만 변경 가능. “ccc/bb” 같은 것 불가능
DB_ROOT_PASS	`INITIALIZE_DB`가 1로 설정된 경우 필요
INITIALIZE_DB	`0: false` / `true: 1`. true면 컨테이너는 대상 데이터베이스에 대한 `DB_ROOT_PASS`를 요구. DB 초기화 설정
TZ	타임존 설정
BACKUP_RETENTION	보관할 백업 파일의 수
REMOTE_POLLER	`0: false` / `true: 1`
RDB_NAME	Cacti Master MySQL DB 이름. Cacti, Spine Poller 공유
RDB_USER	Cacti Master MySQL DB 사용자
RDB_PASS	Cacti Master MySQL DB 사용자의 비밀번호
RDB_HOST	Cacti Master MySQL DB가 사용하는 IP/FQDN/호스트/컨테이너이름
RDB_PORT	Cacti Master MySQL DB 사용 포트

DB 파라미터

MySQL 변수	추천 값	설명
Version	>= 5.6	MySQL 5.6+ 및 MariaDB 10.0+은 훌륭한 릴리스 버전으로, 안정성과 성능이 뛰어납니다. 특히 최신 릴리스는 네트워킹 문제를 해결하여 Spine의 신뢰성을 개선합니다.
collation_server	utf8mb4_unicode_ci	영어 이외의 언어를 사용할 경우, 일부 문자가 1바이트 이상을 차지하므로 `utf8mb4_unicode_ci` 정렬 타입을 사용하는 것이 중요합니다.
character_set_client	utf8mb4	영어 이외의 언어를 사용할 경우, 일부 문자가 1바이트 이상을 차지하므로 `utf8mb4` 문자셋을 사용하는 것이 중요합니다.
max_connections	>= 100	Spine 데이터 수집기와 로그인 수에 따라 많은 MySQL 연결이 필요할 수 있습니다. Spine의 연결 수 계산법은 다음과 같습니다: `total_connections = total_processes * (total_threads + script_servers + 1)`. 사용자 연결을 위한 여유 공간을 남겨야 합니다.
max_heap_table_size	>= 10% RAM	Cacti 성능 향상 기능을 사용하여 메모리 스토리지 엔진을 선택할 경우, 시스템 메모리 테이블 공간이 부족하기 전에 Performance Booster 버퍼를 플러시해야 합니다. 이 값은 시스템 메모리의 10%로 설정하는 것이 권장되지만, SSD 디스크를 사용하거나 작은 시스템에서는 무시할 수도 있습니다.
max_allowed_packet	>= 16777216	원격 폴링 기능을 사용할 때, 많은 데이터가 메인 서버에서 원격 폴러로 동기화됩니다. 따라서 이 값을 16M 이상으로 설정해야 합니다.
tmp_table_size	>= 64M	서브쿼리를 실행할 때, 임시 테이블 크기를 크게 설정하면 메모리 내에 임시 테이블을 유지할 수 있습니다.
join_buffer_size	>= 64M	조인 연산이 이 크기보다 작으면 메모리에 저장되어 임시 파일로 쓰여지지 않습니다.
innodb_file_per_table	ON	InnoDB 스토리지를 사용할 때, 테이블 공간을 분리하여 관리가 더 간편해집니다. 현재 OFF로 설정되어 있다면 이 기능을 활성화하고 InnoDB 테이블에 대해 `ALTER` 명령을 실행하여 마이그레이션할 수 있습니다.
innodb_file_format	Barracuda	`innodb_file_per_table`을 사용할 때, 파일 형식을 Barracuda로 설정해야 합니다. 이는 특정 Cacti 테이블에 필요한 긴 인덱스를 허용합니다.
innodb_large_prefix	1	테이블에 매우 큰 인덱스가 있는 경우, Barracuda 파일 형식과 함께 이 값을 1로 설정해야 합니다. 그렇지 않으면 일부 플러그인이 테이블을 제대로 생성하지 못할 수 있습니다.
innodb_buffer_pool_size	>= 25% RAM	InnoDB는 가능한 한 많은 테이블과 인덱스를 시스템 메모리에 보관합니다. 이 값을 충분히 크게 설정하여 테이블과 인덱스를 메모리에 저장하세요. `/var/lib/mysql/cacti` 디렉토리의 크기를 확인하면 적절한 값을 설정하는 데 도움이 됩니다.
innodb_doublewrite	ON	ZFS 또는 FusionI/O와 같은 내부 저널링 기능을 가진 파일 시스템을 사용하는 경우가 아니라면 이 값을 ON으로 유지하세요. 하지만 시스템 안정성이 매우 높고 백업이 잘 되어 있다면 OFF로 설정하여 데이터베이스 성능을 약 50% 개선할 수 있습니다.
innodb_lock_wait_timeout	>= 50	비정상적인 쿼리로 인해 데이터베이스가 다른 사용자에게 응답하지 못하는 것을 방지합니다.
innodb_flush_log_at_timeout	>= 3	높은 I/O 시스템에서 이 값을 1초 이상으로 설정하면 디스크 I/O가 더 순차적으로 작동할 수 있습니다.
innodb_read_io_threads	>= 32	최신 SSD 스토리지에서는 높은 I/O 특성을 가진 애플리케이션에 다중 읽기 I/O 스레드가 유리합니다.
innodb_write_io_threads	>= 16	최신 SSD 스토리지에서는 높은 I/O 특성을 가진 애플리케이션에 다중 쓰기 I/O 스레드가 유리합니다.
innodb_buffer_pool_instances	>= 9	InnoDB는 `innodb_buffer_pool`을 메모리 영역으로 분리하여 성능을 향상합니다. 1GB 이하에서는 `pool size / 128MB`를 사용하고, 최대값은 64로 설정합니다.
innodb_io_capacity	5000	SSD 디스크에서는 5000을 사용하고, 물리적 디스크에서는 활성 드라이브 수에 200을 곱한 값을 사용합니다. NVMe 또는 PCIe 플래시의 경우 최대 100,000까지 설정 가능합니다.
innodb_io_capacity_max	10000	SSD 디스크에서는 10,000을 사용하고, 물리적 디스크에서는 활성 드라이브 수에 2000을 곱한 값을 사용합니다. NVMe 또는 PCIe 플래시의 경우 최대 200,000까지 설정 가능합니다.
memory_limit	>= 800M	메모리 제한은 최소 800MB로 설정하세요.
max_execution_time	>= 60	PHP 스크립트 실행 시간을 최소 60초로 설정하세요.

Cacti Conainer 구조

Sun, 27 Jul 2025 09:00:00 +0900

https://github.com/scline/docker-cacti

Dockerfile

https://github.com/scline/docker-cacti/blob/master/Dockerfile
Rocky 9.0을 베이스 이미지로 사용
환경 변수로 DB 접속 정보, URL 경로, PHP 기본값 설정
start.sh 복사 및 실행
cacti + spine tar.gz 복사
서포트 파일(configs, configs/crontab, backup, upgrade, restore) 복사
RUN
- sh 파일 실행 권한 추가
- 볼륨 디렉토리 /backups, /cacti, /spine 생성
- 패키지 업데이트 및 설치(php, mariadb, 소스 설치 도구 등)

start.sh

https://github.com/scline/docker-cacti/blob/master/start.sh
초기 환경 설정
- PHP 설정, 시스템 TZ 설정
새 설치 여부 판단
- /cacti/install.lock 파일의 존재 여부로 이미 설치된 상태인지 판단
- Cacti와 Spine 파일 압축 해제, 필요한 디렉토리로 이동
- 템플릿 파일, 플러그인, 설정 파일들을 적절한 위치에 복사하여 기본 환경을 구성
- DB가 준비될 때까지 대기 후, 데이터베이스 생성 및 사용자 권한 설정, 그리고 cacti.sql 파일을 DB에 적용하여 초기 데이터를 세팅합니다.
- REMOTE_POLLER가 1이면, 마스터와의 설정 연동을 위한 추가 작업(예, config.php 수정, 파일 권한 조정 등)을 수행합니다.
서비스 시작
- crond, snmpd, php-fpm, apache 실행

Compose 구조

https://github.com/scline/docker-cacti/blob/master/docker-compose/cacti_multi_shared.yml
Cacti Master+ Cacti Master DB + Poller + Poller DB

Cacti
- 위 Dockerfile로 생성한 cacti 이미지 사용
- 웹 인터페이스 및 기본 Cacti 기능용 주 컨테이너
- 환경변수로 db 접속 정보 설정
- /cacti, /spine, /backups 볼륨 공유
Poller
- 위 Dockerfile로 생성한 cacti 이미지 사용
- 환경변수 REMOTE_POLLER=1가 설정되어 원격 풀러(데이터 수집 전용)로 동작
- cacti_poller DB 접속 정보와 동시에 마스터 DB 접속 정보를 전달받아, 마스터로부터 설정을 가져와서 폴링 작업만 수행하도록 구성
- /cacti, /spine, /backups 볼륨 공유
DB
- MariaDB 10.3 이미지 사용하며, Cacti와 Poller가 각각 DB 사용
Network
- 4개 컨테이너가 같은 네트워크공유
Volume
- Cacti와 Poller가 호스트의 /cacti, /spine, /backups 볼륨 공유
- /var/lib/mysql를 db volume으로 사용