diff --git a/model/metrics/deprecated/jvm-metrics-experimental.yaml b/model/metrics/deprecated/jvm-metrics-experimental.yaml
new file mode 100644
index 0000000000..2641fc1a5c
--- /dev/null
+++ b/model/metrics/deprecated/jvm-metrics-experimental.yaml
@@ -0,0 +1,10 @@
+groups:
+  - id: metric.jvm.buffer.memory.usage.deprecated
+    type: metric
+    metric_name: jvm.buffer.memory.usage
+    stability: experimental
+    deprecated: "Replaced by `jvm.buffer.memory.used`."
+    brief: "Deprecated, use `jvm.buffer.memory.used` instead."
+    extends: attributes.jvm.buffer
+    instrument: updowncounter
+    unit: "By"