Skip to content

Initializing storage semantics project#3521

Draft
ramavadl wants to merge 3 commits into
open-telemetry:mainfrom
ramavadl:main
Draft

Initializing storage semantics project#3521
ramavadl wants to merge 3 commits into
open-telemetry:mainfrom
ramavadl:main

Conversation

@ramavadl

Copy link
Copy Markdown

Proposal for Storage Semantic Conventions Project

  • Created storage.md for new Storage Semantic Conventions project

  • Define Storage Semantic Conventions project proposal in storage.md

  • Defined scope to standardize observability for 14 storage entity types across block and file storage
  • Outlined deliverables including semantic conventions, resource attributes, and performance metrics
  • Detailed phased approach from foundation (Q2 2026) through integration and validation (Q1 2027)
  • Added staffing and help wanted section in storage.md
  • Identified need for storage engineers, observability experts, and vendor contributors
  • Specified roles for project leads, TC sponsors, and GC sponsors
  • Included statement about TC support for storage semantics effort
  • Provided comprehensive examples and use cases in storage.md
  • Storage entity types with key attributes
  • Metrics examples for IOPS, throughput, latency, and capacity
  • Resource attributes with example values
  • Seven practical use cases for storage observability
  • Added references section in storage.md
  • Linked to Storage Semantic Conventions PR
  • Referenced OpenTelemetry Metrics Semantic Conventions

@linux-foundation-easycla

linux-foundation-easycla Bot commented Jun 12, 2026

Copy link
Copy Markdown

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: ramavadl / name: Ramakrishna Vadla (4887bd5)
  • ✅ login: sanjlokh / name: Sanjay Lokhande (f3e3827)

Comment thread projects/storage.md
Comment on lines +9 to +28
### Goals

- Storage users can capture infrastructure metrics and attibutes from storage systems with OpenTelemetry and export these to the tools of their choice.
- Storage telemetry includes appropriate resource metadata that conforms to OpenTelemetry semantic conventions, enabling consistent observability across different storage technologies.
- Define semantic conventions for key storage entities including:
- Storage systems (hardware/software platforms providing data storage)
- Storage clusters (groups of nodes for high availability and scalability)
- Storage nodes (individual controllers or servers within storage systems)
- Storage pools (logical aggregation of storage resources)
- Storage arrays (disk drives with RAID or data protection)
- Storage drives (physical storage devices: HDD, SSD, NVMe)
- Storage enclosures (physical chassis housing drives)
- Storage volumes (logical storage units presented to hosts)
- Storage snapshots (point-in-time copies of volumes or file systems)
- Storage volume groups (collections of volumes managed together)
- Storage file systems (logical structures organizing files on storage)
- Storage hosts (servers configured to access storage resources)
- Storage FC ports (Fibre Channel interfaces for connectivity)
- Storage IP ports (network interfaces for IP-based protocols)
- Support both block storage and file storage observability use cases.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be great if we could encorporate the hw/system metrics & attributes which apply to storage systems.

@rrschulze

Copy link
Copy Markdown
Member

Regarding EasyCLA check, I will work with the author to solve this.

@ramavadl

Copy link
Copy Markdown
Author

I have completed EasyCLA compliance process. It should get fixed when the github pipeline runs

Comment thread projects/storage.md
To be determined

#### TC support
The TC is supportive of the storage semantics effort, focusing on:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please tell who from the TC is supportive?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants