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)