From c260b0672e2e79ff8b26b87e266cbbafbdfa32ba Mon Sep 17 00:00:00 2001
From: Katharina Przybill <30441792+kathap@users.noreply.github.com>
Date: Tue, 24 Mar 2026 12:59:55 +0100
Subject: [PATCH] Add cpu_entitlement to v3 docs in process stats object

---
 docs/v3/source/includes/resources/processes/_stats_object.md.erb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/v3/source/includes/resources/processes/_stats_object.md.erb b/docs/v3/source/includes/resources/processes/_stats_object.md.erb
index 2f43891567d..ec853903fbc 100644
--- a/docs/v3/source/includes/resources/processes/_stats_object.md.erb
+++ b/docs/v3/source/includes/resources/processes/_stats_object.md.erb
@@ -19,6 +19,7 @@ Name | Type | Description
 **usage** | _object_ | Object containing actual usage data for the instance; the value is `{}` when usage data is unavailable
 **usage.time** | _[timestamp](#timestamps)_ | The time when the usage was requested
 **usage.cpu** | _number_ | The current cpu usage of the instance
+**usage.cpu_entitlement** | _number_ | The current cpu usage relative to the instance's cpu entitlement; the value is `null` when cpu entitlement data is unavailable
 **usage.mem** | _integer_ | The current memory usage of the instance
 **usage.disk** | _integer_ | The current disk usage of the instance
 **usage.log_rate** | _integer_ | The current logging usage of the instance