Monitoring Master/etcd Node VMs
Page last updated:
This topic describes how platform operators can monitor and retrieve metrics from master/etcd node VMs in VMware Enterprise PKS deployments.
You can configure the Telegraf agent to collect metrics from master/etcd node VMs and send the metrics to a third-party monitoring service. The Telegraf agent can read metrics from the following:
/metricsendpoint exposed by etcd
- Node Exporter
Node Exporter exports hardware and operating system metrics in Prometheus format.
In Enterprise PKS, you can enable the Node Exporter BOSH job separately on master nodes, worker nodes, and the PKS API VM. These settings are located in the Host Monitoring pane of the Enterprise PKS tile.
Node Exporter exposes metrics on localhost only. For a list of Node Exporter metrics, see the Node Exporter GitHub repository.
To collect metrics using Telegraf, do the following:
- Create a configuration file for your output plugin. See Create a Configuration File.
- Configure Telegraf in the Enterprise PKS tile. See Configure Telegraf in the Tile.
To connect a third-party monitoring service to Enterprise PKS, you must create a configuration file for the service. The configuration file is written in a TOML format and consists of key-value pairs. After you create your configuration file, you can enter the file into the Enterprise PKS tile to connect the service.
To create a configuration file your monitoring service, do the following:
Locate the required format for your monitoring service in the
README.mdfile for your service in telegraf in GitHub. The etcd documentation recommends using the open source Prometheus monitoring service.
For more information about using Prometheus, see Overview in the Prometheus documentation.
Create your configuration file using the required format of your monitoring service. For example, if you want to create a configuration file for an HTTP output plugin, create a file similar to the following:
[[outputs.http]] url="https://example.com" method="POST" data_format="json" [[processors.override]] [processors.override.tags] director = "bosh-director-1"
Note: You can add tags to your configuration file to label etcd metrics. For example, the above code snippet adds a
bosh-director-1tag to the etcd metrics. If you have multiple BOSH Directors, VMware recommends adding tags to filter your metrics in your monitoring service.
To configure Telegraf in the Enterprise PKS tile, follow the instructions in the Installing topic for your IaaS. For example, if your are installing Enterprise PKS on vSphere, follow the instructions in the Telegraf section of Installing Enterprise PKS on vSphere.
VMware recommends working with Support to troubleshoot master/etcd node VMs. The monitoring and metrics data you retrieve from the master/etcd node VMs can help the Support team diagnose and troubleshoot errors.
Please send any feedback you have to firstname.lastname@example.org.