10. Kịch bản dòng lệnh
10.10. Thêm các mục vào cây biểu đồ
Bây giờ, chúng ta đã tạo ra một số biểu đồ. Điều này được thực hiện bằng cách sử dụng add_tree.php. Nó có thể thêm các mục tiêu đề, máy chủ và biểu đồ vào một cây, cũng như thêm một cây mới chính nó.
shell>php -q add_tree.php --help
Add Tree Script 1.0, Copyright 2004-2010 - The Cacti Group A simple command line utility to add objects to a tree in Cacti usage: add_tree.php --type=[tree|node] [type-options] [--quiet] Tree options: --name=[Tree Name] --sort-method=[manual|alpha|natural|numeric] Node options: --node-type=[header|host|graph] --tree-id=[ID]
[--parent-node=[ID] [Node Type Options]] Header node options:
--name=[Name] Host node options: --host-id=[ID]
[--host-group-style=[1|2]] (host group styles:
1 = Graph Template, 2 = Data Query Index) Graph node options: --graph-id=[ID] [--rra-id=[ID]] List Options: --list-hosts --list-trees --list-nodes --tree-id=[ID] --list-rras --list-graphs --host-id=[ID] 10.10.1. Danh sách các máy chủ
shell>php -q add_tree.php --list-hosts
Known Hosts: (id, hostname, template, description) 1 127.0.0.1 8 Localhost
...
11 router.mydomain.com 3 Device Add Test
10.10.2. Danh sách cây biểu đồ
shell>php -q add_tree.php --list-trees Known Trees:
id sort method name
1 Manual Ordering (No Sorting) Default Tree
10.10.3. Danh sách nội dung
Liệt kê tất cả các nút của một cây được thực hiện bằng.
shell>php -q add_tree.php --list-nodes --tree-id=1 Known Tree Nodes:
type id text
Host 7 127.0.0.1 Graph Template Host 9 gandalf Graph Template Host 12 gandalf Graph Template
10.10.4. Danh sách RRAs
Đặc biệt với tùy chọn thêm cây, bạn sẽ yêu cầu các id của định nghĩa RRA định cụ thể yêu cầu thêm. Đó là lý do vi sao tương ứng với tùy chọn danh sách RRAs được thực hiện.
shell>php -q add_tree.php --list-rras Known RRAs:
id steps rows timespan name
1 1 600 86400 Daily (5 Minute Average)
2 6 700 604800 Weekly (30 Minute Average) 3 24 775 2678400 Monthly (2 Hour Average)
4 288 797 33053184 Yearly (1 Day Average)
10.10.5. Danh sách biểu đồ cho máy chủ
Để có thể thêm một biểu đồ, id của biểu đồ được yêu cầu. Như vậy lựa chọn các thành phần –list-graphs –host-id=[id].
shell>php -q add_tree.php --list-graphs --host-id=1 Known Host Graphs: (id, name, template)
1 Localhost - Memory Usage Linux - Memory Usage 2 Localhost - Load Average Unix - Load Average 3 Localhost - Logged in Users Unix - Logged in Users 4 Localhost - Processes Unix - Processes
5 Localhost - Traffic - eth0 Interface - Traffic (bits/sec, 95th Percentile) 33 Localhost - Used Space - Memory Buffers Host MIB - Available Disk Space 34 Localhost - Used Space - Real Memory Host MIB - Available Disk Space 35 Localhost - Used Space - Swap Space Host MIB - Available Disk Space 36 Localhost - Used Space - / Host MIB - Available Disk Space
37 Localhost - Used Space - /sys Host MIB - Available Disk Space 38 Localhost - Used Space - /boot Host MIB - Available Disk Space
10.10.6. Thêm vào cây biểu đồ mới
Cacti đi kèm với một cây duy nhất, tên mặc định của cây. Cây biểu đồ được sử dụng để thêm nhiều cây. Với add_tree.php, bạn có thể làm như vậy từ dòng lệnh.
shell>php -q add_tree.php --type=tree --name="Test Tree Add" --sort- method=manual
Tree Created - tree-id: (6)
10.10.7. Thêm một nút mới cho cây
Bây giờ cây mới được tạo ra, bạn có thể muốn thêm một nút mới cho cây, sử dụng lệnh
shell>php -q add_tree.php --type=node --node-type=header --tree-id=6 --name="Header Test"
Added Node node-id: (21)
Bạn sẽ muốn lưu các id nếu muốn thêm nút mới. Hãy chú ý rằng, hiện tại không thể để thêm một tiêu đề khác với các tùy chọn tương tự ngay cả khi đây là có thể từ giao diện điều khiển.
Nhưng có thể để thêm một nút con . Ngay cả trong trường hợp này, tên phải là duy nhất.
shell>php -q add_tree.php --type=node --node-type=header --tree-id=6 --parent- node=21 --name="SubHeader
Added Node node-id: (22)
10.10.8. Thêm một nút máy chủ mới cho cây
Chúng ta sẽ phân biệt một vài tùy chọn thêm một máy chủ cho một cây. Đầu tiên để thêm một máy chủ trực tiếp cho một cây. Ví dụ, chúng ta sử dụng id cây trả về từ việc thêm Test Tree Add với id =6
shell>php -q add_tree.php --type=node --node-type=host --tree-id=6 --host-id=1 Added Node node-id: (23)
Khi không –parent-node, máy chủ này trực tiếp tự thêm vào cây. Nếu bạn muốn thêm một máy chủ cho một header, xin ghi rõ như sau
shell>php -q add_tree.php --type=node --node-type=host --tree-id=6 --parent- node=21 --host-id=1
Added Node node-id: (24)
Cả hai ví dụ ma không có một tùy chọn –host-group-stype.Đối với những trường hợp mẫu kiểu nhóm máy chủ được mặc định. Dưới đây là một ví dụ cho việc cung cấp một lựa chọn nhóm máy chủ của các chỉ số truy vấn dữ liệu
shell>php -q add_tree.php --type=node --node-type=host --tree-id=6 --parent- node=22 --host-id=1 --host-gr
10.10.9. Thêm một nút đồ thị cho cây
Giống trên, thay vì các máy chủ có thể thêm một đồ thị cho cây hoặc một header của bất kỳ cây nào. Tất nhiên bạn một lần nữa sẽ yêu cầu id của cây, và tùy chọn của header.
shell>php -q add_tree.php --type=node --node-type=graph --tree-id=6 --graph-id=5 Added Node node-id: (26)
Giống như trên, đồ thị bây giờ được thêm trực tiếp cho cây. Để thêm đồ thì cho các header, tiến hành như sau
shell>php -q add_tree.php --type=node --node-type=graph --tree-id=6 --parent- node=21 --graph-id=5
Added Node node-id: (27)
Trong cả hai trường hợp, đưa ra là không rõ ràng --rra-id. Điều này sẽ mặc định hàng ngày (trung bình 5 phút). Chỉ định bất kỳ --rra-id như được đưa ra.
shell>php -q add_tree.php --type=node --node-type=graph --tree-id=6 --parent- node=21 --graph-id=1 --rra-i
Added Node node-id: (28)
10.11. Thêm quyền đồ thị
Script được sử dụng để xác định quyền truy cập đồ thị đặc biệt cho người dử dụng. Danh sách tham số được hiển thị như thường lệ khi gọi script với tham số –help
shell>php -q add_perms.php --help
Add Permissions Script 1.0, Copyright 2004-2010 - The Cacti Group A simple command line utility to add permissions to tree items in Cacti usage: add_perms.php [ --user-id=[ID] ]
--item-type=[graph|tree|host|graph_template] --item-id [--quiet]
Where item-id is the id of the object of type item-type List Options: --list-users --list-trees --list-graph-templates --list-graphs --host-id=[ID] 10.11.1. Danh sách người sử dụng
shell>php -q add_perms.php --list-users Known Users:
id username full_name 1 admin Administrator 3 guest Guest Account
10.11.2. Danh sách cây đồ thị
shell>php -q add_perms.php --list-trees Known Trees:
id sort method name
1 Manual Ordering (No Sorting) Default Tree
10.11.3. Danh sách mẫu đồ thị
shell>php -q add_perms.php --list-graph-templates Known Graph Templates:(id, name)
2 Interface - Traffic (bits/sec) 3 ucd/net - Available Disk Space 4 ucd/net - CPU Usage
5 Karlnet - Wireless Levels
6 Karlnet - Wireless Transmissions 7 Unix - Ping Latency
8 Unix - Processes 9 Unix - Load Average ...
10.11.4. Danh sách đồ thị cho máy chủ
Để có thể thêm một quyền cho đồ thị đặc biệt, id của đồ thị được yêu câu. Do đó một danh sách các đồ thị –list-graphs –host-id=[id] tùy chọn được thực hiện.
shell>php -q add_perms.php --list-graphs --host-id=1 Known Host Graphs: (id, name, template)
1 Localhost - Memory Usage Linux - Memory Usage 2 Localhost - Load Average Unix - Load Average 3 Localhost - Logged in Users Unix - Logged in Users 4 Localhost - Processes Unix - Processes
5 Localhost - Traffic - eth0 Interface - Traffic (bits/sec, 95th Percentile) 33 Localhost - Used Space - Memory Buffers Host MIB - Available Disk Space 34 Localhost - Used Space - Real Memory Host MIB - Available Disk Space 35 Localhost - Used Space - Swap Space Host MIB - Available Disk Space 36 Localhost - Used Space - / Host MIB - Available Disk Space
37 Localhost - Used Space - /sys Host MIB - Available Disk Space 38 Localhost - Used Space - /boot Host MIB - Available Disk Space
10.11.5.Thêm quyền đồ thị cho người sử dụng đặc biệt
Có nhiều cách khác nhau để xác định quyền truy cập đồ thị đối với người dùng cụ thể. Trước tiên, chúng ta sẽ thêm quyền đồ thị cho máy chủ. Điều này được thực hiện bằng cách sử dụng các tham số --item-type=host như sau.
shell>php -q add_perms.php --user-id=4 --item-type=host --item-id=1
--user-id=4 phải chỉ định một người dùng hiện tại. Mặt khác, một thông báo lỗi sẽ được in. – item-type=host.
--item-id=1 phải chỉ định một máy chủ hợp lệ. Một lần nữa, nếu không có máy chủ với id cụ thể này tồn tai, một thông báo lỗi sẽ được in. Không có đầu ra được sản xuất trên các hoạt động thành công.
Tiếp theo, chúng ta sẽ thêm quyền đồ thị cho một cây nhất định. Điều này được thực hiện bằng cách sử dụng cac tham số –item-type=tree như sau
shell>php -q add_perms.php --user-id=4 --item-type=tree --item-id=1
--user-id=4 phải chỉ định một người dùng hiện tại. Mặt khác một thông báo lỗi sẽ được in như – item-type=tree được đưa ra.
--item-id=1 phải được chỉ định một cây có giá trị. Một lần nữa, nếu không có cây này id cụ thể tồn tại, một thông báo lỗi sẽ được in. Đầu ra không được sản xuất trên các hoạt động thành công. Thêm quyền đồ thị cho một mẫu đồ thị được thực hiện bằng cách sử dụng các tham số –item- type=graph_template như sau.
shell>php -q add_perms.php --user-id=4 --item-type=graph_template --item-id=25
--user-id=4 phải chỉ định một người dùng hiện tại. Mặt khác một thông báo lõi sẽ được in. Như --item-type=graph được đưa ra, --item-id=1 phải chỉ định một graph_template. Một lần nữa, nếu không có mẫu đồ thị với các id cụ thể này tồn tại, một thông báo lỗi sẽ được in, không đưa ra được kết quả về thành công của hoạt động.
Cuối cùng nhưng không kém chúng ta thêm quyền đồ thị cho một đồ thị bằng cách sử dụng các tham số --item-type=graph như sau
shell>php -q add_perms.php --user-id=4 --item-type=graph --item-id=8
--user-id=4 phải chỉ định một người dùng hiện tại. Mặt khác, một thông báo lỗi sẽ được in như --item-type=graph được đưa ra, --item-id=1 phải chỉ định một đồ thị có giá trị. Một lần nữa, nếu không có mẫu đồ thị với các id cụ thể này tồn tại, một thông báo lỗi sẽ được in. Không đầu ra được đưa ra trên thành công của hoạt động.