Note: this component is designated "advanced", which means that objects of this type are not expected to be created or altered in most environments. If you believe that such a change is necessary, you may want to contact UnboundID support in order to understand the potential impact of that change.
This plugin logs server statistics to the specified log file at the specified interval in a comma-separated format. This is primarily used for profiling server performance. Unless the log-interval property is set too small, this has a negligible impact on performance.
↓Parent Component
↓Relations To this Component
↓Properties
↓dsconfig Usage
The Periodic Stats Logger Plugin component inherits from the Stats Plugin
The following components have a direct composition relation from Periodic Stats Logger Plugins:
The following components have a direct aggregation relation from Periodic Stats Logger Plugins:
The properties supported by this managed object are as follows:
| Basic Properties: | Advanced Properties: |
|---|---|
| ↓ description | ↓ host-info |
| ↓ enabled | ↓ collection-interval |
| ↓ log-interval | |
| ↓ suppress-if-idle | |
| ↓ header-prefix-per-column | |
| ↓ empty-instead-of-zero | |
| ↓ lines-between-header | |
| ↓ included-resource-stat | |
| ↓ log-file | |
| ↓ log-file-permissions | |
| ↓ append | |
| ↓ rotation-policy | |
| ↓ retention-policy |
| Description | A description for this Plugin |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | Indicates whether the plug-in is enabled for use. |
| Default Value | None |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | The duration between statistics collection and logging. A new line is logged to the output for each interval. Setting this value too small can have an impact on performance. |
| Default Value | 5 seconds |
| Allowed Values | A duration. Lower limit is 10 milliseconds. |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | If the server is idle during the specified interval, then do not log any output if this property is set to true. The server is idle if during the internval, no new connections were established, no operations were processed, and no operations are pending. |
| Default Value | false |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | This property controls whether the header prefix, which applies to a group of columns, appears at the start of each column header or only the first column in a group. Columns associated with the same monitor entry are grouped together in the output. If this property is set to true, then each column header will include the full prefix. This makes it easier to automatically parse the output. If set to false, then only the first column for each group of columns will include the header prefix. This makes the column header more compact. |
| Default Value | false |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | This property controls whether a value in the output is shown as empty if the value is zero. If the value of a column is zero, then it can alternatively be shown as empty. This can make it easier to visually spot non-zero values, but it can also increase the complexity of automatically parsing the output. Even if this is set to true, some columns might show up as zero. |
| Default Value | true |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | The number of lines to log between logging the header line that summarizes the columns in the table. |
| Default Value | 50 |
| Allowed Values | An integer value. Lower limit is 0. |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies whether statistics related to resource utilization such as JVM memory. |
| Default Value | None |
| Allowed Values | memory-utilization - Statistics related to memory consumers, garbage collection, and the amount of JVM memory used. |
| Multi-Valued | Yes |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | The file name to use for the log files generated by the Periodic Stats Logger Plugin. The path to the file can be specified either as relative to the server root or as an absolute path. |
| Default Value | None |
| Allowed Values | Unknown |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | The Periodic Stats Logger Plugin must be disabled and re-enabled for changes to this setting to take effect. This modification requires that you disable and then re-enable this component for the change to take effect |
| Description | The UNIX permissions of the log files created by this Periodic Stats Logger Plugin. |
| Default Value | 640 |
| Allowed Values | A valid UNIX mode string. The mode string must contain three digits between zero and seven. |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies whether to append to existing log files. |
| Default Value | true |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | The rotation policy to use for the Periodic Stats Logger Plugin . When multiple policies are used, rotation will occur if any policy's conditions are met. |
| Default Value | No rotation policy is used and log rotation will not occur. |
| Allowed Values | The DN of any Log Rotation Policy. |
| Multi-Valued | Yes |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | The retention policy to use for the Periodic Stats Logger Plugin . When multiple policies are used, log files are cleaned when any of the policy's conditions are met. |
| Default Value | No retention policy is used and log files are never cleaned. |
| Allowed Values | The DN of any Log Retention Policy. |
| Multi-Valued | Yes |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies the level of detail to include about the host system resource utilization including CPU, memory, disk and network activity. The server can capture performance information about the host system including CPU, network and disk utilization values. If the monitor providers that capture this information are enabled, the performance data can be captured by the Metrics Engine. Providing host system performance data gives a more robust understanding of application performance problems, as well as a useful tool for capacity planning. |
| Default Value | None |
| Allowed Values | cpu - Information is included about the CPU and memory utilization. This data is produced by Host System Cpu Memory Monitor Provider. disk - Information is included about the disk utilization of selected disks. Disks to be reported are configured in Host System Disk Monitor Provider. network - Information is included about network utilization of selected interfaces. Networks to be reported are configured in Host System Network Monitor Provider. |
| Multi-Valued | Yes |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
collection-interval (Advanced Property)
| Description | Some of the calculated statistics, such as the average and maximum queue sizes, can use multiple samples within a log interval. This value controls how often samples are gathered. It should be a multiple of the log-interval. |
| Default Value | 100 milliseconds |
| Allowed Values | A duration. Lower limit is 10 milliseconds. |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
To list the configured Plugins:
dsconfig list-plugins
[--property {propertyName}] ...
To view the configuration for an existing Plugin:
dsconfig get-plugin-prop
--plugin-name {name}
[--tab-delimited]
[--script-friendly]
[--property {propertyName}] ...
To update the configuration for an existing Plugin:
dsconfig set-plugin-prop
--plugin-name {name}
(--set|--add|--remove) {propertyName}:{propertyValue}
[(--set|--add|--remove) {propertyName}:{propertyValue}] ...
To create a new Periodic Stats Logger Plugin:
dsconfig create-plugin
--plugin-name {name}
--type {type}
--set enabled:{propertyValue}
--set log-file:{propertyValue}
[--set {propertyName}:{propertyValue}] ...
To delete an existing Plugin:
dsconfig delete-plugin
--plugin-name {name}