stats
packageThis package is not in the latest version of its module.
Details
Validgo.mod file
The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license
Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version
Modules with tagged versions give importers more predictable builds.
Stable version
When a project reaches major version v1 it is considered stable.
- Learn more about best practices
Repository
Links
Documentation¶
Overview¶
Get cluster statistics.Get basic index metrics (shard numbers, store size, memory usage) andinformation about the current nodes that form the cluster (number, roles, os,jvm versions, memory usage, cpu and installed plugins).
Index¶
- Variables
- type NewStats
- type Response
- type Stats
- func (r Stats) Do(providedCtx context.Context) (*Response, error)
- func (r *Stats) ErrorTrace(errortrace bool) *Stats
- func (r *Stats) FilterPath(filterpaths ...string) *Stats
- func (r *Stats) Header(key, value string) *Stats
- func (r *Stats) HttpRequest(ctx context.Context) (*http.Request, error)
- func (r *Stats) Human(human bool) *Stats
- func (r *Stats) IncludeRemotes(includeremotes bool) *Stats
- func (r Stats) IsSuccess(providedCtx context.Context) (bool, error)
- func (r *Stats) NodeId(nodeid string) *Stats
- func (r Stats) Perform(providedCtx context.Context) (*http.Response, error)
- func (r *Stats) Pretty(pretty bool) *Stats
- func (r *Stats) Timeout(duration string) *Stats
Constants¶
This section is empty.
Variables¶
var ErrBuildPath =errors.New("cannot build path, check for missing path parameters")ErrBuildPath is returned in case of missing parameters within the build of the request.
Functions¶
This section is empty.
Types¶
typeNewStats¶
type NewStats func() *Stats
NewStats type alias for index.
funcNewStatsFunc¶
func NewStatsFunc(tpelastictransport.Interface)NewStats
NewStatsFunc returns a new instance of Stats with the provided transport.Used in the index of the library this allows to retrieve every apis in once place.
typeResponse¶added inv8.7.0
type Response struct {// Ccs Cross-cluster statsCcstypes.CCSStats `json:"ccs"`// ClusterName Name of the cluster, based on the cluster name setting.ClusterNamestring `json:"cluster_name"`// ClusterUuid Unique identifier for the cluster.ClusterUuidstring `json:"cluster_uuid"`// Indices Contains statistics about indices with shards assigned to selected nodes.Indicestypes.ClusterIndices `json:"indices"`// NodeStats Contains statistics about the number of nodes selected by the request’s node// filters.NodeStats *types.NodeStatistics `json:"_nodes,omitempty"`// Nodes Contains statistics about nodes selected by the request’s node filters.Nodestypes.ClusterNodes `json:"nodes"`// Repositories Contains stats on repository feature usage exposed in cluster stats for// telemetry.Repositories map[string]map[string]int64 `json:"repositories"`// Snapshots Contains stats cluster snapshots.Snapshotstypes.ClusterSnapshotStats `json:"snapshots"`// Status Health status of the cluster, based on the state of its primary and replica// shards.Status *healthstatus.HealthStatus `json:"status,omitempty"`// Timestamp Unix timestamp, in milliseconds, for the last time the cluster statistics// were refreshed.Timestampint64 `json:"timestamp"`}Response holds the response body struct for the package stats
typeStats¶
type Stats struct {// contains filtered or unexported fields}funcNew¶
func New(tpelastictransport.Interface) *Stats
Get cluster statistics.Get basic index metrics (shard numbers, store size, memory usage) andinformation about the current nodes that form the cluster (number, roles, os,jvm versions, memory usage, cpu and installed plugins).
https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-stats.html
func (Stats)Do¶
Do runs the request through the transport, handle the response and returns a stats.Response
func (*Stats)ErrorTrace¶added inv8.14.0
ErrorTrace When set to `true` Elasticsearch will include the full stack trace of errorswhen they occur.API name: error_trace
func (*Stats)FilterPath¶added inv8.14.0
FilterPath Comma-separated list of filters in dot notation which reduce the responsereturned by Elasticsearch.API name: filter_path
func (*Stats)HttpRequest¶
HttpRequest returns the http.Request object built from thegiven parameters.
func (*Stats)Human¶added inv8.14.0
Human When set to `true` will return statistics in a format suitable for humans.For example `"exists_time": "1h"` for humans and`"eixsts_time_in_millis": 3600000` for computers. When disabled the humanreadable values will be omitted. This makes sense for responses beingconsumedonly by machines.API name: human
func (*Stats)IncludeRemotes¶added inv8.16.0
IncludeRemotes Include remote cluster data into the responseAPI name: include_remotes
func (Stats)IsSuccess¶
IsSuccess allows to run a query with a context and retrieve the result as a boolean.This only exists for endpoints without a request payload and allows for quick control flow.
func (*Stats)NodeId¶
NodeId Comma-separated list of node filters used to limit returned information.Defaults to all nodes in the cluster.API Name: nodeid
func (Stats)Perform¶added inv8.7.0
Perform runs the http.Request through the provided transport and returns an http.Response.
func (*Stats)Pretty¶added inv8.14.0
Pretty If set to `true` the returned JSON will be "pretty-formatted". Only usethis option for debugging only.API name: pretty