Note, this is not tested and is adjusted for use of tpretz/terraform-provider-zabbix
This Go package provides access to Zabbix API.
Tested on Zabbix 3.2, 3.4, 4.0, 4.2 and 4.4, but should work since 2.0 version.
This package aims to support multiple zabbix resources from its API like trigger, application, host group, host, item, template..
Install it: go get github.com/tpretz/go-zabbix-api
package main
import (
"fmt"
"github.com/tpretz/go-zabbix-api"
)
func main() {
user := "MyZabbixUsername"
pass := "MyZabbixPassword"
api := zabbix.NewAPI("http://localhost/api_jsonrpc.php")
api.Login(user, pass)
res, err := api.Version()
if err != nil {
panic(err)
}
fmt.Printf("Connected to zabbix api v%s\n", res)
}
You should run tests before using this package. Zabbix API doesn't match documentation in few details, which are changing in patch releases.
Tests are not expected to be destructive, but you are advised to run them against not-production instance or at least make a backup.
For a safer and more accurate testing we advice to run tests with following minimum versions which implements strict validation of valuemap for get
method:
- 4.0.13rc1 6ead4fd7865
- 4.2.7rc1 a1d257bf6a3
- 4.4.0alpha3 db94d75b4bf
For more information, please see issues ZBX-3783 and ZBX-3685
export TEST_ZABBIX_URL=http://localhost:8080/zabbix/api_jsonrpc.php
export TEST_ZABBIX_USER=Admin
export TEST_ZABBIX_PASSWORD=zabbix
export TEST_ZABBIX_VERBOSE=1
go test -v
TEST_ZABBIX_URL
may contain HTTP basic auth username and password: http://username:password@host/api_jsonrpc.php
. Also, in some setups URL should be like http://host/zabbix/api_jsonrpc.php
.
Documentation is available on godoc.org. Also, Rafael Fernandes dos Santos wrote a great article about using and extending this package.
License: Simplified BSD License (see LICENSE).