bind

Documentation

Index

• Constants
• type Client
• type Counter
• type Gauge
• type Server
• type StatisticGroup
• type Statistics
• type Task
• type TaskManager
• type ThreadModel
• type View
• type ZoneCounter
• type ZoneView

Constants

const (
	// QryRTT is the common prefix of query round-trip histogram counters.
	QryRTT = "QryRTT"
)

Types

type Client

type Client interface {
	Stats(...StatisticGroup) (Statistics, error)
}

Client queries the BIND API, parses the response and returns stats in a generic format.

type Counter

type Counter struct {
	Name    string `xml:"name,attr"`
	Counter uint64 `xml:",chardata"`
}

Counter represents a single counter value.

type Gauge

type Gauge struct {
	Name  string `xml:"name"`
	Gauge uint64 `xml:"counter"`
}

Gauge represents a single gauge value.

type Server

type Server struct {
	BootTime         time.Time
	ConfigTime       time.Time
	IncomingQueries  []Counter
	IncomingRequests []Counter
	NameServerStats  []Counter
	ZoneStatistics   []Counter
	ServerRcodes     []Counter
}

Server represents BIND server statistics.

type StatisticGroup

type StatisticGroup string

StatisticGroup describes a sub-group of BIND statistics.

const (
	ServerStats StatisticGroup = "server"
	ViewStats   StatisticGroup = "view"
	TaskStats   StatisticGroup = "tasks"
)

Available statistic groups.

type Statistics

type Statistics struct {
	Server      Server
	Views       []View
	ZoneViews   []ZoneView
	TaskManager TaskManager
}

Statistics is a generic representation of BIND statistics.

type Task

type Task struct {
	ID         string `xml:"id"`
	Name       string `xml:"name"`
	Quantum    int64  `xml:"quantum"`
	References uint64 `xml:"references"`
	State      string `xml:"state"`
}

Task represents a single running task.

type TaskManager

type TaskManager struct {
	Tasks       []Task      `xml:"tasks>task"`
	ThreadModel ThreadModel `xml:"thread-model"`
}

TaskManager contains information about all running tasks.

type ThreadModel

type ThreadModel struct {
	Type           string `xml:"type"`
	WorkerThreads  uint64 `xml:"worker-threads"`
	DefaultQuantum uint64 `xml:"default-quantum"`
	TasksRunning   uint64 `xml:"tasks-running"`
}

ThreadModel contains task and worker information.

type View

type View struct {
	Name            string
	Cache           []Gauge
	ResolverStats   []Counter
	ResolverQueries []Counter
}

View represents statistics for a single BIND view.

type ZoneCounter

type ZoneCounter struct {
	Name   string
	Serial string
}

Counter represents a single zone counter value.

type ZoneView

type ZoneView struct {
	Name     string
	ZoneData []ZoneCounter
}

View represents statistics for a single BIND zone view.