Add status.last_terminated_exitcode field in state_container metricset (#47968)

* Add status.last_terminated_exitcode field in state_container metricset

* Update metricbeat/module/kubernetes/state_container/_meta/fields.yml

Co-authored-by: Andrew Gizas <[email protected]>

* Add changelog and update documentation example

* Update changelog/fragments/1765359658-k8s_status_last_terminated_exitcode.yaml

Co-authored-by: Andrew Gizas <[email protected]>

---------

Co-authored-by: Andrew Gizas <[email protected]>
(cherry picked from commit 71fb391)

Author: 2 people

changelog/fragments/1765359658-k8s_status_last_terminated_exitcode.yaml

@@ -0,0 +1,32 @@
+# Kind can be one of:
+# - breaking-change: a change to previously-documented behavior
+# - deprecation: functionality that is being removed in a later release
+# - bug-fix: fixes a problem in a previous version
+# - enhancement: extends functionality but does not break or fix existing behavior
+# - feature: new functionality
+# - known-issue: problems that we are aware of in a given version
+# - security: impacts on the security of a product or a user’s deployment.
+# - upgrade: important information for someone upgrading from a prior version
+# - other: does not fit into any of the other categories
+kind: enhancement
+
+# Change summary; a 80ish characters long description of the change.
+summary: Add `last_terminated_exitcode` to `kubernetes.container.status`
+
+# Long description; in case the summary is not enough to describe the change
+# this field accommodate a description without length limits.
+# NOTE: This field will be rendered only for breaking-change and known-issue kinds at the moment.
+#description:
+
+# Affected component; usually one of "elastic-agent", "fleet-server", "filebeat", "metricbeat", "auditbeat", "all", etc.
+component: metricbeat
+
+# PR URL; optional; the PR number that added the changeset.
+# If not present is automatically filled by the tooling finding the PR where this changelog fragment has been added.
+# NOTE: the tooling supports backports, so it's able to fill the original PR number instead of the backport PR number.
+# Please provide it if you are adding a fragment for a different PR.
+#pr: https://github.com/owner/repo/1234
+
+# Issue URL; optional; the GitHub issue related to this changeset (either closes or is part of).
+# If not present is automatically filled by the tooling with the issue linked to the PR number.
+#issue: https://github.com/owner/repo/1234

docs/reference/metricbeat/exported-fields-kubernetes.md

@@ -1541,6 +1541,12 @@ kubernetes container metrics
     type: double
 
 
+**`kubernetes.container.status.last_terminated_exitcode`**
+:   The exit code for the last container in terminated state.
+
+    type: integer
+
+
 **`kubernetes.container.cpu.limit.cores`**
 :   Container CPU cores limit
 

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_container.md

@@ -21,9 +21,9 @@ Here is an example document generated by this metricset:
 {
     "@timestamp": "2019-03-01T08:05:34.853Z",
     "container": {
-        "id": "054b424625a7c22c210e3fe0aae55069d4f3e18ce8bc802a9a96ce87bb7a2483",
+        "id": "fed1a0f0adeb312c82caea61cf5b46f0a6d81bd4ae891dad54f88d99a822fb3d",
         "image": {
-            "name": "docker.io/library/busybox:latest"
+            "name": "docker.io/kindest/kindnetd:v20241212-9f82dd49"
         },
         "runtime": "containerd"
     },
@@ -34,21 +34,39 @@ Here is an example document generated by this metricset:
     },
     "kubernetes": {
         "container": {
-            "id": "054b424625a7c22c210e3fe0aae55069d4f3e18ce8bc802a9a96ce87bb7a2483",
-            "name": "hello",
+            "cpu": {
+                "limit": {
+                    "cores": 0.1
+                },
+                "request": {
+                    "cores": 0.1
+                }
+            },
+            "id": "fed1a0f0adeb312c82caea61cf5b46f0a6d81bd4ae891dad54f88d99a822fb3d",
+            "memory": {
+                "limit": {
+                    "bytes": 52428800
+                },
+                "request": {
+                    "bytes": 52428800
+                }
+            },
+            "name": "kindnet-cni",
             "status": {
-                "phase": "terminated",
-                "ready": false,
-                "reason": "Completed",
-                "restarts": 0
+                "last_terminated_exitcode": 255,
+                "last_terminated_reason": "Unknown",
+                "last_terminated_timestamp": 1744109218,
+                "phase": "running",
+                "ready": true,
+                "restarts": 1
             }
         },
-        "namespace": "default",
+        "namespace": "kube-system",
         "node": {
             "name": "kind-control-plane"
         },
         "pod": {
-            "name": "hello-28564555-zdfjz"
+            "name": "kindnet-gzkxz"
         }
     },
     "metricset": {

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_cronjob.md

@@ -39,15 +39,15 @@ Here is an example document generated by this metricset:
                 "count": 0
             },
             "created": {
-                "sec": 1713862291
+                "sec": 1744115807
             },
             "is_suspended": false,
             "last_schedule": {
-                "sec": 1713873360
+                "sec": 1744115820
             },
             "name": "hello",
             "next_schedule": {
-                "sec": 1713873420
+                "sec": 1744115880
             }
         },
         "namespace": "default"

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_daemonset.md

