Configuring the Processing Time Histogram plugin
The Processing Time Histogram plugin is configured on each PingDirectory server and PingDirectoryProxy server as a set of histogram bucket ranges.
When the bucket ranges for a histogram change, the PingDataMetrics server notices the change and marks samples differently. This process allows for histograms with the same set of bucket definitions to be properly aggregated and understood when returned in a query. If different servers have different bucket definitions, then a single metric query cannot return histogram data from the servers.
You should try to keep the Processing Time Histogram bucket definitions the same on all servers. Having different definitions restricts the ability of the PingDataMetrics server API to aggregate histogram data across servers and makes the results of a query asking "What percentage of the search requests took less than 12 milliseconds?" harder to understand.
For each server in your topology, you must set the separate-monitor-entry-per-tracked-application
property of the Processing Time Histogram plugin to true. This property must be set to expose per-application monitoring information under cn=monitor
. When the separate-monitor-entry-per-tracked-application
property is set to true, then the per-application-ldap-stats
property must be set to per-application-only
on the Stats Collector plugin and vice versa.
The following dsconfig
command line sets the required properties of the Processing Time Histogram plugin.
$ bin/dsconfig set-plugin-prop --plugin-name “Processing Time Histogram” \
--set separate-monitor-entry-per-tracked-application:true
The following dsconfig
command-line sets the per-application-ldap-stats
property of the Stats Collector plugin to per-application-only
.
$ bin/dsconfig set-plugin-prop --plugin-name “Stats Collector” \
--set per-application-ldap-stats:per-application-only