containerconv

package
v1.38.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 29, 2025 License: Apache-2.0, BSD-3-Clause Imports: 5 Imported by: 0

Documentation

Overview

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

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

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 standardized value "user" of CPUModeAttr.
	CPUModeUser CPUModeAttr = "user"
	// CPUModeSystem is the standardized value "system" of CPUModeAttr.
	CPUModeSystem CPUModeAttr = "system"
	// CPUModeNice is the standardized value "nice" of CPUModeAttr.
	CPUModeNice CPUModeAttr = "nice"
	// CPUModeIdle is the standardized value "idle" of CPUModeAttr.
	CPUModeIdle CPUModeAttr = "idle"
	// CPUModeIOWait is the standardized value "iowait" of CPUModeAttr.
	CPUModeIOWait CPUModeAttr = "iowait"
	// CPUModeInterrupt is the standardized value "interrupt" of CPUModeAttr.
	CPUModeInterrupt CPUModeAttr = "interrupt"
	// CPUModeSteal is the standardized value "steal" of CPUModeAttr.
	CPUModeSteal CPUModeAttr = "steal"
	// CPUModeKernel is the standardized value "kernel" of CPUModeAttr.
	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 for attrs.

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) AddSet 

func (m CPUTime) AddSet(ctx context.Context, incr float64, set attribute.Set)

AddSet adds incr to the existing count for set.

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 for attrs.

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) RecordSet 

func (m CPUUsage) RecordSet(ctx context.Context, val int64, set attribute.Set)

RecordSet records val to the current distribution for set.

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 for attrs.

All additional attrs passed are included in the recorded value.

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

func (DiskIO) AddSet 

func (m DiskIO) AddSet(ctx context.Context, incr int64, set attribute.Set)

AddSet adds incr to the existing count for set.

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 standardized value "read" of DiskIODirectionAttr.
	DiskIODirectionRead DiskIODirectionAttr = "read"
	// DiskIODirectionWrite is the standardized value "write" of
	// DiskIODirectionAttr.
	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 for attrs.

Memory usage of the container.

func (MemoryUsage) AddSet 

func (m MemoryUsage) AddSet(ctx context.Context, incr int64, set attribute.Set)

AddSet adds incr to the existing count for set.

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 for attrs.

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) AddSet 

func (m NetworkIO) AddSet(ctx context.Context, incr int64, set attribute.Set)

AddSet adds incr to the existing count for set.

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 standardized value "transmit" of
	// NetworkIODirectionAttr.
	NetworkIODirectionTransmit NetworkIODirectionAttr = "transmit"
	// NetworkIODirectionReceive is the standardized value "receive" of
	// NetworkIODirectionAttr.
	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 for attrs.

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) RecordSet 

func (m Uptime) RecordSet(ctx context.Context, val float64, set attribute.Set)

RecordSet records val to the current distribution for set.

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

View all Source files
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.