Consolidate Diagnostics documentation.

Move Logging and Tracing to new Diagnostics section and add a page for Metrics.

Author: bgrainger

docs/config.toml

@@ -27,17 +27,22 @@ disablePathToLower = true
     identifier = "getting started"
     pre = "<i class='fa fa-road'></i>"
     weight = 20
-[[menu.main]]
-    name = "Tutorials"
-    identifier = "tutorials"
-    pre = "<i class='fa fa-lightbulb-o'></i>"
-    weight = 40
 [[menu.main]]
     name = "API"
     identifier = "api"
     pre = "<i class='fa fa-file-text'></i>"
     url = "/api/MySqlConnectorAssembly/"
-    weight = 35
+    weight = 30
+[[menu.main]]
+    name = "Diagnostics"
+    identifier = "diagnostics"
+    pre = "<i class='fa fa-road'></i>"
+    weight = 40
+[[menu.main]]
+    name = "Tutorials"
+    identifier = "tutorials"
+    pre = "<i class='fa fa-lightbulb-o'></i>"
+    weight = 50
 [[menu.main]]
     name = "Troubleshooting"
     identifier = "troubleshooting"

docs/content/overview/logging.md renamed to docs/content/diagnostics/logging.md

@@ -1,11 +1,11 @@
 ---
-lastmod: 2023-07-07
+lastmod: 2023-11-11
 date: 2018-01-20
 menu:
   main:
-    parent: getting started
+    parent: diagnostics
 title: Logging
-weight: 50
+weight: 10
 ---
 
 Logging

docs/content/diagnostics/metrics.md

@@ -0,0 +1,42 @@
+---
+date: 2023-11-11
+menu:
+  main:
+    parent: diagnostics
+title: Metrics
+weight: 30
+---
+
+# Metrics
+
+MySqlConnector exposes metrics that follow the [OpenTelemetry Semantic Conventions for Database Metrics](https://opentelemetry.io/docs/specs/semconv/database/database-metrics/) via types in the [System.Diagnostics.Metrics](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.metrics) namespace.
+
+<blockquote class="note">Metrics are only supported in MySqlConnector 2.3.0 or later.</blockquote>
+
+The name used for the meter is `MySqlConnector`.
+
+Connect a listener using the `MeterListener` class:
+
+```csharp
+new MeterListener
+{
+    InstrumentPublished = (instrument, listener) =>
+    {
+        if (instrument.Meter.Name == "MySqlConnector")
+            listener.EnableMeasurementEvents(instrument);
+    }
+};
+```
+
+## Supported Instruments
+
+Name | Type | Unit | Description
+--- | --- | --- | ---
+`db.client.connections.usage` | UpDownCounter | `{connection}` | The number of connections that are currently in the state described by the state tag.
+`db.client.connections.pending_requests` | UpDownCounter | `{request}` | The number of pending requests for an open connection, cumulative for the entire pool.
+`db.client.connections.create_time` | Histogram | `ms` | The time it took to create a new connection.
+`db.client.connections.use_time` | Histogram | `ms` | The time between borrowing a connection and returning it to the pool.
+`db.client.connections.wait_time` | Histogram | `ms` | The time it took to obtain an open connection from the pool.
+`db.client.connections.idle.max` | UpDownCounter | `{connection}` | The maximum number of idle open connections allowed; this corresponds to `MaximumPoolSize` in the connection string.
+`db.client.connections.idle.min` | UpDownCounter | `{connection}` | The minimum number of idle open connections allowed; this corresponds to `MinimumPoolSize` in the connection string.
+`db.client.connections.max` | UpDownCounter | `{connection}` | The maximum number of open connections allowed; this corresponds to `MaximumPoolSize` in the connection string.

docs/content/tutorials/tracing.md renamed to docs/content/diagnostics/tracing.md

@@ -1,10 +1,11 @@
 ---
+lastmod: 2023-11-11
 date: 2021-10-16
 menu:
   main:
-    parent: tutorials
+    parent: diagnostics
 title: Tracing
-weight: 13
+weight: 20
 ---
 
 # Tracing

netlify.toml

@@ -100,3 +100,15 @@ from = "/tutorials/"
 to = "/"
 status = 302
 force = true
+
+[[redirects]]
+from = "/overview/logging/"
+to = "/diagnostics/logging/"
+status = 302
+force = true
+
+[[redirects]]
+from = "/tutorials/tracing/"
+to = "/diagnostics/tracing/"
+status = 302
+force = true