Archived community.zenoss.org | full text search
Skip navigation
Currently Being Moderated

5.1 zProperties

VERSION 2  Click to view document history
Created on: Sep 14, 2009 11:40 AM by Zenoss API - Last Modified:  Sep 14, 2009 5:51 PM by John Hamilton

#1. zProperties

zProperties are individual values that exist on the major configuration organizers in the system:

  • Device classes

    Device class zProperties control the way monitoring is gathered from devices after they have been added to the system.

  • Networks

    Network zProperties control the way Zenoss performs auto-discovery.

  • Events

    Event zProperties control the rules that process events as they are added to the system.

  • Services and processes

    Service and process zProperties describe how operating system components are monitored by the Zenoss monitoring daemons.

zProperties can be configured for:

  • All items

  • Single devices

  • Multiple devices in the device hierarchy

zProperties settings can be added to any ZenPacks you create, allowing you to add customized zProperties to the system when you add ZenPacks.

#1.1. zProperties Inheritance and Override

The following diagram illustrates a portion of Zenoss' standard device class hierarchy. (A device class is a special type of organizer used to manage how the system models and monitors devices.)

#

Figure 5.1. Device Class Hierarchy

deviceclasstree2.png

At the root of the device hierarchy is the Devices object. All device class zProperties are defined here, and their values are the default values for the entire hierarchy.

The illustration further shows two defined zProperties:

  • zWmiMonitorIgnore - Turns off all daemons that use WMI. By default its value at the root of the hierarchy is False.

  • zSNMPMonitorIgnore - Turns off all daemons that use SNMP. By default, its value at the root of the hierarchy is True.

Through inheritance, properties defined at the root of the hierarchy apply to all objects beneath that node. So, at the /Devices/Server/Linux level of the device class hierarchy, the value of these two properties is the same as at /Devices, even though the property is not set explicitly at /Devices/Server/Linux. Inheritance simplifies system configuration, because default values set at the root level apply to all devices irrespective of their device class.

To further customize the system, you can change a specific zProperty further down the hierarchy without having to change the definitions of other zProperties. As shown in the following illustration, the value of zWmiMonitorIgnore is changed so that WMI monitoring is performed at the /Devices/Server/Windows level.

#

Figure 5.2. Device Class Hierarchy - Locally Defined Value (Override)

deviceclasstree3.png

This locally defined value for zWmiMonitorIgnore overrides the value set at the root of the hierarchy. No other properties at this level are affected by this local change; they continue to inherit the value set at the root.

zProperties allow you to configure the system at a very granular level, down to a particular device. For example, in the following illustration, the device named dev.zenoss.com has the value of SNMP community set to private. This overrides the root value (public).

#

Figure 5.3. Device Class Hierarchy - Value Set on Device

deviceclasstree4.png

If you change the SNMP Community value of dev.zenoss.com to public, it matches the value set at the root, but is still explicitly defined. Only if you remove the locally defined property does it again inherit the value of the property set at the root.

#1.1.1. User Interface View

This section further illustrates the characteristics of zProperties from the user interface perspective. The following screen shows zProperties defined at the root level.

#

Figure 5.4. Defined zProperties - Root Level

zPropertiesConfiguration.png

As shown in the previous screen, the zCollectorClientTimeout zProperty has a default value of 180. In the next screen, the value has been set to 170 at /Devices/Server/Linux, overriding the default value at this node of the hierarchy.

#

Figure 5.5. zCollectorClientTimeout zProperty - Local Value Set

zPropertiesConfiguration2.png

To then remove the override and once again inherit the value from the root of the hierarchy, go to the Delete Local Property area of the zProperties page.

#

Figure 5.6. Delete Local Property

zPropertiesConfiguration3.png

#1.2. zProperty Types

zProperties can be one of these types:

  • String - Text value that can be ASCII or Latin-1 encoded

  • Integer - Whole number

  • Float - Number that can has a decimal value

  • Boolean - True or false

  • Lines - List of values separated by a return. Zenoss stores these as an array.

#1.3. Event zProperties

To access Event zProperties, from the left navigation menu, select Event and click the zProperties tab. You can also set zProperties for any event class in the events hierarchy by navigating to the level in the event hierarchy where you want to set the zProperty and clicking the zProperties tab.

#

Table 5.1. Event zProperties

