graph

Documentation

Index

• type DrawMode
• type Graph
  • func New(title string, options ...Option) *Graph
• type LegendOption
• type NullValue
• type Option
  • func Alert(name string, opts ...alert.Option) Option
  • func DataSource(source string) Option
  • func Draw(modes ...DrawMode) Option
  • func Editable() Option
  • func Fill(value int) Option
  • func Height(height string) Option
  • func LeftYAxis(opts ...axis.Option) Option
  • func Legend(opts ...LegendOption) Option
  • func LineWidth(value uint) Option
  • func Null(mode NullValue) Option
  • func PointRadius(value int) Option
  • func ReadOnly() Option
  • func RightYAxis(opts ...axis.Option) Option
  • func Span(span float32) Option
  • func Staircase() Option
  • func WithPrometheusTarget(query string, options ...prometheus.Option) Option
  • func WithStackdriverTarget(target *stackdriver.Stackdriver) Option
  • func XAxis(opts ...axis.Option) Option

Types

type DrawMode

type DrawMode uint8

DrawMode represents a type of visualization that will be drawn in the graph (lines, bars, points)

const (
	// Bars will display bars.
	Bars DrawMode = iota
	// Lines will display lines.
	Lines
	// Points will display points.
	Points
)

type Graph

type Graph struct {
	Builder *sdk.Panel
}

Graph represents a graph panel.

func New

func New(title string, options ...Option) *Graph

New creates a new graph panel.

type LegendOption

type LegendOption uint16

LegendOption allows to configure a legend.

const (
	// Hide keeps the legend from being displayed.
	Hide LegendOption = iota
	// AsTable displays the legend as a table.
	AsTable
	// ToTheRight displays the legend on the right side of the graph.
	ToTheRight
	// Min displays the smallest value of the series.
	Min
	// Max displays the largest value of the series.
	Max
	// Avg displays the average of the series.
	Avg
	// Current displays the current value of the series.
	Current
	// Total displays the total value of the series.
	Total
	// NoNullSeries hides series with only null values from the legend.
	NoNullSeries
	// NoZeroSeries hides series with only 0 values from the legend.
	NoZeroSeries
)

type NullValue

type NullValue string

NullValue describes how null values are displayed.

const (
	// AsZero treats null values as zero values.
	AsZero NullValue = "null as zero"

	// AsNull treats null values as null.
	AsNull NullValue = "null"

	// Connected connects null values.
	Connected NullValue = "connected"
)

type Option

type Option func(graph *Graph)

Option represents an option that can be used to configure a graph panel.

func Alert

func Alert(name string, opts ...alert.Option) Option

Alert creates an alert for this graph.

func DataSource

func DataSource(source string) Option

DataSource sets the data source to be used by the graph.

func Draw

func Draw(modes ...DrawMode) Option

Draw specifies how the graph will be drawn.

func Editable

func Editable() Option

Editable marks the graph as editable.

func Fill

func Fill(value int) Option

Fill defines the amount of color fill for a series (default 1, max 10, 0 is none).

func Height

func Height(height string) Option

Height sets the height of the panel, in pixels. Example: "400px".

func LeftYAxis

func LeftYAxis(opts ...axis.Option) Option

LeftYAxis configures the left Y axis.

func Legend

func Legend(opts ...LegendOption) Option

Legend defines what should be shown in the legend.

func LineWidth

func LineWidth(value uint) Option

LineWidth defines the width of the line for a series (default 1, max 10, 0 is none).

func Null

func Null(mode NullValue) Option

Null configures how null values are displayed.

func PointRadius

func PointRadius(value int) Option

PointRadius adjusts the size of points when Points are selected as Draw Mode.

func ReadOnly

func ReadOnly() Option

ReadOnly marks the graph as non-editable.

func RightYAxis

func RightYAxis(opts ...axis.Option) Option

RightYAxis configures the right Y axis.

func Span

func Span(span float32) Option

Span sets the width of the panel, in grid units. Should be a positive number between 1 and 12. Example: 6.

func Staircase

func Staircase() Option

Staircase draws adjacent points as staircase.

func WithPrometheusTarget

func WithPrometheusTarget(query string, options ...prometheus.Option) Option

WithPrometheusTarget adds a prometheus query to the graph.

func WithStackdriverTarget

func WithStackdriverTarget(target *stackdriver.Stackdriver) Option

WithStackdriverTarget adds a stackdriver query to the graph.

func XAxis

func XAxis(opts ...axis.Option) Option

XAxis configures the X axis.