Documentation
¶
Index ¶
- type AllocBroadcaster
- type AllocFileInfo
- type AllocListener
- type AllocResourceUsage
- type AllocStatsRequest
- type AllocStatsResponse
- type ClientStatsResponse
- type CpuStats
- type DriverNetwork
- type FSIsolation
- type FingerprintRequest
- type FingerprintResponse
- func (f *FingerprintResponse) AddAttribute(name, value string)
- func (f *FingerprintResponse) AddLink(name, value string)
- func (x *FingerprintResponse) CodecDecodeSelf(d *codec1978.Decoder)
- func (x *FingerprintResponse) CodecEncodeSelf(e *codec1978.Encoder)
- func (f *FingerprintResponse) RemoveAttribute(name string)
- func (f *FingerprintResponse) RemoveLink(name string)
- type FsListRequest
- type FsListResponse
- type FsLogsRequest
- type FsStatRequest
- type FsStatResponse
- type FsStreamRequest
- type HealthCheckIntervalRequest
- type HealthCheckIntervalResponse
- type HealthCheckRequest
- type HealthCheckResponse
- type MemoryStats
- type ResourceUsage
- type RpcError
- type StreamErrWrapper
- type TaskResourceUsage
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AllocBroadcaster ¶ added in v0.6.0
type AllocBroadcaster struct {
// contains filtered or unexported fields
}
AllocBroadcaster implements an allocation broadcast channel. The zero value is a usable unbuffered channel.
func NewAllocBroadcaster ¶ added in v0.6.0
func NewAllocBroadcaster(n int) *AllocBroadcaster
NewAllocBroadcaster returns a new AllocBroadcaster with the given capacity (0 means unbuffered).
func (*AllocBroadcaster) Close ¶ added in v0.6.0
func (b *AllocBroadcaster) Close()
Close closes the channel, disabling the sending of further messages.
func (*AllocBroadcaster) Listen ¶ added in v0.6.0
func (b *AllocBroadcaster) Listen() *AllocListener
Listen returns a Listener for the broadcast channel.
func (*AllocBroadcaster) Send ¶ added in v0.6.0
func (b *AllocBroadcaster) Send(v *structs.Allocation) bool
Send broadcasts a message to the channel. Send returns whether the message was sent to all channels.
type AllocFileInfo ¶ added in v0.8.0
AllocFileInfo holds information about a file inside the AllocDir
func (*AllocFileInfo) CodecDecodeSelf ¶ added in v0.8.0
func (x *AllocFileInfo) CodecDecodeSelf(d *codec1978.Decoder)
func (*AllocFileInfo) CodecEncodeSelf ¶ added in v0.8.0
func (x *AllocFileInfo) CodecEncodeSelf(e *codec1978.Encoder)
type AllocListener ¶ added in v0.6.0
type AllocListener struct {
// Ch receives the broadcast messages.
Ch <-chan *structs.Allocation
// contains filtered or unexported fields
}
AllocListener implements a listening endpoint for an allocation broadcast channel.
func (*AllocListener) Close ¶ added in v0.6.0
func (l *AllocListener) Close()
Close closes the Listener, disabling the receival of further messages.
type AllocResourceUsage ¶
type AllocResourceUsage struct {
// ResourceUsage is the summation of the task resources
ResourceUsage *ResourceUsage
// Tasks contains the resource usage of each task
Tasks map[string]*TaskResourceUsage
// The max timestamp of all the Tasks
Timestamp int64
}
AllocResourceUsage holds the aggregated task resource usage of the allocation.
func (*AllocResourceUsage) CodecDecodeSelf ¶ added in v0.8.0
func (x *AllocResourceUsage) CodecDecodeSelf(d *codec1978.Decoder)
func (*AllocResourceUsage) CodecEncodeSelf ¶ added in v0.8.0
func (x *AllocResourceUsage) CodecEncodeSelf(e *codec1978.Encoder)
type AllocStatsRequest ¶ added in v0.8.0
type AllocStatsRequest struct {
// AllocID is the allocation to retrieves stats for
AllocID string
// Task is an optional filter to only request stats for the task.
Task string
structs.QueryOptions
}
AllocStatsRequest is used to request the resource usage of a given allocation, potentially filtering by task
func (*AllocStatsRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *AllocStatsRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*AllocStatsRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *AllocStatsRequest) CodecEncodeSelf(e *codec1978.Encoder)
type AllocStatsResponse ¶ added in v0.8.0
type AllocStatsResponse struct {
Stats *AllocResourceUsage
structs.QueryMeta
}
AllocStatsResponse is used to return the resource usage of a given allocation.
func (*AllocStatsResponse) CodecDecodeSelf ¶ added in v0.8.0
func (x *AllocStatsResponse) CodecDecodeSelf(d *codec1978.Decoder)
func (*AllocStatsResponse) CodecEncodeSelf ¶ added in v0.8.0
func (x *AllocStatsResponse) CodecEncodeSelf(e *codec1978.Encoder)
type ClientStatsResponse ¶ added in v0.8.0
ClientStatsResponse is used to return statistics about a node.
func (*ClientStatsResponse) CodecDecodeSelf ¶ added in v0.8.0
func (x *ClientStatsResponse) CodecDecodeSelf(d *codec1978.Decoder)
func (*ClientStatsResponse) CodecEncodeSelf ¶ added in v0.8.0
func (x *ClientStatsResponse) CodecEncodeSelf(e *codec1978.Encoder)
type CpuStats ¶
type CpuStats struct {
SystemMode float64
UserMode float64
TotalTicks float64
ThrottledPeriods uint64
ThrottledTime uint64
Percent float64
// A list of fields whose values were actually sampled
Measured []string
}
CpuStats holds cpu usage related stats
func (*CpuStats) CodecDecodeSelf ¶ added in v0.8.0
func (*CpuStats) CodecEncodeSelf ¶ added in v0.8.0
type DriverNetwork ¶ added in v0.6.0
type DriverNetwork struct {
// PortMap can be set by drivers to replace ports in environment
// variables with driver-specific mappings.
PortMap map[string]int
// IP is the IP address for the task created by the driver.
IP string
// AutoAdvertise indicates whether the driver thinks services that
// choose to auto-advertise-addresses should use this IP instead of the
// host's. eg If a Docker network plugin is used
AutoAdvertise bool
}
DriverNetwork is the network created by driver's (eg Docker's bridge network) during Prestart.
func (*DriverNetwork) Advertise ¶ added in v0.6.0
func (d *DriverNetwork) Advertise() bool
Advertise returns true if the driver suggests using the IP set. May be called on a nil Network in which case it returns false.
func (*DriverNetwork) CodecDecodeSelf ¶ added in v0.8.0
func (x *DriverNetwork) CodecDecodeSelf(d *codec1978.Decoder)
func (*DriverNetwork) CodecEncodeSelf ¶ added in v0.8.0
func (x *DriverNetwork) CodecEncodeSelf(e *codec1978.Encoder)
func (*DriverNetwork) Copy ¶ added in v0.6.0
func (d *DriverNetwork) Copy() *DriverNetwork
Copy a DriverNetwork struct. If it is nil, nil is returned.
func (*DriverNetwork) Hash ¶ added in v0.6.0
func (d *DriverNetwork) Hash() []byte
Hash the contents of a DriverNetwork struct to detect changes. If it is nil, an empty slice is returned.
type FSIsolation ¶ added in v0.5.3
type FSIsolation int
FSIsolation is an enumeration to describe what kind of filesystem isolation a driver supports.
const ( // FSIsolationNone means no isolation. The host filesystem is used. FSIsolationNone FSIsolation = 0 // FSIsolationChroot means the driver will use a chroot on the host // filesystem. FSIsolationChroot FSIsolation = 1 // FSIsolationImage means the driver uses an image. FSIsolationImage FSIsolation = 2 )
func (*FSIsolation) CodecDecodeSelf ¶ added in v0.8.0
func (x *FSIsolation) CodecDecodeSelf(d *codec1978.Decoder)
func (FSIsolation) CodecEncodeSelf ¶ added in v0.8.0
func (x FSIsolation) CodecEncodeSelf(e *codec1978.Encoder)
func (FSIsolation) String ¶ added in v0.5.3
func (f FSIsolation) String() string
type FingerprintRequest ¶ added in v0.8.0
FingerprintRequest is a request which a fingerprinter accepts to fingerprint the node
func (*FingerprintRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *FingerprintRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*FingerprintRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *FingerprintRequest) CodecEncodeSelf(e *codec1978.Encoder)
type FingerprintResponse ¶ added in v0.8.0
type FingerprintResponse struct {
Attributes map[string]string
Links map[string]string
Resources *structs.Resources
// Detected is a boolean indicating whether the fingerprinter detected
// if the resource was available
Detected bool
}
FingerprintResponse is the response which a fingerprinter annotates with the results of the fingerprint method
func (*FingerprintResponse) AddAttribute ¶ added in v0.8.0
func (f *FingerprintResponse) AddAttribute(name, value string)
AddAttribute adds the name and value for a node attribute to the fingerprint response
func (*FingerprintResponse) AddLink ¶ added in v0.8.0
func (f *FingerprintResponse) AddLink(name, value string)
AddLink adds a link entry to the fingerprint response
func (*FingerprintResponse) CodecDecodeSelf ¶ added in v0.8.0
func (x *FingerprintResponse) CodecDecodeSelf(d *codec1978.Decoder)
func (*FingerprintResponse) CodecEncodeSelf ¶ added in v0.8.0
func (x *FingerprintResponse) CodecEncodeSelf(e *codec1978.Encoder)
func (*FingerprintResponse) RemoveAttribute ¶ added in v0.8.0
func (f *FingerprintResponse) RemoveAttribute(name string)
RemoveAttribute sets the given attribute to empty, which will later remove it entirely from the node
func (*FingerprintResponse) RemoveLink ¶ added in v0.8.0
func (f *FingerprintResponse) RemoveLink(name string)
RemoveLink removes a link entry from the fingerprint response. This will later remove it entirely from the node
type FsListRequest ¶ added in v0.8.0
type FsListRequest struct {
// AllocID is the allocation to list from
AllocID string
// Path is the path to list
Path string
structs.QueryOptions
}
FsListRequest is used to list an allocation's directory.
func (*FsListRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *FsListRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*FsListRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *FsListRequest) CodecEncodeSelf(e *codec1978.Encoder)
type FsListResponse ¶ added in v0.8.0
type FsListResponse struct {
// Files are the result of listing a directory.
Files []*AllocFileInfo
structs.QueryMeta
}
FsListResponse is used to return the listings of an allocation's directory.
func (*FsListResponse) CodecDecodeSelf ¶ added in v0.8.0
func (x *FsListResponse) CodecDecodeSelf(d *codec1978.Decoder)
func (*FsListResponse) CodecEncodeSelf ¶ added in v0.8.0
func (x *FsListResponse) CodecEncodeSelf(e *codec1978.Encoder)
type FsLogsRequest ¶ added in v0.8.0
type FsLogsRequest struct {
// AllocID is the allocation to stream logs from
AllocID string
// Task is the task to stream logs from
Task string
// LogType indicates whether "stderr" or "stdout" should be streamed
LogType string
// Offset is the offset to start streaming data at.
Offset int64
// Origin can either be "start" or "end" and determines where the offset is
// applied.
Origin string
// PlainText disables base64 encoding.
PlainText bool
// Follow follows logs.
Follow bool
structs.QueryOptions
}
FsLogsRequest is the initial request for accessing allocation logs.
func (*FsLogsRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *FsLogsRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*FsLogsRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *FsLogsRequest) CodecEncodeSelf(e *codec1978.Encoder)
type FsStatRequest ¶ added in v0.8.0
type FsStatRequest struct {
// AllocID is the allocation to stat the file in
AllocID string
// Path is the path to list
Path string
structs.QueryOptions
}
FsStatRequest is used to stat a file
func (*FsStatRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *FsStatRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*FsStatRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *FsStatRequest) CodecEncodeSelf(e *codec1978.Encoder)
type FsStatResponse ¶ added in v0.8.0
type FsStatResponse struct {
// Info is the result of stating a file
Info *AllocFileInfo
structs.QueryMeta
}
FsStatResponse is used to return the stat results of a file
func (*FsStatResponse) CodecDecodeSelf ¶ added in v0.8.0
func (x *FsStatResponse) CodecDecodeSelf(d *codec1978.Decoder)
func (*FsStatResponse) CodecEncodeSelf ¶ added in v0.8.0
func (x *FsStatResponse) CodecEncodeSelf(e *codec1978.Encoder)
type FsStreamRequest ¶ added in v0.8.0
type FsStreamRequest struct {
// AllocID is the allocation to stream logs from
AllocID string
// Path is the path to the file to stream
Path string
// Offset is the offset to start streaming data at.
Offset int64
// Origin can either be "start" or "end" and determines where the offset is
// applied.
Origin string
// PlainText disables base64 encoding.
PlainText bool
// Limit is the number of bytes to read
Limit int64
// Follow follows the file.
Follow bool
structs.QueryOptions
}
FsStreamRequest is the initial request for streaming the content of a file.
func (*FsStreamRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *FsStreamRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*FsStreamRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *FsStreamRequest) CodecEncodeSelf(e *codec1978.Encoder)
type HealthCheckIntervalRequest ¶ added in v0.8.0
type HealthCheckIntervalRequest struct{}
func (*HealthCheckIntervalRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *HealthCheckIntervalRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*HealthCheckIntervalRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *HealthCheckIntervalRequest) CodecEncodeSelf(e *codec1978.Encoder)
type HealthCheckIntervalResponse ¶ added in v0.8.0
func (*HealthCheckIntervalResponse) CodecDecodeSelf ¶ added in v0.8.0
func (x *HealthCheckIntervalResponse) CodecDecodeSelf(d *codec1978.Decoder)
func (*HealthCheckIntervalResponse) CodecEncodeSelf ¶ added in v0.8.0
func (x *HealthCheckIntervalResponse) CodecEncodeSelf(e *codec1978.Encoder)
type HealthCheckRequest ¶ added in v0.8.0
type HealthCheckRequest struct{}
HealthCheckRequest is the request type for a type that fulfils the Health Check interface
func (*HealthCheckRequest) CodecDecodeSelf ¶ added in v0.8.0
func (x *HealthCheckRequest) CodecDecodeSelf(d *codec1978.Decoder)
func (*HealthCheckRequest) CodecEncodeSelf ¶ added in v0.8.0
func (x *HealthCheckRequest) CodecEncodeSelf(e *codec1978.Encoder)
type HealthCheckResponse ¶ added in v0.8.0
type HealthCheckResponse struct {
// Drivers is a map of driver names to current driver information
Drivers map[string]*structs.DriverInfo
}
HealthCheckResponse is the response type for a type that fulfills the Health Check interface
func (*HealthCheckResponse) AddDriverInfo ¶ added in v0.8.0
func (h *HealthCheckResponse) AddDriverInfo(name string, driverInfo *structs.DriverInfo)
AddDriverInfo adds information about a driver to the fingerprint response. If the Drivers field has not yet been initialized, it does so here.
func (*HealthCheckResponse) CodecDecodeSelf ¶ added in v0.8.0
func (x *HealthCheckResponse) CodecDecodeSelf(d *codec1978.Decoder)
func (*HealthCheckResponse) CodecEncodeSelf ¶ added in v0.8.0
func (x *HealthCheckResponse) CodecEncodeSelf(e *codec1978.Encoder)
type MemoryStats ¶
type MemoryStats struct {
RSS uint64
Cache uint64
Swap uint64
MaxUsage uint64
KernelUsage uint64
KernelMaxUsage uint64
// A list of fields whose values were actually sampled
Measured []string
}
MemoryStats holds memory usage related stats
func (*MemoryStats) Add ¶
func (ms *MemoryStats) Add(other *MemoryStats)
func (*MemoryStats) CodecDecodeSelf ¶ added in v0.8.0
func (x *MemoryStats) CodecDecodeSelf(d *codec1978.Decoder)
func (*MemoryStats) CodecEncodeSelf ¶ added in v0.8.0
func (x *MemoryStats) CodecEncodeSelf(e *codec1978.Encoder)
type ResourceUsage ¶
type ResourceUsage struct {
MemoryStats *MemoryStats
CpuStats *CpuStats
}
ResourceUsage holds information related to cpu and memory stats
func (*ResourceUsage) Add ¶
func (ru *ResourceUsage) Add(other *ResourceUsage)
func (*ResourceUsage) CodecDecodeSelf ¶ added in v0.8.0
func (x *ResourceUsage) CodecDecodeSelf(d *codec1978.Decoder)
func (*ResourceUsage) CodecEncodeSelf ¶ added in v0.8.0
func (x *ResourceUsage) CodecEncodeSelf(e *codec1978.Encoder)
type RpcError ¶ added in v0.8.0
RpcError is used for serializing errors with a potential error code
func NewRpcError ¶ added in v0.8.0
func (*RpcError) CodecDecodeSelf ¶ added in v0.8.0
func (*RpcError) CodecEncodeSelf ¶ added in v0.8.0
type StreamErrWrapper ¶ added in v0.8.0
type StreamErrWrapper struct {
// Error stores any error that may have occurred.
Error *RpcError
// Payload is the payload
Payload []byte
}
StreamErrWrapper is used to serialize output of a stream of a file or logs.
func (*StreamErrWrapper) CodecDecodeSelf ¶ added in v0.8.0
func (x *StreamErrWrapper) CodecDecodeSelf(d *codec1978.Decoder)
func (*StreamErrWrapper) CodecEncodeSelf ¶ added in v0.8.0
func (x *StreamErrWrapper) CodecEncodeSelf(e *codec1978.Encoder)
type TaskResourceUsage ¶
type TaskResourceUsage struct {
ResourceUsage *ResourceUsage
Timestamp int64
Pids map[string]*ResourceUsage
}
TaskResourceUsage holds aggregated resource usage of all processes in a Task and the resource usage of the individual pids
func (*TaskResourceUsage) CodecDecodeSelf ¶ added in v0.8.0
func (x *TaskResourceUsage) CodecDecodeSelf(d *codec1978.Decoder)
func (*TaskResourceUsage) CodecEncodeSelf ¶ added in v0.8.0
func (x *TaskResourceUsage) CodecEncodeSelf(e *codec1978.Encoder)