feat: add deprecation warning for metrics

Author: ankur-arch

content/200-orm/200-prisma-client/600-observability-and-logging/240-metrics.mdx

@@ -6,17 +6,25 @@ sidebar_class_name: preview-badge
 toc_max_heading_level: 4
 ---
 
-<TopBlock>
 
 Prisma Client metrics give you a detailed insight into how Prisma Client interacts with your database. You can use this insight to help diagnose performance issues with your application.
 
-<Admonition type="info">
+:::info 
 
 If you want an even more detailed insight into your Prisma Client's performance, at the level of individual operations, see [Tracing](/orm/prisma-client/observability-and-logging/opentelemetry-tracing).
 
-</Admonition>
+:::
+
+:::warning[`metrics` preview feature is deprecated]
+
+The `metrics` preview feature has been **deprecated** as of [Prisma ORM v6.14.0](https://github.com/prisma/prisma/releases/tag/6.14.0) and will be removed in Prisma ORM v7.  
+
+Metrics were originally introduced to provide insights into query and connection behavior. With the changes in the new [query compiler architecture](/orm/prisma-client/setup-and-configuration/no-rust-engine), these values no longer reflect the system reliably. Because of this, we are not continuing support for this feature. 
+
+If you need visibility into query or connection pool behavior, we recommend using the *native metrics provided by your database driver* (for example, pool statistics) or setting up *OpenTelemetry* for a more complete observability solution.  
+
+:::
 
-</TopBlock>
 
 ## About metrics