Add initial experimental .NET CLR runtime metrics (#1035)

Co-authored-by: Alexandra Konrad <[email protected]>
Co-authored-by: Noah Falk <[email protected]>
Co-authored-by: Liudmila Molkova <[email protected]>

Author: 4 people

.chloggen/clr-runtime.yaml

@@ -0,0 +1,22 @@
+# Use this changelog template to create an entry for release notes.
+#
+# If your change doesn't affect end users you should instead start
+# your pull request title with [chore] or use the "Skip Changelog" label.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: new_component
+
+# The name of the area of concern in the attributes-registry, (e.g. http, cloud, db)
+component: dotnet
+
+# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Adds experimental metrics for the .NET Common Language Runtime (CLR)."
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+# The values here must be integers.
+issues: [956]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext:

.github/CODEOWNERS

@@ -65,10 +65,13 @@
 /model/registry/oci.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-container-approvers
 
 # .NET semantic conventions approvers
-/model/metrics/dotnet/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver  @open-telemetry/semconv-http-approvers
-/model/registry/aspnetcore.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver  @open-telemetry/semconv-http-approvers
-/model/registry/signalr.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver  @open-telemetry/semconv-http-approvers
-/docs/dotnet/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver  @open-telemetry/semconv-http-approvers
+/model/metrics/dotnet/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver @open-telemetry/semconv-http-approvers
+/model/registry/aspnetcore.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver @open-telemetry/semconv-http-approvers
+/model/registry/signalr.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver @open-telemetry/semconv-http-approvers
+/docs/dotnet/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver @open-telemetry/semconv-http-approvers
+/model/metrics/dotnet-metrics.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver
+/model/registry/dotnet.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver
+/docs/runtime/dotnet-metrics.md @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver
 
 # Gen-AI semantic conventions approvers
 /model/registry/gen-ai.yaml @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-llm-approvers

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -39,6 +39,7 @@ body:
         - area:device
         - area:disk
         - area:dns
+        - area:dotnet
         - area:error
         - area:event
         - area:exception

.github/ISSUE_TEMPLATE/change_proposal.yaml

@@ -31,6 +31,7 @@ body:
         - area:device
         - area:disk
         - area:dns
+        - area:dotnet
         - area:error
         - area:event
         - area:exception

.github/ISSUE_TEMPLATE/new-conventions.yaml

@@ -40,6 +40,7 @@ body:
         - area:device
         - area:disk
         - area:dns
+        - area:dotnet
         - area:error
         - area:event
         - area:exception

docs/attributes-registry/README.md

@@ -50,6 +50,7 @@ Currently, the following namespaces exist:
 - [Device](device.md)
 - [Disk](disk.md)
 - [Dns](dns.md)
+- [Dotnet](dotnet.md)
 - [Enduser](enduser.md)
 - [Error](error.md)
 - [Event](event.md)

docs/attributes-registry/dotnet.md

@@ -0,0 +1,25 @@
+<!--- Hugo front matter used to generate the website version of this page:
+--->
+
+<!-- NOTE: THIS FILE IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
+<!-- see templates/registry/markdown/attribute_namespace.md.j2 -->
+
+# Dotnet
+
+## .NET Attributes
+
+This document defines .NET related attributes.
+
+| Attribute                   | Type   | Description                                            | Examples               | Stability                                                        |
+| --------------------------- | ------ | ------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------- |
+| `dotnet.gc.heap.generation` | string | Name of the garbage collector managed heap generation. | `gen0`; `gen1`; `gen2` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+
+`dotnet.gc.heap.generation` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value  | Description        | Stability                                                        |
+| ------ | ------------------ | ---------------------------------------------------------------- |
+| `gen0` | Generation 0       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `gen1` | Generation 1       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `gen2` | Generation 2       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `loh`  | Large Object Heap  | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `poh`  | Pinned Object Heap | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

docs/runtime/README.md

@@ -51,6 +51,7 @@ semantic conventions when instrumenting runtime environments.
 - [JVM](jvm-metrics.md)
 - [Node.js](nodejs-metrics.md)
 - [V8 JS Engine](v8js-metrics.md)
+- [.NET](dotnet-metrics.md)
 
 ### Attributes