Tencent Cloud TKE¶

Collect observable data from Tencent Cloud TKE clusters, workloads, nodes, and Pods.

Configuration¶

Install Func¶

We recommend enabling TrueWatch Integration - Extensions - Managed Func. All prerequisites will be installed automatically.

If you deploy Func yourself, see Deploy Func Manually.

Install the Script¶

Note: Prepare Tencent Cloud access credentials that meet the requirements in advance. You can refer to similar Tencent Cloud collection scripts and grant read-only permissions.

Open the Func Script Market, search for integration_tencentcloud_tke, and install it.
Enter the Tencent Cloud AK, SK, account name, and other required parameters on the script installation page.
Click Deploy and Start Script. The system creates a Startup script set and configures the corresponding startup script.
Open Management / Automatic Trigger Configuration and confirm that the corresponding task has been created. You can click Run to execute it immediately, then inspect the task records and logs.

Verification¶

Under Management / Automatic Trigger Configuration, confirm that the automatic trigger task exists and check its task records and logs for errors.
Under Infrastructure / Custom in TrueWatch, confirm that TKE resource data has been collected.
Under Metrics in TrueWatch, confirm that TKE monitoring data has been collected.

Metrics¶

The following metrics are used by the built-in Tencent Cloud TKE · Kubernetes Overview and Tencent Cloud TKE · Pod SRE Overview views. The raw metrics come from the Tencent Cloud QCE/TKE2 namespace. Units are based on the display settings of the current built-in views.

Cluster Metrics¶

Measurement: tencentcloud_qce_tke2_cluster

Metric	Unit	Description
`k8s_cluster_allocatable_pods_total`	count	Number of Pods that can be allocated in the cluster.
`k8s_cluster_fs_read_bytes`	MiB	Amount of data read by the cluster from block devices.
`k8s_cluster_fs_write_bytes`	MiB	Amount of data written by the cluster to block devices.
`k8s_cluster_network_receive_bytes_bw`	Mbps	Inbound network bandwidth of the cluster.
`k8s_cluster_network_transmit_bytes_bw`	Mbps	Outbound network bandwidth of the cluster.
`k8s_cluster_node_total`	count	Total number of nodes in the cluster.
`k8s_cluster_pods_used_total`	count	Number of Pods in use in the cluster.
`k8s_cluster_rate_cpu_core_request_cluster`	%	Ratio of the total CPU requests of all containers in the cluster to the cluster's allocatable CPU.
`k8s_cluster_rate_cpu_core_used_cluster`	%	Overall CPU utilization of the cluster.
`k8s_cluster_rate_mem_request_bytes_cluster`	%	Ratio of the total memory requests of all containers in the cluster to the cluster's allocatable memory.
`k8s_cluster_rate_mem_working_set_cluster`	%	Ratio of working set memory usage to the cluster's memory capacity.

Node Metrics¶

Measurement: tencentcloud_qce_tke2_node

Metric	Unit	Description
`k8s_node_cpu_core_request_total`	cores	Total CPU requests of all Pods on the node.
`k8s_node_cpu_usage`	%	Node CPU utilization.
`k8s_node_mem_usage`	%	Node memory utilization.
`k8s_node_memory_request_bytes_total`	MiB	Total memory requests of all Pods on the node.
`k8s_node_pod_restart_total`	count	Total number of restarts for all Pods on the node.
`k8s_node_status_ready`	status value	Whether the node is in the Ready state.
`k8s_node_tcp_curr_estab`	count	Number of TCP connections currently in the Established state on the node.

Workload Metrics¶

Measurement: tencentcloud_qce_tke2_workload

Metric	Unit	Description
`k8s_workload_abnormal`	count	Number of Pods in an abnormal state within the workload.
`k8s_workload_cpu_core_used`	cores	CPU usage of all Pods in the workload.
`k8s_workload_mem_working_set_bytes`	MiB	Working set memory usage of all Pods in the workload.
`k8s_workload_network_receive_bytes_bw`	Mbps	Inbound network bandwidth of the workload.
`k8s_workload_network_transmit_bytes_bw`	Mbps	Outbound network bandwidth of the workload.
`k8s_workload_pod_restart_total`	count	Total number of Pod restarts in the workload.
`k8s_workload_pod_total`	count	Number of Pods in the workload.
`k8s_workload_rate_cpu_core_used_cluster`	%	Ratio of workload CPU usage to cluster CPU capacity.

Pod Metrics¶

Measurement: tencentcloud_qce_tke2_pod

Metric	Unit	Description
`k8s_pod_cpu_core_used`	cores	CPU usage of the Pod.
`k8s_pod_disk_usage`	%	Pod rootfs space utilization.
`k8s_pod_fs_read_bytes`	MiB	Amount of data read by the Pod from block devices.
`k8s_pod_fs_write_bytes`	MiB	Amount of data written by the Pod to block devices.
`k8s_pod_mem_working_set_bytes`	MiB	Working set memory usage of the Pod.
`k8s_pod_network_receive_bytes_bw`	Mbps	Inbound network bandwidth of the Pod.
`k8s_pod_network_receive_packets`	pps	Number of network packets received by the Pod per second.
`k8s_pod_network_transmit_bytes_bw`	Mbps	Outbound network bandwidth of the Pod.
`k8s_pod_network_transmit_packets`	pps	Number of network packets sent by the Pod per second.
`k8s_pod_rate_cpu_core_used_limit`	%	Ratio of Pod CPU usage to its CPU limit.
`k8s_pod_rate_cpu_core_used_request`	%	Ratio of Pod CPU usage to its CPU request.
`k8s_pod_rate_mem_working_set_limit`	%	Ratio of Pod working set memory usage to its memory limit.
`k8s_pod_rate_mem_working_set_request`	%	Ratio of Pod working set memory usage to its memory request.
`k8s_pod_restart_total`	count	Number of Pod restarts.
`k8s_pod_status_ready`	status value	Pod Ready status. A value of `1` indicates Ready, while `0` indicates Not Ready. The built-in view aggregates this metric to calculate the number of Ready and Not Ready Pods.

Container Metrics¶

Measurement: tencentcloud_qce_tke2_container

Metric	Unit	Description
`k8s_container_rate_cpu_core_used_limit`	%	Ratio of container CPU usage to its CPU limit.
`k8s_container_rate_cpu_core_used_request`	%	Ratio of container CPU usage to its CPU request.
`k8s_container_rate_mem_working_set_limit`	%	Ratio of container working set memory usage to its memory limit.
`k8s_container_rate_mem_working_set_request`	%	Ratio of container working set memory usage to its memory request.