---
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


---

# Enable automatic retirement for inactive Kubernetes cluster CIs

# Enable automatic retirement for inactive Kubernetes cluster CIs {#ariaid-title1}

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

Enable
automatic retirement to update the status of inactive Kubernetes cluster configuration items (CIs) and all associated resources during full discovery cycles, so your CMDB reflects only active infrastructure.

## Before you begin

Confirm you have the following setup:

* Kubernetes Visibility Agent (KVA) Plugin application release 3.15.0
* Informer version 2.6.0
{#remove-inactive-cis__ul_emw_c5b_mhc}

Role required: discovery_admin

## About this task

Enable automatic retirement to update the status of inactive Kubernetes cluster CIs and all associated resources (pods, namespaces, deployments, containers, and other resources) during full discovery cycles. This feature is disabled by default.

## Procedure

1. Enable automatic retirement for inactive cluster CIs by performing the following substeps.
   1. Navigate to All \> System Properties \> All Properties.
   2. In the Name field, enter <kbd class="ph userinput">sn_acc_visibility.auto_retire_k8s_clusters</kbd>.  
      * If the property is available, double-click the Value field to perform inline editing, enter <kbd class="ph userinput">true</kbd>.
      * If the property doesn't exist on your instance, select New and create the <kbd class="ph userinput">sn_acc_visibility.auto_retire_k8s_clusters</kbd> property with Type set to True/False, then double-click the Value field to perform inline editing, and enter <kbd class="ph userinput">true</kbd>.
      {#remove-inactive-cis__ul_auto_retire_property_options}  
      Auto-retirement is enabled. By default, clusters are retired after 60 days of inactivity with the <var class="keyword varname">install_status</var> set to Retired (value 7).
   3. **Optional:** Customize the inactivity period by setting the sn_acc_visibility.auto_retire_period_days property to the number of days after which inactive clusters should be retired.  
      The default value is 60 days.
   4. **Optional:** Customize the install status value by setting the sn_acc_visibility.auto_retire_install_status property to the numerical value of the desired install status.  
      The default value is 7 (Retired). Other possible values include 100 (Absent).  
      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.
   5. **Optional:** Configure the install status for Linux server CIs associated with Kubernetes nodes by setting the sn_acc_visibility.node_deletion_set_server_install_status property to the numerical value of the desired install status.  
      If this property does not exist or the value is empty, no action is taken on Linux server CIs when nodes are retired.
   {#remove-inactive-cis__substeps_auto_retire}
2. To manage the lifecycle of retired CIs, see <https://www.servicenow.com/docs/r/servicenow-platform/configuration-management-database-cmdb/cmdb-data-management.html>.
{#remove-inactive-cis__steps_ibg_jxm_xfc}