api

Documentation

Index

• type AggregateData
  • func (a *AggregateData) Merge(b *AggregateData)
• type Container
  • func NewContainer() *Container
• type ContainerSpec
• type ContainerStats
• 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
	Image      string
	Spec       ContainerSpec
	Stats      []*ContainerStats
}

func NewContainer

func NewContainer() *Container

type ContainerSpec

type ContainerSpec struct {
	// TODO(piosz): Consider defining an internal Spec API to guard against changes to cadvisor API.
	cadvisor.ContainerSpec
	CpuRequest    int64
	MemoryRequest int64
}

type ContainerStats

type ContainerStats struct {
	// TODO(piosz): Consider defining an internal Stats API (see above).
	cadvisor.ContainerStats
}

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
	// Returns:
	// AggregateData
	GetInfo(start, end time.Time) (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