package containerconv

import "go.opentelemetry.io/otel/semconv/v1.32.0/containerconv"

Package httpconv provides types and functionality for OpenTelemetry semantic conventions in the "container" namespace.

Index

Types

type CPUModeAttr 

type CPUModeAttr string

CPUModeAttr is an attribute conforming to the cpu.mode semantic conventions. It represents the CPU mode for this data point. A container's CPU metric SHOULD be characterized *either* by data points with no `mode` labels, *or only* data points with `mode` labels. 

var (
	// CPUModeUser is the none.
	CPUModeUser CPUModeAttr = "user"
	// CPUModeSystem is the none.
	CPUModeSystem CPUModeAttr = "system"
	// CPUModeNice is the none.
	CPUModeNice CPUModeAttr = "nice"
	// CPUModeIdle is the none.
	CPUModeIdle CPUModeAttr = "idle"
	// CPUModeIOWait is the none.
	CPUModeIOWait CPUModeAttr = "iowait"
	// CPUModeInterrupt is the none.
	CPUModeInterrupt CPUModeAttr = "interrupt"
	// CPUModeSteal is the none.
	CPUModeSteal CPUModeAttr = "steal"
	// CPUModeKernel is the none.
	CPUModeKernel CPUModeAttr = "kernel"
)

type CPUTime 

type CPUTime struct {
	metric.Float64Counter
}

CPUTime is an instrument used to record metric values conforming to the "container.cpu.time" semantic conventions. It represents the total CPU time consumed.

func NewCPUTime 

func NewCPUTime(
	m metric.Meter,
	opt ...metric.Float64CounterOption,
) (CPUTime, error)

NewCPUTime returns a new CPUTime instrument.

func (CPUTime) Add 

func (m CPUTime) Add(
	ctx context.Context,
	incr float64,
	attrs ...attribute.KeyValue,
)

Add adds incr to the existing count.

All additional attrs passed are included in the recorded value.

Total CPU time consumed by the specific container on all available CPU cores

func (CPUTime) AttrCPUMode 

func (CPUTime) AttrCPUMode(val CPUModeAttr) attribute.KeyValue

AttrCPUMode returns an optional attribute for the "cpu.mode" semantic convention. It represents the CPU mode for this data point. A container's CPU metric SHOULD be characterized *either* by data points with no `mode` labels, *or only* data points with `mode` labels.

func (CPUTime) Description 

func (CPUTime) Description() string

Description returns the semantic convention description of the instrument

func (CPUTime) Inst 

func (m CPUTime) Inst() metric.Float64Counter

Inst returns the underlying metric instrument.

func (CPUTime) Name 

func (CPUTime) Name() string

Name returns the semantic convention name of the instrument.

func (CPUTime) Unit 

func (CPUTime) Unit() string

Unit returns the semantic convention unit of the instrument

type CPUUsage 

type CPUUsage struct {
	metric.Int64Gauge
}

CPUUsage is an instrument used to record metric values conforming to the "container.cpu.usage" semantic conventions. It represents the container's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.

func NewCPUUsage 

func NewCPUUsage(
	m metric.Meter,
	opt ...metric.Int64GaugeOption,
) (CPUUsage, error)

NewCPUUsage returns a new CPUUsage instrument.

func (CPUUsage) AttrCPUMode 

func (CPUUsage) AttrCPUMode(val CPUModeAttr) attribute.KeyValue

AttrCPUMode returns an optional attribute for the "cpu.mode" semantic convention. It represents the CPU mode for this data point. A container's CPU metric SHOULD be characterized *either* by data points with no `mode` labels, *or only* data points with `mode` labels.

func (CPUUsage) Description 

func (CPUUsage) Description() string

Description returns the semantic convention description of the instrument

func (CPUUsage) Inst 

func (m CPUUsage) Inst() metric.Int64Gauge

Inst returns the underlying metric instrument.

func (CPUUsage) Name 

func (CPUUsage) Name() string

Name returns the semantic convention name of the instrument.

func (CPUUsage) Record 

func (m CPUUsage) Record(
	ctx context.Context,
	val int64,
	attrs ...attribute.KeyValue,
)

Record records val to the current distribution.

All additional attrs passed are included in the recorded value.

CPU usage of the specific container on all available CPU cores, averaged over the sample window

func (CPUUsage) Unit 

func (CPUUsage) Unit() string

Unit returns the semantic convention unit of the instrument

type DiskIO 

type DiskIO struct {
	metric.Int64Counter
}

DiskIO is an instrument used to record metric values conforming to the "container.disk.io" semantic conventions. It represents the disk bytes for the container.

func NewDiskIO 

func NewDiskIO(
	m metric.Meter,
	opt ...metric.Int64CounterOption,
) (DiskIO, error)

NewDiskIO returns a new DiskIO instrument.

func (DiskIO) Add 

func (m DiskIO) Add(
	ctx context.Context,
	incr int64,
	attrs ...attribute.KeyValue,
)

Add adds incr to the existing count.

All additional attrs passed are included in the recorded value.

The total number of bytes read/written successfully (aggregated from all disks).

func (DiskIO) AttrDiskIODirection 

func (DiskIO) AttrDiskIODirection(val DiskIODirectionAttr) attribute.KeyValue

AttrDiskIODirection returns an optional attribute for the "disk.io.direction" semantic convention. It represents the disk IO operation direction.

func (DiskIO) AttrSystemDevice 

func (DiskIO) AttrSystemDevice(val string) attribute.KeyValue

