---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Kubernetes cluster auto-retirement properties

# Kubernetes cluster auto-retirement properties {#ariaid-title1}

* Release version: Yokohama
* 
* Updated July 27, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Configure system properties to control the automatic retirement of inactive Kubernetes cluster configuration items (CIs) and their associated resources, so your CMDB reflects only active infrastructure.
The auto-retirement feature updates the <var class="keyword varname">install_status</var> field to retired on inactive Kubernetes cluster CIs and all associated CIs (pods, namespaces, deployments, containers, and other resources). A cluster is inactive when its associated Informer is in the Down state and the
cluster CI has not been updated for a configured period.

The system checks these conditions during each full discovery cycle. When the time comes to run full discovery and the Informer is in the Down state, the system evaluates the conditions and updates the status accordingly.

## Configuration properties {#cnov-auto-retire-properties__section_properties}

The following system properties control the auto-retirement behavior. Properties are located in the sys_properties table.
{#cnov-auto-retire-properties__table_auto_retire_properties__entry__4}

| Property name | Type | Default value | Description |
|-|-|-|-|
| sn_acc_visibility.auto_retire_k8s_clusters | Boolean | false | Determines whether the system retires inactive Kubernetes cluster CIs handled by Kubernetes Visibility Agent (KVA). Set to true to enable auto-retirement. |
| sn_acc_visibility.auto_retire_period_days | Integer | 60 | Number of days of inactivity after which the system retires a stale Kubernetes cluster. The system uses the <var class="keyword varname">sys_updated_on</var> field to determine when the cluster CI was last updated. |
| sn_acc_visibility.auto_retire_install_status | String | 7 | The numerical value the system writes to the <var class="keyword varname">install_status</var> field of the Kubernetes cluster CI and its associated CIs. Valid values include: * 7 (Retired) * 100 (Absent) {#cnov-auto-retire-properties__ul_install_status_values} Warning: If you set the value to 100 (Absent), the cluster CI and all associated CIs are deleted by a table cleanup job. This action is irreversible. |
| sn_acc_visibility.node_deletion_set_server_install_status | String | No value (empty) | The numerical value the system writes to the <var class="keyword varname">install_status</var> field of cmdb_ci_linux_server CIs associated with Kubernetes nodes. The system applies this value when nodes are deleted from the cluster or when the cluster is retired. If the property doesn't exist or is empty, the system takes no action on Linux server CIs. |
[Table 1. Auto-retirement configuration properties]

{#cnov-auto-retire-properties__table_auto_retire_properties}