2017-02-15 19:45:45 +01:00
|
|
|
/*
|
2019-04-09 20:39:42 +02:00
|
|
|
* MinIO Cloud Storage, (C) 2017 MinIO, Inc.
|
2017-02-15 19:45:45 +01:00
|
|
|
*
|
|
|
|
* 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 madmin
|
|
|
|
|
|
|
|
import (
|
2020-03-20 23:00:44 +01:00
|
|
|
"context"
|
2017-02-15 19:45:45 +01:00
|
|
|
"encoding/json"
|
|
|
|
"io/ioutil"
|
|
|
|
"net/http"
|
2019-12-12 15:02:37 +01:00
|
|
|
"time"
|
2019-08-31 04:57:53 +02:00
|
|
|
)
|
|
|
|
|
2017-02-15 19:45:45 +01:00
|
|
|
// BackendType - represents different backend types.
|
|
|
|
type BackendType int
|
|
|
|
|
|
|
|
// Enum for different backend types.
|
|
|
|
const (
|
|
|
|
Unknown BackendType = iota
|
|
|
|
// Filesystem backend.
|
|
|
|
FS
|
|
|
|
// Multi disk Erasure (single, distributed) backend.
|
|
|
|
Erasure
|
|
|
|
|
|
|
|
// Add your own backend.
|
|
|
|
)
|
|
|
|
|
2018-02-16 02:45:57 +01:00
|
|
|
// DriveInfo - represents each drive info, describing
|
|
|
|
// status, uuid and endpoint.
|
|
|
|
type DriveInfo HealDriveInfo
|
|
|
|
|
2017-02-15 19:45:45 +01:00
|
|
|
// StorageInfo - represents total capacity of underlying storage.
|
|
|
|
type StorageInfo struct {
|
2019-10-23 06:01:14 +02:00
|
|
|
Used []uint64 // Used total used per disk.
|
2018-05-23 12:11:29 +02:00
|
|
|
|
2019-10-23 06:01:14 +02:00
|
|
|
Total []uint64 // Total disk space per disk.
|
2019-04-05 06:21:50 +02:00
|
|
|
|
2019-10-23 06:01:14 +02:00
|
|
|
Available []uint64 // Total disk space available per disk.
|
|
|
|
|
|
|
|
MountPaths []string // Disk mountpoints
|
2019-04-05 06:21:50 +02:00
|
|
|
|
2017-02-15 19:45:45 +01:00
|
|
|
// Backend type.
|
|
|
|
Backend struct {
|
|
|
|
// Represents various backend types, currently on FS and Erasure.
|
|
|
|
Type BackendType
|
|
|
|
|
|
|
|
// Following fields are only meaningful if BackendType is Erasure.
|
2019-10-23 06:01:14 +02:00
|
|
|
OnlineDisks BackendDisks // Online disks during server startup.
|
|
|
|
OfflineDisks BackendDisks // Offline disks during server startup.
|
|
|
|
StandardSCData int // Data disks for currently configured Standard storage class.
|
|
|
|
StandardSCParity int // Parity disks for currently configured Standard storage class.
|
|
|
|
RRSCData int // Data disks for currently configured Reduced Redundancy storage class.
|
|
|
|
RRSCParity int // Parity disks for currently configured Reduced Redundancy storage class.
|
2018-02-16 02:45:57 +01:00
|
|
|
|
|
|
|
// List of all disk status, this is only meaningful if BackendType is Erasure.
|
|
|
|
Sets [][]DriveInfo
|
2017-02-15 19:45:45 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-10-23 06:01:14 +02:00
|
|
|
// BackendDisks - represents the map of endpoint-disks.
|
|
|
|
type BackendDisks map[string]int
|
|
|
|
|
|
|
|
// Sum - Return the sum of the disks in the endpoint-disk map.
|
|
|
|
func (d1 BackendDisks) Sum() (sum int) {
|
|
|
|
for _, count := range d1 {
|
|
|
|
sum += count
|
|
|
|
}
|
|
|
|
return sum
|
|
|
|
}
|
|
|
|
|
|
|
|
// Merge - Reduces two endpoint-disk maps.
|
|
|
|
func (d1 BackendDisks) Merge(d2 BackendDisks) BackendDisks {
|
2019-11-14 19:17:41 +01:00
|
|
|
if len(d2) == 0 {
|
|
|
|
d2 = make(BackendDisks)
|
|
|
|
}
|
2019-10-23 06:01:14 +02:00
|
|
|
for i1, v1 := range d1 {
|
|
|
|
if v2, ok := d2[i1]; ok {
|
|
|
|
d2[i1] = v2 + v1
|
|
|
|
continue
|
|
|
|
}
|
|
|
|
d2[i1] = v1
|
|
|
|
}
|
|
|
|
return d2
|
|
|
|
}
|
|
|
|
|
|
|
|
// StorageInfo - Connect to a minio server and call Storage Info Management API
|
|
|
|
// to fetch server's information represented by StorageInfo structure
|
2020-03-20 23:00:44 +01:00
|
|
|
func (adm *AdminClient) StorageInfo(ctx context.Context) (StorageInfo, error) {
|
|
|
|
resp, err := adm.executeMethod(ctx, http.MethodGet, requestData{relPath: adminAPIPrefix + "/storageinfo"})
|
2019-10-23 06:01:14 +02:00
|
|
|
defer closeResponse(resp)
|
|
|
|
if err != nil {
|
|
|
|
return StorageInfo{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check response http status code
|
|
|
|
if resp.StatusCode != http.StatusOK {
|
|
|
|
return StorageInfo{}, httpRespToErrorResponse(resp)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Unmarshal the server's json response
|
|
|
|
var storageInfo StorageInfo
|
|
|
|
|
|
|
|
respBytes, err := ioutil.ReadAll(resp.Body)
|
|
|
|
if err != nil {
|
|
|
|
return StorageInfo{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
err = json.Unmarshal(respBytes, &storageInfo)
|
|
|
|
if err != nil {
|
|
|
|
return StorageInfo{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return storageInfo, nil
|
|
|
|
}
|
|
|
|
|
2019-12-12 15:02:37 +01:00
|
|
|
// DataUsageInfo represents data usage of an Object API
|
|
|
|
type DataUsageInfo struct {
|
2020-03-19 00:19:29 +01:00
|
|
|
// LastUpdate is the timestamp of when the data usage info was last updated.
|
|
|
|
// This does not indicate a full scan.
|
|
|
|
LastUpdate time.Time `json:"lastUpdate"`
|
|
|
|
ObjectsCount uint64 `json:"objectsCount"`
|
|
|
|
ObjectsTotalSize uint64 `json:"objectsTotalSize"`
|
|
|
|
|
|
|
|
// ObjectsSizesHistogram contains information on objects across all buckets.
|
|
|
|
// See ObjectsHistogramIntervals.
|
2019-12-12 15:02:37 +01:00
|
|
|
ObjectsSizesHistogram map[string]uint64 `json:"objectsSizesHistogram"`
|
|
|
|
|
2020-03-19 00:19:29 +01:00
|
|
|
BucketsCount uint64 `json:"bucketsCount"`
|
|
|
|
|
|
|
|
// BucketsSizes is "bucket name" -> size.
|
2019-12-12 15:02:37 +01:00
|
|
|
BucketsSizes map[string]uint64 `json:"bucketsSizes"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// DataUsageInfo - returns data usage of the current object API
|
2020-03-20 23:00:44 +01:00
|
|
|
func (adm *AdminClient) DataUsageInfo(ctx context.Context) (DataUsageInfo, error) {
|
|
|
|
resp, err := adm.executeMethod(ctx, http.MethodGet, requestData{relPath: adminAPIPrefix + "/datausageinfo"})
|
2019-12-12 15:02:37 +01:00
|
|
|
defer closeResponse(resp)
|
|
|
|
if err != nil {
|
|
|
|
return DataUsageInfo{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check response http status code
|
|
|
|
if resp.StatusCode != http.StatusOK {
|
|
|
|
return DataUsageInfo{}, httpRespToErrorResponse(resp)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Unmarshal the server's json response
|
|
|
|
var dataUsageInfo DataUsageInfo
|
|
|
|
|
|
|
|
respBytes, err := ioutil.ReadAll(resp.Body)
|
|
|
|
if err != nil {
|
|
|
|
return DataUsageInfo{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
err = json.Unmarshal(respBytes, &dataUsageInfo)
|
|
|
|
if err != nil {
|
|
|
|
return DataUsageInfo{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return dataUsageInfo, nil
|
2019-08-31 04:57:53 +02:00
|
|
|
}
|
2019-12-11 23:27:03 +01:00
|
|
|
|
|
|
|
// InfoMessage container to hold server admin related information.
|
|
|
|
type InfoMessage struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
Mode string `json:"mode,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
Domain []string `json:"domain,omitempty"`
|
|
|
|
Region string `json:"region,omitempty"`
|
|
|
|
SQSARN []string `json:"sqsARN,omitempty"`
|
2019-12-12 06:56:47 +01:00
|
|
|
DeploymentID string `json:"deploymentID,omitempty"`
|
|
|
|
Buckets Buckets `json:"buckets,omitempty"`
|
|
|
|
Objects Objects `json:"objects,omitempty"`
|
|
|
|
Usage Usage `json:"usage,omitempty"`
|
|
|
|
Services Services `json:"services,omitempty"`
|
|
|
|
Backend interface{} `json:"backend,omitempty"`
|
|
|
|
Servers []ServerProperties `json:"servers,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Services contains different services information
|
|
|
|
type Services struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
Vault Vault `json:"vault,omitempty"`
|
|
|
|
LDAP LDAP `json:"ldap,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
Logger []Logger `json:"logger,omitempty"`
|
|
|
|
Audit []Audit `json:"audit,omitempty"`
|
2019-12-12 06:56:47 +01:00
|
|
|
Notifications []map[string][]TargetIDStatus `json:"notifications,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Buckets contains the number of buckets
|
|
|
|
type Buckets struct {
|
2019-12-12 18:58:33 +01:00
|
|
|
Count uint64 `json:"count,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Objects contains the number of objects
|
|
|
|
type Objects struct {
|
2019-12-12 18:58:33 +01:00
|
|
|
Count uint64 `json:"count,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Usage contains the tottal size used
|
|
|
|
type Usage struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
Size uint64 `json:"size,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Vault - Fetches the Vault status
|
|
|
|
type Vault struct {
|
|
|
|
Status string `json:"status,omitempty"`
|
|
|
|
Encrypt string `json:"encryp,omitempty"`
|
|
|
|
Decrypt string `json:"decrypt,omitempty"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// LDAP contains ldap status
|
|
|
|
type LDAP struct {
|
|
|
|
Status string `json:"status,omitempty"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// Status of endpoint
|
|
|
|
type Status struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
Status string `json:"status,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Audit contains audit logger status
|
|
|
|
type Audit map[string]Status
|
|
|
|
|
|
|
|
// Logger contains logger status
|
|
|
|
type Logger map[string]Status
|
|
|
|
|
|
|
|
// TargetIDStatus containsid and status
|
|
|
|
type TargetIDStatus map[string]Status
|
|
|
|
|
|
|
|
// backendType - indicates the type of backend storage
|
|
|
|
type backendType string
|
|
|
|
|
|
|
|
const (
|
|
|
|
// FsType - Backend is FS Type
|
|
|
|
FsType = backendType("FS")
|
|
|
|
// ErasureType - Backend is Erasure type
|
|
|
|
ErasureType = backendType("Erasure")
|
|
|
|
)
|
|
|
|
|
2020-03-20 23:00:44 +01:00
|
|
|
// FSBackend contains specific FS storage information
|
|
|
|
type FSBackend struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
Type backendType `json:"backendType,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
2020-06-13 05:04:01 +02:00
|
|
|
// ErasureBackend contains specific erasure storage information
|
|
|
|
type ErasureBackend struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
Type backendType `json:"backendType,omitempty"`
|
|
|
|
OnlineDisks int `json:"onlineDisks,omitempty"`
|
|
|
|
OfflineDisks int `json:"offlineDisks,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
// Data disks for currently configured Standard storage class.
|
2019-12-12 06:56:47 +01:00
|
|
|
StandardSCData int `json:"standardSCData,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
// Parity disks for currently configured Standard storage class.
|
2019-12-12 06:56:47 +01:00
|
|
|
StandardSCParity int `json:"standardSCParity,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
// Data disks for currently configured Reduced Redundancy storage class.
|
2019-12-12 06:56:47 +01:00
|
|
|
RRSCData int `json:"rrSCData,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
// Parity disks for currently configured Reduced Redundancy storage class.
|
2019-12-12 06:56:47 +01:00
|
|
|
RRSCParity int `json:"rrSCParity,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// ServerProperties holds server information
|
|
|
|
type ServerProperties struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
State string `json:"state,omitempty"`
|
|
|
|
Endpoint string `json:"endpoint,omitempty"`
|
|
|
|
Uptime int64 `json:"uptime,omitempty"`
|
|
|
|
Version string `json:"version,omitempty"`
|
|
|
|
CommitID string `json:"commitID,omitempty"`
|
|
|
|
Network map[string]string `json:"network,omitempty"`
|
|
|
|
Disks []Disk `json:"disks,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Disk holds Disk information
|
|
|
|
type Disk struct {
|
2019-12-12 06:56:47 +01:00
|
|
|
DrivePath string `json:"path,omitempty"`
|
|
|
|
State string `json:"state,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
UUID string `json:"uuid,omitempty"`
|
|
|
|
Model string `json:"model,omitempty"`
|
2019-12-12 06:56:47 +01:00
|
|
|
TotalSpace uint64 `json:"totalspace,omitempty"`
|
|
|
|
UsedSpace uint64 `json:"usedspace,omitempty"`
|
2019-12-11 23:27:03 +01:00
|
|
|
ReadThroughput float64 `json:"readthroughput,omitempty"`
|
|
|
|
WriteThroughPut float64 `json:"writethroughput,omitempty"`
|
|
|
|
ReadLatency float64 `json:"readlatency,omitempty"`
|
|
|
|
WriteLatency float64 `json:"writelatency,omitempty"`
|
|
|
|
Utilization float64 `json:"utilization,omitempty"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// ServerInfo - Connect to a minio server and call Server Admin Info Management API
|
|
|
|
// to fetch server's information represented by infoMessage structure
|
2020-03-20 23:00:44 +01:00
|
|
|
func (adm *AdminClient) ServerInfo(ctx context.Context) (InfoMessage, error) {
|
|
|
|
resp, err := adm.executeMethod(ctx,
|
|
|
|
http.MethodGet,
|
|
|
|
requestData{relPath: adminAPIPrefix + "/info"},
|
|
|
|
)
|
2019-12-11 23:27:03 +01:00
|
|
|
defer closeResponse(resp)
|
|
|
|
if err != nil {
|
|
|
|
return InfoMessage{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check response http status code
|
|
|
|
if resp.StatusCode != http.StatusOK {
|
|
|
|
return InfoMessage{}, httpRespToErrorResponse(resp)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Unmarshal the server's json response
|
|
|
|
var message InfoMessage
|
|
|
|
|
|
|
|
respBytes, err := ioutil.ReadAll(resp.Body)
|
|
|
|
if err != nil {
|
|
|
|
return InfoMessage{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
err = json.Unmarshal(respBytes, &message)
|
|
|
|
if err != nil {
|
|
|
|
return InfoMessage{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return message, nil
|
|
|
|
}
|