Description

The OpenTelemetry Collector community would like to stabilize system semantic conventions including system metrics in order to help the adoption of the OTel hostmetricsreceiver.

Project Board

See: System Semantic Convention Working Group (view)

Roadmap

• Add system metrics reporting total memory capacity or clarify how to recover existing ones semantic-conventions#127
• (@ChrsMark) Define attributes to identify a CPU semantic-conventions#130
• (@mx-psi) Resource attributes for network addresses of a host semantic-conventions#131
• (@frzifus) Move metric definitions to YAML - System Metrics semantic-conventions#73
• (@dineshg13) Clarify semantics of system.cpu.time and system.cpu.utilization semantic-conventions#647
• The protocol attribute should be removed for system.network.connections metrics semantic-conventions#649
• (@braydonk) Add available memory state for hostmetrics receiver opentelemetry-collector-contrib#7417
• Document the difference between a host and a system metric semantic-conventions#226

done

• (@frzifus) add system.cpu.count metric semantic-conventions#98

Optional

• Add system uptime metric semantic-conventions#648
• Proposal to add system.memory.slab  semantic-conventions#531

Finally

• Stabilize existing semantic conventions (system metrics)

Deliverables

• Mark the system semantic conventions as stable.
• Update existing OpenTelemetry Collector hostmetricsreceiver to conform with the stable conventions.

Staffing / Help Wanted

The goal is to follow @tedsuo's proposed Semantic Convention Process.

• Stage 1: Working Group Preparation
• Stage 2: Stabilizing the Specification
• Stage 3: Implementation

Required staffing

• @mx-psi, @frzifus project leads
• @jsuereth technical committee sponsor
• domain experts:
  • @MovieStoreGuy
  • @dmitryax
  • @gbbr
  • @sallyom
  • @ChrsMark
  • @kaiyan-sheng
  • @braydonk
  • @bertysentry
  • @dineshg13

Meeting Times

July 10 - August 21 (6 weeks):

• Wednesday at 8:30-09:00 Pacific Time

cncf-slack #otel-system-metrics-wg
meeting-notes google-doc

Timeline

Stage 1 (Working Group Preparation) is happening now.

Stage 2 (Stabilizing the Specification) will begin as soon as we have adequate staffing for this project, and we coordinate a weekly meeting times (currently targeting mid-july).

Stage 3 (Implementation) will begin as soon as the system metrics are marked stable, and it should be relatively short we only need to update conformance to the specification for a single collector package.

Labels

The tracking issue should be properly labeled to indicate what parts of the specification it is focused on.

Linked Issues and PRs

All PRs, Issues, and OTEPs related to the project should link back to the tracking issue, so that they can be easily found.