.NET 10 metrics /1

Author: Rick-Anderson

aspnetcore/log-mon/metrics/built-in/includes/built-in10.md

@@ -403,8 +403,7 @@ As this metric is tracking the connection duration, and ideally SignalR connecti
 
 The `Microsoft.AspNetCore.Authorization` metrics report information about [Authorization attempts](xref:security/authorization/introduction) in ASP.NET Core apps:
 
-<!--- section links here -->
-##### Metric: `aspnetcore.authorization.attempts`
+#### Metric: `aspnetcore.authorization.attempts`
 
 | Name     | Instrument Type | Unit (UCUM) | Description    |
 | -------- | --------------- | ----------- | -------------- |
@@ -413,6 +412,7 @@ The `Microsoft.AspNetCore.Authorization` metrics report information about [Autho
 | Attribute  | Type | Description  | Examples  | Presence |
 |---|---|---|---|---|
 | `user.is_authenticated` | Boolean | Match result | `success`; `failure` | Always |
+| `aspnetcore.authorization.result` | string | The authentication result. | `success` | Always |
 | `aspnetcore.authorization.policy` | string | The authorization policy. | `Basic` | Always |
 | `error.type` | string | The error message. | `An error occurred in the authorization handler` | Always |
 
@@ -422,14 +422,13 @@ The `Microsoft.AspNetCore.Authorization` metrics report information about [Autho
 
 The `Microsoft.AspNetCore.Authentication` metrics report information about [Authentication](xref:security/authentication/index) in ASP.NET Core apps:
 
-* [`aspnetcore.authentication.authenticate.duration`](#metric-aspnetcoreauthenticationauthenticateduration)
-* [`aspnetcore.authentication.challenges`](#metric-aspnetcoreauthenticationchallenges)
-* [`aspnetcore.authentication.forbids`](#metric-aspnetcoreauthenticationforbids)
-* [`aspnetcore.authentication.sign_ins`](#metric-aspnetcoreauthenticationsign_ins)
-* [`aspnetcore.authentication.sign_outs`](#metric-aspnetcoreauthenticationsign_outs)
+- [`aspnetcore.authentication.authenticate.duration`](#metric-aspnetcoreauthenticationauthenticateduration)
+- [`aspnetcore.authentication.challenges`](#metric-aspnetcoreauthenticationchallenges)
+- [`aspnetcore.authentication.forbids`](#metric-aspnetcoreauthenticationforbids)
+- [`aspnetcore.authentication.sign_ins`](#metric-aspnetcoreauthenticationsign_ins)
+- [`aspnetcore.authentication.sign_outs`](#metric-aspnetcoreauthenticationsign_outs)
 
-<!--- section links here -->
-##### Metric: `aspnetcore.authentication.authenticate.duration`
+#### Metric: `aspnetcore.authentication.authenticate.duration`
 
 | Name     | Instrument Type | Unit (UCUM) | Description    |
 | -------- | --------------- | ----------- | -------------- |
@@ -443,7 +442,7 @@ The `Microsoft.AspNetCore.Authentication` metrics report information about [Auth
 
 .
 
-##### Metric: `aspnetcore.authentication.challenges`
+#### Metric: `aspnetcore.authentication.challenges`
 
 | Name     | Instrument Type | Unit (UCUM) | Description    |
 | -------- | --------------- | ----------- | -------------- |
@@ -456,7 +455,7 @@ The `Microsoft.AspNetCore.Authentication` metrics report information about [Auth
 
 .
 
-##### Metric: `aspnetcore.authentication.forbids`
+#### Metric: `aspnetcore.authentication.forbids`
 
 | Name     | Instrument Type | Unit (UCUM) | Description    |
 | -------- | --------------- | ----------- | -------------- |
@@ -469,7 +468,7 @@ The `Microsoft.AspNetCore.Authentication` metrics report information about [Auth
 
 .
 
-##### Metric: `aspnetcore.authentication.sign_ins`
+#### Metric: `aspnetcore.authentication.sign_ins`
 
 | Name     | Instrument Type | Unit (UCUM) | Description    |
 | -------- | --------------- | ----------- | -------------- |
@@ -482,7 +481,7 @@ The `Microsoft.AspNetCore.Authentication` metrics report information about [Auth
 
 .
 
-##### Metric: `aspnetcore.authentication.sign_outs`
+#### Metric: `aspnetcore.authentication.sign_outs`
 
 | Name     | Instrument Type | Unit (UCUM) | Description    |
 | -------- | --------------- | ----------- | -------------- |

aspnetcore/log-mon/metrics/metrics.md

@@ -26,8 +26,8 @@ See [ASP.NET Core metrics](xref:log-mon/metrics/built-in) for a comprehensive li
 Using metrics involves the following:
 
 * **Instrumentation:** Code in .NET libraries takes measurements and associates these measurements with a metric name. .NET and ASP.NET Core include many built-in metrics.
-* **Collection:** A .NET app configures named metrics to be transmitted from the app for external storage and analysis. Some tools may perform configuration outside the app using configuration files or a UI tool.
-* **Display:** A tool that can display the metrics in a human-readable format. This is often a web-based dashboard that can be customized to show the most important metrics for a specific app.
+* **Collection and storage:** A .NET app configures named metrics to be transmitted from the app for external storage and analysis. Some tools may perform configuration outside the app using configuration files or a UI tool.
+* **Visualization:** A tool that can display the metrics in a human-readable format. For example, [Grafana](https://grafana.com/) and [Prometheus](https://prometheus.io/).
 * **Alerting:** A tool that provides notifications when a metric exceeds a threshold. For example, if the average response time for a web service exceeds 400 ms, an alert can be sent to the operations staff.
 * **Analysis:** A tool that can analyze the metrics over time. This is often a web-based dashboard that can be customized to show the most important metrics for a specific app.