AutoTune
ZenPacks.zenoss.AutoTune
The AutoTune ZenPack enables the ZenTune "tuning advisor" feature in Resource Manager. ZenTune analyzes your system configuration and makes recommendations for better performance.
Support
This ZenPack is developed and supported by Zenoss Inc. Commercial ZenPacks are available to Zenoss commercial customers only. Contact Zenoss to request more information regarding this or any other ZenPacks. Click here to view all available Zenoss Commercial ZenPacks.
This ZenPack is included with commercial versions of Zenoss and enterprise support for this ZenPack is provided to Zenoss customers with an active subscription.
Prerequisites
| Prerequisite | Restriction |
|---|---|
| Product | Zenoss platform 4.2 |
| Required ZenPacks | ZenPacks.zenoss.AutoTune |
Configuring ZenTune
You can set values for several options in the zentune.conf configuration file (or when running ZenTune from the command line) to configure behavior.
When setting up ZenTune, you can define options to send a test event through the lifecycle to make sure that Zenoss is processing events before the timeout. If it fails to process in time, an email can be sent out.
- testevent-enable -- When testevent-enable is present in the zentune.conf file, a test event will be sent. If it is not present or commented out, no test event is sent.
- testevent-email ValidEmailAddress -- If testevent-enable is present and the test event times out, an email will be sent to the defined email address.
ZenTune can perform an analysis one or more times each day, depending on the values of these two options:
- tune-offset Value -- Sets the number of minutes after midnight when the ZenTune will first run. By default, the value is 0.
- tune-interval Value -- Sets the number of minutes to wait before running ZenTune again. By default, the value is 0, which is equivalent to 1440 (24 hours).
So, for example, if you want ZenTune to run twice each day, set the value of tune-offset to 0 and the value of tune-interval to 720.
Configuring ZenTune for Remote Databases
If you have installed the Zenoss DataStore on a server other than your master server, then you must set additional configuration options. Set the following options in the $ZENHOME/etc/zentune.conf file of the master server:
Remote Database Configuration Options
| Option | Description |
|---|---|
| mysqltuner-zodb-forcemem MegaBytes | Sets the amount of memory available on the server running the ZODB database server. |
| mysqltuner-zep-forcemem MegaBytes | Sets the amount of memory available on the server running the ZEP database server. |
Using ZenTune
To access ZenTune, select Advanced > Tuning from the Zenoss platform interface.
To run ZenTune, click Update (located at the bottom left of the page). ZenTune may require several minutes to run.
Note: To check the update status, refresh the browser page and then check the "Update at" value for any watched items.
ZenTune returns information about current and optimal values for several configuration parameters. Click + to the left of each item to display recommendations, if any, for configuration changes.
To refresh the view, click Refresh. (This does not run ZenTune again.)
To filter the list of displayed items, select Not Acknowledged, Acknowledged, or both in the Acknowledge column. To acknowledge one or more items, select the option in the Acknowledge column.
You also can filter the display by severity, host, and description.
Running ZenTune from the Command Line
You can run ZenTune from the command line. On the master server, use the command:
zentune run
To run ZenTune on a remote hub or collector, prefix the command with the name of the hub or collector, followed by an underscore. For example, if the remote collector name is centos6-coll, then run the command as:
centos6-coll_zentune run
Tuneable Items
The following table lists included tuneable items.
| Name | Group | Description |
|---|---|---|
| zeneventd workers | Events | ZenTune monitors the number of incoming events to the zeneventd daemon. If the number of incoming events exceeds the configured threshold per worker, then a tuning event is generated. If the threshold is exceeded only during peak load times, a WARNING severity tuning event is generated. If it is exceeded more often, an ERROR severity tuning event is generated.
The threshold checked is controlled by these configuration options on the zentune daemon:
For detailed information about each of these options, run this command on any Zenoss platform server: zentune run --help |
| zeneventserver | Events | |
| zeneventserver age-eligible events | Events | |
| zeneventserver archive-eligible events | Events | |
| zeneventserver processed events | Events | |
| zeneventserver deduped events | Events | |
| zeneventserver dropped events | Events | |
| zeneventserver cleared events | Events | |
| zeneventserver archived events | Events | |
| zeneventserver aged events | Events | |
| zeneventserver summary queue length | Events | |
| zeneventserver archive queue length | Events | |
| zeneventserver summary index size | Events | |
| zeneventserver archive index size | Events | |
| zeneventserver summary index doc count | Events | |
| zeneventserver archive index doc count | Events | |
| age eligible event count | Events | |
| archive eligible event count | Events | |
| zeneventserver summary queue length | Events | |
| zeneventserver archive queue length | Events | |
| zeneventd object cache | Global | The zeneventd zodb-cachesize configuration setting controls the number of objects that zeneventd will store locally to avoid querying ZODB. Zenoss platform expects this value to be between certain thresholds, proportional to the size of the global catalog. If any of these thresholds are violated, then a WARNING or ERROR severity tuning event is generated, depending on the configured thresholds.
The thresholds checked are controlled by the following configuration options on the zentune daemon:
For detailed information about each of these options, run this command on any Zenoss platform server: zentune run --help |
| ZODB cache servers | Global | Zenoss platform expects at least one memcached server to be configured for its use as a ZODB cache. If this is not the case, then an ERROR severity tuning event is generated.
Memcached is a third-party object caching system used by Zenoss platform to improve performance for daemons that connect to Zope and ZODB. It is not required for Zenoss platform to function, but it is highly recommended. More information on memcached can be found here: |
| globalConfig | Global | |
| Global config sip size | Global | The configsipsize global configuration setting controls the number of device configuration objects that a collector daemon will receive in a single request. A setting of 0 implies that all device configurations will be requested at once. Combined with the configsipdelay option, this effectively controls the traffic to collector daemons. |
| Global config sip delay | Global | The configsipdelay global configuration setting controls the number of seconds between requests for device configuration objects that a collector daemon will make. Combined with the configsipsize option, this effectively controls the traffic to collector daemons. |
| Event flush chunk size | Global | The eventflushchunksize global configuration setting controls the number of events a collector daemon will send to zenhub at one time. Each collector daemon will periodically flush its outgoing event queue and send events to zenhub until the queue is empty. |
| Maximum queue length | Global | The maxqueuelen global configuration setting controls the number of events a collector daemon can store in its outgoing event queue before it must start dropping events. |
| IO CPU Wait Time | IO | ZenTune monitors iostat statistics, and if any device causes wait times exceeding the configured threshold in more than 5% of cases, then an ERROR severity tuning event is generated. The threshold checked is controlled by the following configuration option on the zentune daemon:
For detailed information about each of these options, run this command on any Zenoss platform server: zentune run --help The iostat utility is a third-party program that provides statistics on the time the CPU spends waiting for I/O requests from various devices. More information on iostat can be found here: |
| Cache miss percentage | Memcached | Memcached is a third-party object caching system used by Zenoss platform to improve performance for daemons that connect to Zope and ZODB. It is not required for Zenoss platform to function, but it is highly recommended.
More information on memcached can be found here: |
| Maximum size | Memcached | Memcached is a third-party object caching system used by Zenoss platform to improve performance for daemons that connect to Zope and ZODB. It is not required for Zenoss platform to function, but it is highly recommended.
More information on memcached can be found here: |
| Cache eviction rate | Memcached | Memcached is a third-party object caching system used by Zenoss platform to improve performance for daemons that connect to Zope and ZODB. It is not required for Zenoss platform to function, but it is highly recommended.
More information on memcached can be found here: |
| Cache servers | Memcached | Zenoss platform expects at least one memcached server to be configured for its use. If this is not the case, then an INFO severity tuning event is generated. Zenoss platform also expects all configured memcached servers to be available and responding to connection attempts using the standard memcached client. If this is not the case, then an ERROR severity tuning event is generated.
Memcached is a third-party object caching system used by Zenoss platform to improve performance for daemons that connect to Zope and ZODB. It is not required for Zenoss platform to function, but it is highly recommended. More information on memcached can be found here: |
| Cache size | Memcached | Zenoss platform expects the use of each memcached server to conform to certain performance thresholds. Specifically, the utilization level and eviction rate of each memcached server are checked. If any of these thresholds are violated, then a WARNING or ERROR severity tuning event is generated, depending on the configured thresholds. The thresholds checked are controlled by the following configuration options on the zentune daemon:
For detailed information about each of these options, run this command on any Zenoss platform server: zentune run --help Memcached is a third-party object caching system used by Zenoss platform to improve performance for daemons that connect to Zope and ZODB. It is not required for Zenoss platform to function, but it is highly recommended. More information on memcached can be found here: |
| MySqlTuner script | Resources | ZenTune expects the mysqltuner.pl utility to be installed and available for its use to enable more detailed tuning advice. The mysqltuner.pl utility is a third-party tuning script that provides advanced statistics on MySQL. More information on mysqltuner.pl can be found here:
MySQL is a third-party, open-source relational database. Zenoss platform uses MySQL as the backing data store for ZODB, as well as directly to store events and user sessions. More information on MySQL can be found here: |
| iostat Utility | Resources | ZenTune expects the iostat utility to be installed and available for its use to enable more detailed tuning advice. The iostat utility is a third-party program that provides statistics on the time the CPU spends waiting for I/O requests from various devices. More information on iostat can be found here: |
| Memory | Resources | This tuning item provides information about the total amount of RAM installed in the Zenoss platform master server. |
| Processes | Resources | This tuning item provides advice on the distribution of CPU-intensive Zenoss platform processes according to the number of cores available on the Zenoss platform server. If any of the thresholds are violated, a WARNING or ERROR severity tuning event will be generated, depending on the configured thresholds. The thresholds checked are controlled by the following configuration options on the zentune daemon:
For detailed information about each of these options, run this command on any Zenoss platform server: zentune run --help |
| MySQL Version | MySQL Database | Zenoss platform expects that at least a specific, minimum version of MySQL is installed and available for its use. Earlier versions may not support all the features that Zenoss platform requires, or may have hidden incompatibilities. If this minimum threshold is violated, then an ERROR severity tuning event is generated, depending on the configured threshold. The threshold checked is controlled by the following configuration option on the zentune daemon:
For detailed information about this option, run this command on any Zenoss platform server: zentune run --help MySQL is a third-party, open-source relational database. Zenoss platform uses MySQL as the backing data store for ZODB, as well as directly to store events and user sessions. More information on MySQL can be found here: |
| InnoDB buffer pool size | MySQL Database | If the mysqltuner.pl script recommends increasing the amount of memory available to InnoDB, then an ERROR level tuning event is generated. More information on the innodb_buffer_pool_size configuration setting can be found here:
http://dev.mysql.com/doc/refman/5.5/en/innodb-parameters.html\#sysvar_innodb_buffer_pool_size MySQL is a third-party, open-source relational database. Zenoss platform uses MySQL as the backing data store for ZODB, as well as directly to store events and user sessions. More information on MySQL can be found here: |
| Table sizes | MySQL Database | This tuning item provides information about the total size and number of tables in each MySQL instance configured for Zenoss platform. MySQL is a third-party open-source relational database. Zenoss uses MySQL as the backing data store for ZODB, as well as directly to store events and user sessions. More information on MySQL can be found here: http://www.mysql.com/
MySQL is a third-party, open-source relational database. Zenoss platform uses MySQL as the backing data store for ZODB, as well as directly to store events and user sessions. More information on MySQL can be found here: |
| Table fragmentation | MySQL Database | If the mysqltuner.pl script recommends de-fragmenting the tables in a MySQL instance, then an ERROR level tuning event is generated.
MySQL is a third-party, open-source relational database. Zenoss platform uses MySQL as the backing data store for ZODB, as well as directly to store events and user sessions. More information on MySQL can be found here: |
| Thread cache | MySQL Database | If the mysqltuner.pl script recommends increasing the number of threads cached for reuse by MySQL, then an ERROR level tuning event will be generated. More information on the thread_cache_size configuration setting can be found here: http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_thread_cache_size
MySQL is a third-party, open-source relational database. Zenoss platform uses MySQL as the backing data store for ZODB, as well as directly to store events and user sessions. More information on MySQL can be found here: |
| Version | rabbitmq | |
| Hub | Hubs | |
| zenhub workers | Hubs | |
| Check interval | Zope | |
| Object cache | Zope | |
| RelStorage cache | Zope | |
| Pool size | Zope | |
| Cache servers | Zope | |
| Maximum number of session objects | Zope | |
| Debug mode | Zope | |
| Application server processes | Zope | |
| Application server threads | Zope | |
| Request latency | Zope |
Daemons
| Type | Name |
|---|---|
| Performance Collector | zentune |