cpustats

Documentation

Overview

Package cpustats handles JSON based processing of kernel activity, /proc/stat. The first Stats.CPU element aggregates the values for all other CPU elements. The values are aggregated since system boot. Instead of returning a Go struct, it returns JSON serialized bytes. A function to deserialize the JSON serialized bytes into a cpustats.CPUStats struct is provided.

Note: the package name is cpustats and not the final element of the import path (json).

Index

• func Deserialize(p []byte) (*stats.CPUStats, error)
• func Get() (p []byte, err error)
• func Marshal(st *stats.CPUStats) ([]byte, error)
• func NewTicker(d time.Duration) (joe.Tocker, error)
• func Serialize(st *stats.CPUStats) (p []byte, err error)
• func Unmarshal(p []byte) (*stats.CPUStats, error)
• type Profiler
  • func NewProfiler() (prof *Profiler, err error)
  • func (prof *Profiler) Get() (p []byte, err error)
  • func (prof *Profiler) Marshal(st *stats.CPUStats) ([]byte, error)
  • func (prof *Profiler) Serialize(st *stats.CPUStats) ([]byte, error)
• type Ticker
  • func (t *Ticker) Close()
  • func (t *Ticker) Run()

Functions

func Deserialize

func Deserialize(p []byte) (*stats.CPUStats, error)

Deserialize takes some JSON serialized bytes and unmarshals them as cpustats.Stats

func Get

func Get() (p []byte, err error)

Get returns information about current kernel activity as JSON serialized bytes using the package's global Profiler.

func Marshal

func Marshal(st *stats.CPUStats) ([]byte, error)

Marshal is an alias for Serialize using package globals.

func NewTicker

func NewTicker(d time.Duration) (joe.Tocker, error)

NewTicker returns a new Ticker containing a Data channel that delivers the data at intervals and an error channel that delivers any errors encountered. Stop the ticker to signal the ticker to stop running. Stopping the ticker does not close the Data channel; call Close to close both the ticker and the data channel.

func Serialize

func Serialize(st *stats.CPUStats) (p []byte, err error)

Serialize cpustats.CPUStats as JSON using package globals.

func Unmarshal

func Unmarshal(p []byte) (*stats.CPUStats, error)

Unmarshal is an alias for Deserialize

Types

type Profiler

type Profiler struct {
	*stats.Profiler
}

Profiler is used to process the /proc/stats file as JSON serialized bytes.

func NewProfiler

func NewProfiler() (prof *Profiler, err error)

Returns an initialized profiler that uses JSON.

func (*Profiler) Get

func (prof *Profiler) Get() (p []byte, err error)

Get returns information about current kernel activity as JSON serialized bytes.

func (*Profiler) Marshal

func (prof *Profiler) Marshal(st *stats.CPUStats) ([]byte, error)

Marshal is an alias for Serialize.

func (*Profiler) Serialize

func (prof *Profiler) Serialize(st *stats.CPUStats) ([]byte, error)

Serialize cpustats.CPUStats as JSON.

type Ticker

type Ticker struct {
	*joe.Ticker
	Data chan []byte
	*Profiler
}

Ticker delivers the system's kernel activity at intervals.

func (*Ticker) Close

func (t *Ticker) Close()

Close closes the ticker resources.

func (*Ticker) Run

func (t *Ticker) Run()

Run runs the ticker.