Property NameProperty TypeDescription
zEventActionstringSpecifies the location in which an event will be stored. Possible values are: status, history and drop. Default is status, meaning the event will be an “active” event. History sends the event directly to the history table. Drop tells the system to discard the event.
zEventClearClasseslinesLists classes that a clear event should clear (in addition to its own class).
zEventSeverityintOverrides the severity value of an event. If the value is -1, it is ignored. Possible values are 0 – 5.

#1.4. Device zProperties

To access Device zProperties, from the left navigational menu, select Devices and then click the zProperties tab. You can also select any of the Device Classes and the zProperties tab to set zProperties anywhere in the Device hierarchy. To set zProperties for an individual Device, navigate to that device, open the page menu, select the More option and then the zProperties tab.

#

Table 5.2. Device zProperties

Property NameProperty TypeDescription
zCollectorClientTimeoutintAllows you to set the timeout time of the collector client in seconds
zCollectorDecodingstringConverts incoming characters to Unicode.
zCollectorLogChangesBooleanIndicates whether to log changes.
zCollectorPluginslinesLinks to tall collector plugins for this device.
zCommandCommandTimeoutfloatSpecifies the time to wait for a command to complete.
zCommandCycleTimeintSpecifies the cycle time you use when executing zCommands for this device or organizer.
zCommandExistanceTeststring***
zCommandLoginTimeoutfloatSpecifies the time to wait for a login prompt.
zCommandLoginTriesintSets the number of times to attempt login.
zCommandPasswordstringSpecifies the password to use when performing command login.
zCommandPathstringSets the default path where ZenCommand plug-ins are installed on the local Zenoss box (or on a remote box where SSH is used to run the command).
zCommandPortintSpecifies the port to connect to when performing command collection.
zCommandProtocolstringEstablishes the protocol to use when performing command collection. Possible values are SSH and telnet.
zCommandSearchPathlinesSets the path to search for any commands.
zCommandUsernamestringSpecifies the user name to use when performing command collection.
zDeviceTemplateslinesSets the templates associated with this device. Linked by name.
zFileSystemMapIgnoreNamesstringSets a regular expression of file system names to ignore.
zFileSystemMapIgnoreTypeslinesDo not use.
zIconlinesSpecifies the icon to represent the device wherever device Icon is shown, such as on the network map and device status page. Most devices, including Windows servers, Linux servers, and routers, have images set by default.
zIfDescriptionBooleanShows the interface description field in the interface list.
zInterfaceMapIgnoreNamesstringFilters out interfaces that should not be discovered.
zInterfaceMapIgnoreTypesstringFilters out interface maps that should not be discovered.
zIpServiceMapMaxPortintSpecifies the highest port to scan. The default is 1024.
zKeyPathlinesSets the path to the key to access a device.

#

Table 5.3. Device zProperties

Property NameProperty TypeDescription
zLinkstextSpecifies a place to enter any links associated with the device.
zLocalInterfaceNamesstringRegular expression that uses interface name to determine whether the IP addresses on an interface should be incorporated into Zenoss' network map. For instance, a loopback interface "lo" might be excluded.
zLocalIpAddressesintSpecifies IP addresses that should be excluded from the network map (for example. 127.x addresses). If you have addresses that you reuse for connections between clustered machines they might be added here as well.
zMaxOIDPerRequestintSets the maximum number of OIDs to be sent by Zenoss' SNMP collection daemons when querying information. Some devices have small buffers for handling this information so the number should be lowered.
zPingInterfaceDescriptionstringA catalog query string that will find interfaces to be pinged by description.
zPingInterfaceNamestringA catalog query string that will find interfaces to be pinged by name.
zPingMonitorIgnoreBooleanWhether or not to ping the device.
zProdStateThresholdintProduction state threshold at which Zenoss will begin to monitor a device. Default of 500 equals Pre-Productions.
zPythonClassstringDO NOT USE
zRouteMapCollectOnlyIndirectBooleanOnly collect routes that are directly connected to the device.
zRouteMapCollectOnlyLocalBooleanOnly collect local routes. (These usually are manually configured rather than learned through a routing protocol.)
zSnmpAuthPasswordstringThe shared private key used for authentication. Must be at least 8 characters long.
zSnmpAuthTypestringUse either "MD5" or "SHA" signatures to authenticate SNMP requests
zSnmpCommunitieslinesArray of SNMP community strings that the ZenModeler will try to use when collecting SNMP information.
zSnmpCommunitystringCommunity to be used when collecting SNMP information. If it is different than what is found by ZenModeler, it will be set on the modeled device.
zSnmpMonitorIgnoreBooleanWhether or not to ignore monitoring SNMP on a device.
zSnmpPortintPort that the SNMP agent listens on.
zSnmpPrivPasswordstringThe shared private key used for encrypting SNMP requests. Must be at least 8 characters long.
zSnmpPrivTypestring"DES" or "AES" cryptographic algorithms.
zSnmpSecurityNamestringThe Security Name (user) to use when making SNMPv3 requests.
zSnmpTimeoutfloatTimeout time in seconds for an SNMP request
zSnmpTriesintAmount of tries to collect SNMP data
zSnmpVerstringSNMP version used. Valid values are v1, v2.

