---
sourceDocument: Australia IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Explore

# Exploring Kubernetes Visibility Agent {#ariaid-title1}

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

Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Exploring Kubernetes Visibility Agent

The Kubernetes Visibility Agent (KVA) enables ServiceNow customers to gain comprehensive visibility into both on-premises Kubernetes clusters and cloud deployments.
It continuously discovers and detects changes in Kubernetes resources, reporting these updates back to your ServiceNow instance and ensuring the Configuration Management Database (CMDB) stays current with the latest cluster data.
Show full answer Show less  

## How It Works

Upon deployment, Kubernetes creates a Deployment resource in your cluster that includes the Informer pod. This pod connects to the Kubernetes API server to receive real-time events on cluster resources. It sends this data to your ServiceNow instance via the External Communication Channel (ECC) Queue, using the Table API. The backend component of KVA then updates the appropriate CMDB tables accordingly.

If the Informer cannot report changes immediately due to network issues, changes are synchronized in subsequent discovery cycles. Deleted resources are marked as *Absent* and removed after two full discovery cycles to maintain CMDB accuracy.

## Initial and Periodic Discovery

* During initial discovery, the Informer collects and reports all resources in the cluster.
* It sends up to 1 MB of data every 30 seconds, efficiently handling clusters with tens of thousands of pods.
* If the Informer pod stops, Kubernetes automatically restarts it to ensure continuous monitoring.
* Deleted resources are marked as *Absent* and cleaned up within hours through regular maintenance.
* Auto-retirement can be enabled to mark inactive clusters (those with Informer down and no updates for a configurable period, default 60 days) as retired. This updates the cluster CI and all related resources in the CMDB.

## Performance and Impact

The Informer minimizes load on the Kubernetes API server by fetching the full resource list only once and then synchronizing updates incrementally. During full discovery cycles, it resends the saved resource data to the ServiceNow instance.

A single Informer pod can efficiently manage large clusters, supporting tens of thousands of pods with minimal performance impact.

## Additional Resources

For detailed information on supported cloud deployments, performance benchmarks, and configuration options such as auto-retirement, ServiceNow customers should refer to the corresponding knowledge base articles available through Now Support.  
Kubernetes Visibility Agent enables you to gain visibility into on-premises Kubernetes clusters as well as the various Cloud deployments.
Kubernetes Visibility Agent detects changes on resources in a Kubernetes cluster. It performs continuous discovery, reports any changes back to your instance, and updates the Configuration Management Database (CMDB) with the latest data. For the latest information on supported cloud deployments, see the [Kubernetes Visibility Agent (formerly CNO for Visibility) Support Matrix \[KB1700730\]](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1700730) article in the Now Support Knowledge Base.

## How it works {#cnov-exploring__section_qlp_hrd_syb}

When you deploy Kubernetes Visibility Agent, Kubernetes creates a Deployment resource in the cluster with the latest data. This resource uses a secret stored in Kubernetes to connect to your ServiceNow instance.

The Kubernetes Visibility Agent Deployment resource contains a pod called Informer, which connects to the Kubernetes API server and receives events on the resources in the cluster from it. The Informer sends the collected data to the instance through the External Communication Channel (ECC) Queue table, using
the ServiceNow Table API to read from and write to the queue. The backend part of Kubernetes Visibility Agent (KVA) then updates the appropriate tables in the CMDB.  
Note:  
If the Informer is unable to report the changes, for example due to a network problem, the resources that were added to the cluster during the event are added to the CMDB after the next full discovery cycle. The resources that were removed from the cluster during the event are marked as Absent and deleted after two full discovery cycles.

For more information about the Kubernetes resources on which the Informer collects data and the CMDB tables it populates, see [Data collected by Kubernetes Visibility Agent](https://www.servicenow.com/docs/RlvvObFBxw0Bn0lbBCZf2A "The Kubernetes Visibility Agent Informer collects data on Kubernetes resources and populates various CMDB tables.").

## Initial and periodic discovery {#cnov-exploring__section_jfb_q5d_syb}

In its initial discovery, the Informer finds all the resources in the Kubernetes cluster and reports them to your instance. Every 30 seconds, the Informer sends up to 1 MB of data to the instance. It typically takes up to two minutes to report data on a cluster containing
1,000 pods and another minute for every additional 1,000 pods. A single Informer pod can handle a cluster with tens of thousands of pods. If the Informer exits for any reason, Kubernetes restarts it automatically.

After the initial discovery, the Informer continuously monitors the addition, updating, and deletion of resources in the cluster. Resources that were deleted from the cluster are marked with install_status=Absent and deleted
from the CMDB within hours in a regular cleanup.

During each full discovery cycle, the system can optionally check for inactive clusters and automatically update their status. When the auto-retirement feature is enabled, clusters that meet
specific conditions are retired. A cluster is considered inactive when its associated Informer is in the Down state and the cluster CI has not been touched for a configured period (default: 60 days). The system determines
this based on the <var class="keyword varname">sys_updated_on</var> field, which indicates when the cluster was last observed by ServiceNow tools, regardless of whether any field values changed. When these conditions are met, the system updates the <var class="keyword varname">install_status</var> field on the Kubernetes cluster CI and all associated CIs (pods, namespaces, deployments, containers, and other resources). For information about configuring auto-retirement, see [Enable automatic retirement for inactive Kubernetes cluster CIs](https://www.servicenow.com/docs/S3sL6rDto~bRwId4ar~gjw "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."). For details about the configuration properties, see [Kubernetes cluster auto-retirement properties](https://www.servicenow.com/docs/cZJfdP9e8X_upojc~Wu6CA "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.").

## Impact of the Informer on the Kubernetes API server {#cnov-exploring__section_dq2_pvd_syb}

The Informer has minimal impact on the Kubernetes API server. It fetches the complete list of relevant resources only once and saves it to memory. From then on, it synchronizes with the Kubernetes API server and never pulls the complete list again. During the periodic and on-demand full discovery cycles, the Informer resends the saved list of resources to the instance.

## Kubernetes Visibility Agent performance and scalability benchmark {#cnov-exploring__section_ohw_zmx_dzb}

For Kubernetes Visibility Agent benchmarks, see the [Performance results for Kubernetes Visibility Agent \[KB1555851\]](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1555851) article in the Now Support Knowledge Base.