AttrSystemDevice returns an optional attribute for the "system.device" semantic convention. It represents the device identifier.

func (DiskIO) Description 

func (DiskIO) Description() string

Description returns the semantic convention description of the instrument

func (DiskIO) Inst 

func (m DiskIO) Inst() metric.Int64Counter

Inst returns the underlying metric instrument.

func (DiskIO) Name 

func (DiskIO) Name() string

Name returns the semantic convention name of the instrument.

func (DiskIO) Unit 

func (DiskIO) Unit() string

Unit returns the semantic convention unit of the instrument

type DiskIODirectionAttr 

type DiskIODirectionAttr string

DiskIODirectionAttr is an attribute conforming to the disk.io.direction semantic conventions. It represents the disk IO operation direction. 

var (
	// DiskIODirectionRead is the none.
	DiskIODirectionRead DiskIODirectionAttr = "read"
	// DiskIODirectionWrite is the none.
	DiskIODirectionWrite DiskIODirectionAttr = "write"
)

type MemoryUsage 

type MemoryUsage struct {
	metric.Int64Counter
}

MemoryUsage is an instrument used to record metric values conforming to the "container.memory.usage" semantic conventions. It represents the memory usage of the container.

func NewMemoryUsage 

func NewMemoryUsage(
	m metric.Meter,
	opt ...metric.Int64CounterOption,
) (MemoryUsage, error)

NewMemoryUsage returns a new MemoryUsage instrument.

func (MemoryUsage) Add 

func (m MemoryUsage) Add(ctx context.Context, incr int64, attrs ...attribute.KeyValue)

Add adds incr to the existing count.

Memory usage of the container.

func (MemoryUsage) Description 

func (MemoryUsage) Description() string

Description returns the semantic convention description of the instrument

func (MemoryUsage) Inst 

func (m MemoryUsage) Inst() metric.Int64Counter

Inst returns the underlying metric instrument.

func (MemoryUsage) Name 

func (MemoryUsage) Name() string

Name returns the semantic convention name of the instrument.

func (MemoryUsage) Unit 

func (MemoryUsage) Unit() string

Unit returns the semantic convention unit of the instrument

type NetworkIO 

type NetworkIO struct {
	metric.Int64Counter
}

NetworkIO is an instrument used to record metric values conforming to the "container.network.io" semantic conventions. It represents the network bytes for the container.

func NewNetworkIO 

func NewNetworkIO(
	m metric.Meter,
	opt ...metric.Int64CounterOption,
) (NetworkIO, error)

NewNetworkIO returns a new NetworkIO instrument.

func (NetworkIO) Add 

func (m NetworkIO) Add(
	ctx context.Context,
	incr int64,
	attrs ...attribute.KeyValue,
)

Add adds incr to the existing count.

All additional attrs passed are included in the recorded value.

The number of bytes sent/received on all network interfaces by the container.

func (NetworkIO) AttrNetworkIODirection 

func (NetworkIO) AttrNetworkIODirection(val NetworkIODirectionAttr) attribute.KeyValue

AttrNetworkIODirection returns an optional attribute for the "network.io.direction" semantic convention. It represents the network IO operation direction.

func (NetworkIO) AttrNetworkInterfaceName 

func (NetworkIO) AttrNetworkInterfaceName(val string) attribute.KeyValue

AttrNetworkInterfaceName returns an optional attribute for the "network.interface.name" semantic convention. It represents the network interface name.

func (NetworkIO) Description 

func (NetworkIO) Description() string

Description returns the semantic convention description of the instrument

func (NetworkIO) Inst 

func (m NetworkIO) Inst() metric.Int64Counter

Inst returns the underlying metric instrument.

func (NetworkIO) Name 

func (NetworkIO) Name() string

Name returns the semantic convention name of the instrument.

func (NetworkIO) Unit 

func (NetworkIO) Unit() string

Unit returns the semantic convention unit of the instrument

type NetworkIODirectionAttr 

type NetworkIODirectionAttr string

NetworkIODirectionAttr is an attribute conforming to the network.io.direction semantic conventions. It represents the network IO operation direction. 

var (
	// NetworkIODirectionTransmit is the none.
	NetworkIODirectionTransmit NetworkIODirectionAttr = "transmit"
	// NetworkIODirectionReceive is the none.
	NetworkIODirectionReceive NetworkIODirectionAttr = "receive"
)

type Uptime 

type Uptime struct {
	metric.Float64Gauge
}

Uptime is an instrument used to record metric values conforming to the "container.uptime" semantic conventions. It represents the time the container has been running.

func NewUptime 

func NewUptime(
	m metric.Meter,
	opt ...metric.Float64GaugeOption,
) (Uptime, error)

NewUptime returns a new Uptime instrument.

func (Uptime) Description 

func (Uptime) Description() string

Description returns the semantic convention description of the instrument

func (Uptime) Inst 

func (m Uptime) Inst() metric.Float64Gauge

Inst returns the underlying metric instrument.

func (Uptime) Name 

func (Uptime) Name() string

Name returns the semantic convention name of the instrument.

func (Uptime) Record 

func (m Uptime) Record(ctx context.Context, val float64, attrs ...attribute.KeyValue)

Record records val to the current distribution.

Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available. The actual accuracy would depend on the instrumentation and operating system.

func (Uptime) Unit 

func (Uptime) Unit() string

Unit returns the semantic convention unit of the instrument

Source Files

metric.go

Version
v1.36.0 (latest)
Published
May 21, 2025
Platform
js/wasm
Imports
5 packages
Last checked
2 hours ago –

Tools for package owners.