#

Table 5.4. Device zProperties

Property NameProperty TypeDescription
zStatusConnectTimeoutThe amount of time that the zenstatus daemon should wait before marking an IP service down.
zSysedgeDiskMapIgnoreNamesCurrently unused.
zTelnetEnableBooleanWhen logging into a Cisco device issue the enable command to enable access during command collection.
zTelnetEnableRegexstringRegular expression to match the enable prompt.
zTelnetLoginRegexstringRegular expression to match the login prompt.
zTelnetPasswordRegexstringRegular expression to match the password prompt.
zTelnetPromptTimeoutfloatTime to wait for the telnet prompt to return.
zTelnetSuccessRegexListlinesList of regular expressions to match the command prompt.
zTelnetTermLengthBooleanOn a Cisco device, set term length to Zero.
zWinEventlogBooleanWhether or not to send the log.
zWinEventlogMinSeverityintSets minimum severity to collect from the win event log. Important to note that the higher the number, the lover the severity. 1 being the most sever and 5 being the least severe.
zWinPasswordstringThe password used to remotely login if it is a Windows machine.
zWinServices
zWinUserstringUser name used to remotely login if it is a Windows machine.
zWmiMonitorIgnoreBooleanUse to turn on or off all WMI monitoring.
zXmlRpcMonitorIgnoreBooleanUse to turn on or off all XML/RPC monitoring.

#1.5. Service zProperties

To access Service zProperties, from the left navigation menu, select Services, and then click the zProperties tab. You can also access the Service zProperties tab anywhere in the services hierarchy by going to the level where you want to set the zProperty and clicking the zProperties tab.

#

Table 5.5. Service zProperties

Property NameProperty TypeDescription
zFailSeverityintDetermines what severity to send for the specified service.
zHideFieldsFromListlinesFields to hide from Services instance list
zMonitorBooleanTells whether or not to monitor a service.


#1.6. Process zProperties

To access Process zProperties, from the left navigation menu, select Processes, and then click the zProperties tab. You can also access the Process zProperties tab anywhere in the processes hierarchy by going to the level where you want to set the zProperty and clicking the zProperties tab.

#

Table 5.6. Process zProperties

Property NameProperty TypeDescription
zAlertOnRestartBooleanDetermines whether or not to send an event if the specified process is restarted.
zCountProcsintDetermines the number of instances of the process that are running.
zFailSeverityintDetermines what severity to send for the specified process.
zMonitorBooleanTells whether or not to monitor a process.


#1.7. Network zProperties

To access Network zProperties, from the left navigation menu, select Networks, and then click the zProperties tab. You can also access the zProperties tab for any sub-network that exists with in the Networks page.

#

Table 5.7. Network zProperties

Property NameProperty TypeDescription
zAutoDiscoverBooleanShould zendisc perform auto-discovery on this network
zDefaultNetworkTreelinesList of netmask numbers to use when creating network containers. Default is 24, 32 which will make /24 networks at the top level of the networks tree if a network us smaller than /24.
zPingFailThreshintNumber of pings to sent without being returned before Zendisc removes the device.


#1.8. Manufacturer zProperties

#

Table 5.8. Network zProperties

Property NameProperty TypeDescription
zDeviceClassstringReserved for future use.
zDeviceGroupstringReserved for future use.
zSystemstringReserved for future use.


Comments (0)