Skip to content

eservicesgreece/cacti-go-tools

Repository files navigation

cacti-go-tools

Tools for statistic acquisition from services for cacti

You can find information on setup in the wiki

OS & Arch Support

  • Linux - amd64, 386, arm, arm64, mips, mipsle, ppc64, ppc64le, s390x
  • Windows - 386, amd64
  • OS X - 386, amd64
  • Dragonfly - amd64
  • FreeBSD - 386, amd64, arm
  • NetBSD - 386, amd64, arm
  • openBSD - 386, amd64
  • Solaris - amd64

Build

In most cases this is enough to build:

go get github.com/eservicesgreece/cacti-go-tools

If you would like to build all supported platforms you can use the build.bat and build.sh from here build.bat, it expects a properly setup go environment and upx to be in the path.

Usage

usage: cacti-go-tools.exe [<flags>] <command> [<args> ...]            
                                                                      
Flags:                                                                
  -h, --help     Show context-sensitive help (also try --help-long and
                 --help-man).                                         
  -v, --version  Show application version.                            
                                                                      
Commands:                                                             
  help [<command>...]                                                 
    Show help.                                                        
                                                                      
  config                                                              
    Show Configuration                                                
                                                                      
  engine <enginetype> [<engine options>]                              
    Acquisition Engine                                                
                                                                      
  test nginx <host>                                                   
    Test SNMP Acquisition                                             
                                                                      
  install [<flags>] [<config>] [<binary>]                             
    Install cacti-go-tools                                            

Configuration

The tool retrieves its configuration from the cacti-go-tools.json file, in normal operation you will not need to pass any other parameters other than which engine you want it to use.

Installation

Testing the Setup

You can always test if your setup is working by invocking the tool directly from the command line, to test if your nginx setup is working you would execute:

cacti-go-tools engine nginx

This should show something similar to this:

1
181
181
172
0
1
0

In case there is an error the tool will pass that error directly to the result, for http errors you will receive http/{http status code} Error Example: http/403 Forbidden