a0a419614f
/storage returns {device, mountpoint, capacity, usage} for all filesystems.
In addition, it also detect and applies label for each filesystem - currently two - "root", "docker-images".
/storage/<label> returns info about the filesystem with specific label. eg. /storage/root returns info for root filesystem.
117 lines
3.4 KiB
Go
117 lines
3.4 KiB
Go
// Copyright 2015 Google Inc. All Rights Reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package v2
|
|
|
|
import (
|
|
"time"
|
|
)
|
|
|
|
type CpuSpec struct {
|
|
// Requested cpu shares. Default is 1024.
|
|
Limit uint64 `json:"limit"`
|
|
// Requested cpu hard limit. Default is unlimited (0).
|
|
// Units: milli-cpus.
|
|
MaxLimit uint64 `json:"max_limit"`
|
|
// Cpu affinity mask.
|
|
// TODO(rjnagal): Add a library to convert mask string to set of cpu bitmask.
|
|
Mask string `json:"mask,omitempty"`
|
|
}
|
|
|
|
type MemorySpec struct {
|
|
// The amount of memory requested. Default is unlimited (-1).
|
|
// Units: bytes.
|
|
Limit uint64 `json:"limit,omitempty"`
|
|
|
|
// The amount of guaranteed memory. Default is 0.
|
|
// Units: bytes.
|
|
Reservation uint64 `json:"reservation,omitempty"`
|
|
|
|
// The amount of swap space requested. Default is unlimited (-1).
|
|
// Units: bytes.
|
|
SwapLimit uint64 `json:"swap_limit,omitempty"`
|
|
}
|
|
|
|
type ContainerSpec struct {
|
|
// Time at which the container was created.
|
|
CreationTime time.Time `json:"creation_time,omitempty"`
|
|
|
|
HasCpu bool `json:"has_cpu"`
|
|
Cpu CpuSpec `json:"cpu,omitempty"`
|
|
|
|
HasMemory bool `json:"has_memory"`
|
|
Memory MemorySpec `json:"memory,omitempty"`
|
|
}
|
|
|
|
type Percentiles struct {
|
|
// Indicates whether the stats are present or not.
|
|
// If true, values below do not have any data.
|
|
Present bool `json:"present"`
|
|
// Average over the collected sample.
|
|
Mean uint64 `json:"mean"`
|
|
// Max seen over the collected sample.
|
|
Max uint64 `json:"max"`
|
|
// 90th percentile over the collected sample.
|
|
Ninety uint64 `json:"ninety"`
|
|
}
|
|
|
|
type Usage struct {
|
|
// Indicates amount of data available [0-100].
|
|
// If we have data for half a day, we'll still process DayUsage,
|
|
// but set PercentComplete to 50.
|
|
PercentComplete int32 `json:"percent_complete"`
|
|
// Mean, Max, and 90p cpu rate value in milliCpus/seconds. Converted to milliCpus to avoid floats.
|
|
Cpu Percentiles `json:"cpu"`
|
|
// Mean, Max, and 90p memory size in bytes.
|
|
Memory Percentiles `json:"memory"`
|
|
}
|
|
|
|
// latest sample collected for a container.
|
|
type InstantUsage struct {
|
|
// cpu rate in cpu milliseconds/second.
|
|
Cpu uint64 `json:"cpu"`
|
|
// Memory usage in bytes.
|
|
Memory uint64 `json:"memory"`
|
|
}
|
|
|
|
type DerivedStats struct {
|
|
// Time of generation of these stats.
|
|
Timestamp time.Time `json:"timestamp"`
|
|
// Latest instantaneous sample.
|
|
LatestUsage InstantUsage `json:"latest_usage"`
|
|
// Percentiles in last observed minute.
|
|
MinuteUsage Usage `json:"minute_usage"`
|
|
// Percentile in last hour.
|
|
HourUsage Usage `json:"hour_usage"`
|
|
// Percentile in last day.
|
|
DayUsage Usage `json:"day_usage"`
|
|
}
|
|
|
|
type FsInfo struct {
|
|
// The block device name associated with the filesystem.
|
|
Device string `json:"device"`
|
|
|
|
// Path where the filesystem is mounted.
|
|
Mountpoint string `json:"mountpoint"`
|
|
|
|
// Filesystem usage in bytes.
|
|
Capacity uint64 `json:"capacity"`
|
|
|
|
// Number of bytes used on this filesystem.
|
|
Usage uint64 `json:"usage"`
|
|
|
|
// Labels associated with this filesystem.
|
|
Labels []string `json:"labels"`
|
|
}
|