Merge branch 'main' into api-iopentelemetrybuilder

Author: alanwest

.github/workflows/Component.BuildTest.yml

@@ -68,13 +68,15 @@ jobs:
       run: dotnet-coverage merge -r -f cobertura -o ./TestResults/Cobertura.xml ./TestResults/*.coverage
 
     - name: Upload code coverage ${{ inputs.code-cov-prefix }}-${{ inputs.code-cov-name }}
-      uses: codecov/codecov-action@v3.1.5
+      uses: codecov/codecov-action@v4
       continue-on-error: true # Note: Don't fail for upload failures
       env:
         OS: ${{ matrix.os }}
         TFM: ${{ matrix.version }}
+        token: ${{ secrets.CODECOV_TOKEN }}
       with:
         file: TestResults/Cobertura.xml
         env_vars: OS,TFM
         flags: ${{ inputs.code-cov-prefix }}-${{ inputs.code-cov-name }}
         name: Code Coverage for ${{ inputs.code-cov-prefix }}-${{ inputs.code-cov-name }} on [${{ matrix.os }}.${{ matrix.version }}]
+        codecov_yml_path: .github/codecov.yml

.github/workflows/codeql-analysis.yml

@@ -25,7 +25,7 @@ jobs:
 
     steps:
     - name: configure Pagefile
-      uses: al-cheb/configure-pagefile-action@v1.3
+      uses: al-cheb/configure-pagefile-action@v1.4
       with:
         minimum-size: 8GB
         maximum-size: 32GB

.github/workflows/markdownlint.yml

@@ -14,7 +14,7 @@ jobs:
       uses: actions/checkout@v4
 
     - name: run markdownlint
-      uses: DavidAnson/markdownlint-cli2-action@v14.0.0
+      uses: DavidAnson/markdownlint-cli2-action@v15.0.0
       with:
         globs: |
           **/*.md

OpenTelemetry.sln

@@ -329,6 +329,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "experimental-apis", "experi
 		docs\diagnostics\experimental-apis\OTEL1000.md = docs\diagnostics\experimental-apis\OTEL1000.md
 		docs\diagnostics\experimental-apis\OTEL1001.md = docs\diagnostics\experimental-apis\OTEL1001.md
 		docs\diagnostics\experimental-apis\OTEL1002.md = docs\diagnostics\experimental-apis\OTEL1002.md
+		docs\diagnostics\experimental-apis\OTEL1003.md = docs\diagnostics\experimental-apis\OTEL1003.md
 		docs\diagnostics\experimental-apis\README.md = docs\diagnostics\experimental-apis\README.md
 	EndProjectSection
 EndProject

README.md

@@ -33,9 +33,11 @@ If you are new here, please read the getting started docs:
 * [Logs](./docs/logs/README.md): [ASP.NET
   Core](./docs/logs/getting-started-aspnetcore/README.md) |
   [Console](./docs/logs/getting-started-console/README.md)
-* Metrics: [ASP.NET Core](./docs/metrics/getting-started-aspnetcore/README.md) |
+* [Metrics](./docs/metrics/README.md): [ASP.NET
+  Core](./docs/metrics/getting-started-aspnetcore/README.md) |
   [Console](./docs/metrics/getting-started-console/README.md)
-* Traces: [ASP.NET Core](./docs/trace/getting-started-aspnetcore/README.md) |
+* [Traces](./docs/trace/README.md): [ASP.NET
+  Core](./docs/trace/getting-started-aspnetcore/README.md) |
   [Console](./docs/trace/getting-started-console/README.md)
 
 This repository includes multiple installable components, available on

build/Common.props

@@ -10,7 +10,7 @@
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <!-- Suppress warnings for repo code using experimental features -->
-    <NoWarn>$(NoWarn);OTEL1000;OTEL1001;OTEL1002</NoWarn>
+    <NoWarn>$(NoWarn);OTEL1000;OTEL1001;OTEL1002;OTEL1003</NoWarn>
     <!--temporarily disable. See 3958-->
     <!--<AnalysisLevel>latest-All</AnalysisLevel>-->
   </PropertyGroup>

docs/diagnostics/experimental-apis/OTEL1003.md

@@ -0,0 +1,29 @@
+# OpenTelemetry .NET Diagnostic: OTEL1003
+
+## Overview
+
+This is an Experimental API diagnostic covering the following API:
+
+* `MetricStreamConfiguration.CardinalityLimit.get`
+* `MetricStreamConfiguration.CardinalityLimit.set`
+
+Experimental APIs may be changed or removed in the future.
+
+## Details
+
+The OpenTelemetry Specification defines the
+[cardinality limit](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/sdk.md#cardinality-limits)
+of a metric can be set by the matching view.
+
+From the specification:
+
+> The cardinality limit for an aggregation is defined in one of three ways:
+> A view with criteria matching the instrument an aggregation is created for has
+> an aggregation_cardinality_limit value defined for the stream, that value
+> SHOULD be used. If there is no matching view, but the MetricReader defines a
+> default cardinality limit value based on the instrument an aggregation is
+> created for, that value SHOULD be used. If none of the previous values are
+> defined, the default value of 2000 SHOULD be used.
+
+We are exposing these APIs experimentally until the specification declares them
+stable.

docs/diagnostics/experimental-apis/README.md

@@ -33,6 +33,12 @@ Description: Metrics Exemplar Support
 
 Details: [OTEL1002](./OTEL1002.md)
 
+### OTEL1003
+
+Description: MetricStreamConfiguration CardinalityLimit Support
+
+Details: [OTEL1003](./OTEL1003.md)
+
 ## Inactive
 
 Experimental APIs which have been released stable or removed:

docs/logs/README.md

@@ -1,5 +1,21 @@
 # OpenTelemetry .NET Logs
 
+<!-- markdownlint-disable MD033 -->
+<details>
+<summary>Table of Contents</summary>
+
+* [Best Practices](#best-practices)
+* [Package Version](#package-version)
+* [Logging API](#logging-api)
+* [Logger Management](#logger-management)
+* [Log Correlation](#log-correlation)
+* [Log Enrichment](#log-enrichment)
+* [Log Filtering](#log-filtering)
+* [Log Redaction](#log-redaction)
+
+</details>
+<!-- markdownlint-enable MD033 -->
+
 ## Best Practices
 
 The following tutorials have demonstrated the best practices for logging with