Remove experimental attribute from TagNameAttribute (#6200)

* remove experimental from TagNameAttribute

Author: dariusclay

src/Libraries/Microsoft.Extensions.Telemetry.Abstractions/Logging/TagNameAttribute.cs

@@ -3,19 +3,28 @@
 
 using System;
 using System.Diagnostics;
-using System.Diagnostics.CodeAnalysis;
-using Microsoft.Shared.DiagnosticIds;
 using Microsoft.Shared.Diagnostics;
 
 namespace Microsoft.Extensions.Logging;
 
 /// <summary>
 /// Defines the tag name to use for a logged parameter or property.
 /// </summary>
+/// <remarks>
+/// By default, the tag name is the same as the respective parameter or property.
+/// You can use this attribute to override the default and provide a custom tag name.
+/// </remarks>
+/// <example>
+/// <code language="csharp">
+/// [LoggerMessage(1, LogLevel.Information, "My custom tag name: {my.custom.tagname}")]
+/// public static partial void LogMyCustomTagName(
+///     this ILogger logger,
+///     [TagName("my.custom.tagname")] string name);
+/// </code>
+/// </example>
 /// <seealso cref="LoggerMessageAttribute"/>
 [AttributeUsage(AttributeTargets.Parameter | AttributeTargets.Property)]
 [Conditional("CODE_GENERATION_ATTRIBUTES")]
-[Experimental(diagnosticId: DiagnosticIds.Experiments.Telemetry, UrlFormat = DiagnosticIds.UrlFormat)]
 public sealed class TagNameAttribute : Attribute
 {
     /// <summary>

src/Libraries/Microsoft.Extensions.Telemetry.Abstractions/Microsoft.Extensions.Telemetry.Abstractions.json

@@ -764,6 +764,22 @@
         }
       ]
     },
+    {
+      "Type": "sealed class Microsoft.Extensions.Logging.TagNameAttribute : System.Attribute",
+      "Stage": "Stable",
+      "Methods": [
+        {
+          "Member": "Microsoft.Extensions.Logging.TagNameAttribute.TagNameAttribute(string name);",
+          "Stage": "Stable"
+        }
+      ],
+      "Properties": [
+        {
+          "Member": "string Microsoft.Extensions.Logging.TagNameAttribute.Name { get; }",
+          "Stage": "Stable"
+        }
+      ]
+    },
     {
       "Type": "sealed class Microsoft.Extensions.Diagnostics.Metrics.TagNameAttribute : System.Attribute",
       "Stage": "Stable",

src/Libraries/Microsoft.Extensions.Telemetry.Abstractions/README.md

@@ -43,6 +43,15 @@ internal static partial void LogNewTemperature(ILogger<Program> logger, [LogProp
 internal record Temperature(double value, TemperatureUnit unit);
 ```
 
+The `TagName` attribute can be used to specify a custom tag name for each parameter or property. This is useful when you want to have more control over the naming of tags in your logs.
+
+```csharp
+[LoggerMessage(1, LogLevel.Information, "My custom tag name: {my.custom.tagname}")]
+public static partial void LogMyCustomTagName(
+    this ILogger logger,
+    [TagName("my.custom.tagname")] string name);
+```
+
 ### Log Enrichment
 
 Logging data can be enriched by adding custom log enrichers to the service collection. This can be done using specific implementations or generic types.