NTPQ¶

Prerequisites¶

This plugin requires that the ntp daemon is installed and running. Verify you have the package installed, and that the service is queryable.

$ sudo apt-get install ntp

$ sudo ntpq -p

Configuration¶

The host agent provides an example configuration file to help you get started quickly. To enable the plugin:

1. Make a copy of the ntpq example configuration file /opt/appoptics/etc/plugins.d/ntpq.yaml.example, renaming it to /opt/appoptics/etc/plugins.d/ntpq.yaml:

   $ sudo cp /opt/appoptics/etc/plugins.d/ntpq.yaml.example /opt/appoptics/etc/plugins.d/ntpq.yaml
   

2. Update /opt/appoptics/etc/plugins.d/ntpq.yaml configuration file with settings specific to your NTP configuration, for example:

   collector:
     # Get standard NTP query metrics. Requires ntpq executable.
     ntpq:
       all:
         ## If false, set the -n ntpq flag. Can reduce metric gather time. (default=false)
         # dns_lookup: true
   
         # grpc_timeout sets the maximum time allowed for a gRPC call.
         # Some collector or plublisher plugins require more time to finish a gRPC method call during collection or publishing.
         # When increasing grpc_timeout value with the deadline value specified in
         # manifest task file which controls the total time allocated for the
         # Default value is 10
         grpc_timeout: 30
   
   load:
     plugin: snap-plugin-collector-bridge-ntpq
     task: task-bridge-ntpq.yaml
   

3. Restart the host agent:

   $ sudo service appoptics-snapteld restart
   

4. Enable the NTPQ plugin

On the Integrations Page you will see NTPQ available if the previous steps were successful.

Metrics¶

Tags¶