api

Documentation

Index

• type AggregateData
  • func (a *AggregateData) Merge(b *AggregateData)
• type Container
  • func NewContainer() *Container
• type ExternalNode
• type ExternalNodeList
• type Pod
• type PodMetadata
• type Source

Types

type AggregateData

type AggregateData struct {
	Pods       []Pod
	Containers []Container
	// TODO: Add node metadata.
	Machine []Container
	Events  []kubeapi.Event
}

func (*AggregateData) Merge

func (a *AggregateData) Merge(b *AggregateData)

type Container

type Container struct {
	Hostname   string
	ExternalID string
	Name       string
	// TODO(vishh): Consider defining an internal Spec and Stats API to guard against
	// changes to cadvisor API.
	Spec  cadvisor.ContainerSpec
	Stats []*cadvisor.ContainerStats
}

func NewContainer

func NewContainer() *Container

type ExternalNode

type ExternalNode struct {
	Name string `json:"name,omitempty"`
	IP   string `json:"ip,omitempty"`
}

An external node represents a host which is running cadvisor. Heapster will expect data in this format via its external files API.

type ExternalNodeList

type ExternalNodeList struct {
	Items []ExternalNode `json:"items,omitempty"`
}

ExternalNodeList represents a list of all hosts that are running cadvisor which heapster will monitor.

type Pod

type Pod struct {
	PodMetadata `json:",inline"`
	Containers  []Container `json:"containers"`
}

PodState is the state of a pod, used as either input (desired state) or output (current state)

type PodMetadata

type PodMetadata struct {
	Name         string `json:"name,omitempty"`
	Namespace    string `json:"namespace,omitempty"`
	NamespaceUID string
	// TODO(vishh): Rename to UID.
	ID             string
	Hostname       string
	Status         string
	PodIP          string
	Labels         map[string]string
	HostPublicIP   string
	HostInternalIP string
	ExternalID     string
}

type Source

type Source interface {
	// GetInfo Fetches information about pods or containers.
	// start, end: Represents the time range for stats
	// resolution: Represents the intervals at which samples are collected.
	// Returns:
	// AggregateData
	GetInfo(start, end time.Time, resolution time.Duration) (AggregateData, error)
	// Returns debug information for the source.
	DebugInfo() string
	// Returns a user friendly string that describes the source.
	Name() string
}

Source represents a plugin that generates data. Each Source needs to implement a Register