@@ -27,7 +27,7 @@ Here is an example document generated by this metricset:
     },
     "kubernetes": {
         "daemonset": {
-            "name": "kube-proxy",
+            "name": "kindnet",
             "replicas": {
                 "available": 1,
                 "desired": 1,

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_deployment.md

@@ -27,7 +27,7 @@ Here is an example document generated by this metricset:
     },
     "kubernetes": {
         "deployment": {
-            "name": "kube-state-metrics",
+            "name": "local-path-provisioner",
             "paused": false,
             "replicas": {
                 "available": 1,
@@ -40,7 +40,7 @@ Here is an example document generated by this metricset:
                 "progressing": "true"
             }
         },
-        "namespace": "kube-system"
+        "namespace": "local-path-storage"
     },
     "metricset": {
         "name": "state_deployment",

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_horizontalpodautoscaler.md

@@ -30,12 +30,12 @@ Here is an example document generated by this metricset:
             "name": "cpu",
             "replicas": {
                 "current": 1,
-                "desired": 1,
-                "max": 5,
+                "desired": 0,
+                "max": 2,
                 "min": 1
             },
             "status": {
-                "condition": "scalinglimited"
+                "condition": "scalingactive"
             }
         },
         "namespace": "default"

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_job.md

@@ -30,7 +30,7 @@ Here is an example document generated by this metricset:
             "completions": {
                 "desired": 1
             },
-            "name": "hello-28564554",
+            "name": "hello-29068597",
             "owner": {
                 "is_controller": "true",
                 "kind": "CronJob",
@@ -48,8 +48,8 @@ Here is an example document generated by this metricset:
                 "complete": "true"
             },
             "time": {
-                "completed": "2024-04-23T11:54:02.000Z",
-                "created": "2024-04-23T11:54:00.000Z"
+                "completed": "2025-04-08T12:37:03.000Z",
+                "created": "2025-04-08T12:37:00.000Z"
             }
         },
         "namespace": "default"

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_node.md

@@ -29,21 +29,21 @@ Here is an example document generated by this metricset:
         "node": {
             "cpu": {
                 "allocatable": {
-                    "cores": 16
+                    "cores": 32
                 },
                 "capacity": {
-                    "cores": 16
+                    "cores": 32
                 }
             },
             "kubelet": {
-                "version": "v1.29.1"
+                "version": "v1.32.0"
             },
             "memory": {
                 "allocatable": {
-                    "bytes": 16769380352
+                    "bytes": 67285303296
                 },
                 "capacity": {
-                    "bytes": 16769380352
+                    "bytes": 67285303296
                 }
             },
             "name": "kind-control-plane",

docs/reference/metricbeat/metricbeat-metricset-kubernetes-state_persistentvolumeclaim.md

@@ -29,14 +29,14 @@ Here is an example document generated by this metricset:
         "namespace": "default",
         "persistentvolumeclaim": {
             "access_mode": "ReadWriteOnce",
-            "created": "2024-04-23T08:51:31.000Z",
-            "name": "task-pv-claim",
+            "created": "2025-04-08T12:36:47.000Z",
+            "name": "mnt-basic-sts-0",
             "phase": "Bound",
             "request_storage": {
-                "bytes": 1024
+                "bytes": 1048576
             },
-            "storage_class": "generic",
-            "volume_name": "task-pv-volume"
+            "storage_class": "standard",
+            "volume_name": "pvc-bdf9afc1-c19e-44db-b169-fdcb423338d2"
         }
     },
     "metricset": {