Merge pull request #13311 from Mikejo5000/mikejo-br24

Add content for .NET Meters histogram tool

Author: Jill Grant

docs/profiling/dotnet-counters-tool.md

@@ -1,7 +1,7 @@
 ---
 title: "Visualize dotnet counters"
 description: Use the .NET Counters tool in the Visual Studio Performance Profiler to visualize dotnet counters over time and better understand your data.
-ms.date: "12/7/2020"
+ms.date: "11/05/2024"
 ms.topic: "conceptual"
 helpviewer_keywords:
   - "dotnet, counters, profiling"
@@ -61,6 +61,30 @@ You can also view graphs in the detailed report by selecting the checkboxes next
 
 The table updates to relevant values for the time selected in the graphs. Use the **Clear Selection** button to reset the selected time range to the entire trace.
 
+::: moniker range=">=vs-2022"
+## View .NET Meter counter data
+
+Starting in Visual Studio 2022 version 17.8, .NET Counters tool supports integration with the .NET <xref:System.Diagnostics.Metrics.Meter> API, adding support for instrument options such as `Counter` and `ObservableCounter`.
+
+The `Counter` keeps track of a value changing over time, with the caller reporting updates using `Counter.Add`. In contrast, `ObservableCounter` is similar to `Counter`, but the caller takes care of keeping track of the total value. The .NET Counters tool reports the rate of change in the total.
+
+For more information, see [Creating Metrics](/dotnet/core/diagnostics/metrics-instrumentation).
+
+## View .NET Meter histogram data
+
+Starting in Visual Studio 2022 version 17.12 Preview 2, .NET Counters tool supports .NET <xref:System.Diagnostics.Metrics.Meter> Histogram integration.
+
+The .NET Meter Histogram allows you to identify and analyze histogram data generated by .NET histogram instruments, recorded using `CreateHistogram`. When recording data using the histogram instrument, results are visualized, providing a clear representation of data distribution.
+
+Live histogram data is shown with the rest of the counters, under the name of the Meter instance.
+
+To open the histogram graph, select the instrument name for the Meter instance, as shown here.
+
+:::image type="content" source="../profiling/media/vs-2022/dotnet-counters-meter-histogram.gif" alt-text=".NET Counters meter histogram data.":::
+
+In the preceding example, the tool shows data for the 50th, 90th, and 95th percentiles of the recorded measurements.
+::: moniker-end
+
 ## Related content
 
 - [Optimizing Profiler settings](../profiling/optimize-profiler-settings.md)