go-centreon is a client SDK for Go applications to access centreon APIs.
For now this project is focus on centreon web application.
First of all you need to init a centreonweb object with the URL of centreon
web application, a boolean to bypass the SSL check, the login and the password
to use to connection to the API. This user should be setup in centreon to be
able to reach the centreon API.
Then you can access each configuration object by an interface (Commands, Hosts, ...).
package main
import (
"fmt"
"os"
"github.com/smutel/go-centreon/centreonweb"
)
func main() {
c, err := centreonweb.New("http://10.182.19.122:8080", true, "admin", "centreon")
if err != nil {
fmt.Println(err.Error())
os.Exit(1)
}
var cmds []centreonweb.Command
cmds, err = c.Commands().Show("")
if err != nil {
fmt.Println(err.Error())
os.Exit(1)
}
fmt.Println("Commands count:", len(cmds))
}For further information you can consult the GoDoc for this package.
To contribute to this project I suggest to use the centreon style guides.
This project is still in progress but you can check the spreadsheet below to
take one task to be implemented.
| Object Name | Object Code | Status |
|---|---|---|
| ACL | ACL | NOT DONE |
| Action ACL | ACLACTION | NOT DONE |
| ACL Groups | ACLGROUP | NOT DONE |
| Menu ACL | ACLMENU | NOT DONE |
| Resource ACL | ACLRESOURCE | NOT DONE |
| Real time Ackcnowledgment | RTACKNOWLEDGEMENT | NOT DONE |
| Centreon Broker | CENTBROKERCFG | NOT DONE |
| Commands | CMD | DONE |
| Contacts | CONTACT | NOT DONE |
| Contact Templates | CONTACTTPL | NOT DONE |
| Contact Groups | CG | NOT DONE |
| Dependencies | DEP | NOT DONE |
| Downtimes | DOWNTIME | NOT DONE |
| Real Time Downtimes | RTDOWNTIME | NOT DONE |
| Engine CFG | ENGINECFG | NOT DONE |
| Host Templates | HTPL | NOT DONE |
| Hosts | HOST | DONE |
| Host Categories | HC | NOT DONE |
| Host Groups | HG | NOT DONE |
| Host Group Services | HGSERVICE | NOT DONE |
| Instances (Pollers) | INSTANCE | NOT DONE |
| LDAP Configuration | LDAP | NOT DONE |
| Resource CFG | RESOURCECFG | NOT DONE |
| Service Templates | STPL | NOT DONE |
| Services | SERVICE | NOT DONE |
| Service Groups | SG | NOT DONE |
| Service Categories | SC | NOT DONE |
| Settings | Settings | NOT DONE |
| Time Periods | TP | DONE |
| Traps | TRAP | NOT DONE |
| Vendors | VENDOR | NOT DONE |
You can find some examples in the examples folder.
Each example can be executed directly with command go run.
You can set different environment variables for your test:
- CENTREON_URL to define the URL (and optionally the port) | DEFAULT=http://127.0.0.1
- CENTREON_ALLOW_UNVERIFIED_SSL to avoid checking the SSL certs (true or false) | DEFAULT=false
- CENTREON_USER to define the user | DEFAULT=admin
- CENTREON_PASSWORD to define the password | DEFAULT=centreon
$ export CENTREON_URL="http://10.164.48.254:8080"
$ export CENTREON_ALLOW_UNVERIFIED_SSL="true"
$ export CENTREON_USER="admin"
$ export CENTREON_PASSWORD="centreon"
$ go run examples/command/commands.go
Commands count: 101
Command check_centreon_dummy found with ID: 59
Command check_centreon_dummy exists
Command added: check-host-alive
Set type (check) of command check-host-alive
Command check-host-alive deleted