Kubernetes cluster auto-retirement properties

  • Release version: Australia
  • Updated July 27, 2026
  • 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 install_status 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

    The following system properties control the auto-retirement behavior. Properties are located in the sys_properties table.

    Table 1. Auto-retirement configuration properties
    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 sys_updated_on 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 install_status field of the Kubernetes cluster CI and its associated CIs. Valid values include:
    • 7 (Retired)
    • 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.
    sn_acc_visibility.node_deletion_set_server_install_status String No value (empty) The numerical value the system writes to the install_status 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.