Skip to main content
To forward CKS metrics to an external system, you will need to deploy the Prometheus Agent inside your CKS cluster and configure it to use remote-write.
CKS Clusters deployed before July 7, 2025 have Prometheus Operator pre-installed.CKS clusters deployed after July 7, 2025 do not have the Prometheus Operator pre-installed. Clusters deployed after this date must install Prometheus Operator before proceeding with the steps below.
To deploy the Prometheus Agent in your CKS cluster, complete the following steps:
  1. Choose a namespace to deploy the Prometheus Agent in. You may deploy the Prometheus Agent to an existing namespace, or create a new namespace with kubectl: To create a new namespace, run the following command, replacing MY_REMOTE_WRITE_NAMESPACE with your chosen namespace: 
    $ kubectl create namespace MY_REMOTE_WRITE_NAMESPACE
  2. Configure the Prometheus Agent CustomResource YAML file with your remote-write destination, as in the following example:
    sample-prometheus-agent.yaml
    apiVersion: monitoring.coreos.com/v1alpha1
kind: PrometheusAgent
metadata:
  name: my-prom-agent
  namespace: MY_REMOTE_WRITE_NAMESPACE
spec:
  remoteWrite:
    - url: "https://example-url/api/v1/write"
      ...
    For more details on specifying the remoteWrite configuration(s), see Prometheus Operator’s API reference.
  3. Use kubectl to deploy the Prometheus Agent to your CKS cluster with the following command, replacing sample-prometheus-agent.yaml with the appropriate filename: 
    $ kubectl apply -f sample-prometheus-agent.yaml
    Metrics generated within your CKS cluster will now remote-write to your specified destination.
Last modified on March 24, 2026