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

5.1 Configuration Properties

VERSION 9  Click to view document history
Created on: Oct 27, 2010 1:32 PM by Zenoss API - Last Modified:  Oct 27, 2010 1:49 PM by Zenoss API

 1. Configuration Properties

Configuration properties are individual values you can set up on major system entities, such as:

  • Devices

    Device configuration properties control the way devices are monitored.

  • Events

    Event configuration properties control the rules that process events as they are received by the system.

  • Networks

    Network configuration properties control options when you perform network discovery.

Configuration properties and values can be added to the ZenPacks you create, allowing you to customize the system when you add ZenPacks.

 1.1. Configuration Properties Inheritance and Override

The following diagram illustrates a portion of the 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

Device Class Hierarchy

At the root of the device hierarchy is the Devices object. All device class configuration properties are defined here. Their values are the default values for the entire hierarchy.

The illustration shows two defined configuration properties:

  • 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 configuration property further down the hierarchy without having to change the definitions of other configuration properties. 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)

Device Class Hierarchy - Locally Defined Value (Override)

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.

Configuration properties 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

Device Class Hierarchy - Value Set on Device

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. Viewing Properties from the User Interface

This section further illustrates the characteristics of configuration properties from the user interface perspective. The following screen shows device configuration properties defined at the root level. To view configuration properties:

  1. Select Infrastructure from the navigation bar.

    The Devices page appears.

  2. Click Details.

  3. Select Configuration Properties.

 

Figure 5.4. Defined Device Configuration Properties - Root Level

Defined Device Configuration Properties - Root Level

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

 

Figure 5.5. zCollectorClientTimeout Configuration Property - Local Value Set

zCollectorClientTimeout Configuration Property - Local Value Set

To remove the override and once again inherit the value from the root of the hierarchy, go to the Delete Local Property area (located at the bottom of the page), select the overridden property, and then click Delete.

 

Figure 5.6. Delete Local Property

Delete Local Property

 1.2. Configuration Property Types

Configuration properties can be one of these types:

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

  • Integer - Whole number

  • Float - Number that can have a decimal value

  • Boolean - True or False

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

 1.3. Device Configuration Properties

To view and edit device configuration properties at the root level:

  1. Select Infrastructure from the navigation bar.

  2. In the tree view, click Details.

  3. Select Configuration Properties.

To view and edit device configuration properties set at a specific device class, navigate to that class, click Details, and then select Configuration Properties.

You also can view and edit device configuration at the individual device level. Select the device from the device list, and then select Configuration Properties from the left panel.

The following table lists device configuration properties.

 

Table 5.1. Device Configuration Properties

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 all modeler 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 logins and SSH.
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 and SSH.
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.
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 SSH key for device access.
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 the 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 the SNMP collection daemons when querying information. Some devices have small buffers for handling this information so the number should be lowered.
zPingMonitorIgnoreBooleanWhether or not to ping the device.
zProdStateThresholdintProduction state threshold at which Zenoss will begin to monitor a device.
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 "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 string 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, v2c, v3
zStatusConnectTimeoutfloatThe amount of time that the zenstatus daemon should wait before marking an IP service down.
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. The higher the number, the lower the severity. (1 is most severe; 5 is least severe.)
zWinPasswordstringThe password used to remotely login if it is a Windows machine.
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.4. Event Configuration Properties

To view and edit event configuration properties at the root level:

  1. Select Events from the navigation bar, and then select Event Classes.

  2. In the left panel, select Configuration Properties.

To view and override event configuration properties for a specific event class, navigate to that class, and then select Configuration Properties.

The following table lists event configuration properties.

 

Table 5.2. Event Configuration Properties

Property NameProperty TypeDescription
zEventActionstringSpecifies the database table 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 events from this class. Possible values are 0 – 5.

 1.5. Network Configuration Properties

To view and edit network configuration properties, select Infrastructure, and then select Networks. The Networks page appears.

 

Figure 5.7. Networks

Networks

You can view and change network configuration property values and inheritance selections in the Configuration Properties area.

The following table lists network configuration properties.

 

Table 5.3. Network Configuration Properties

Property NameProperty TypeDescription
zAutoDiscoverBooleanSpecifies whether zendisc should perform auto-discovery on this network.
zDefaultNetworkTreelinesA network subnet is automatically created for each modeled device, based on that device's subnet mask setting. To create higher-level subnets automatically from the discovery and modeling processes, add the specific subnet mask breakpoints. For example: 8, 16. If you then model a device with, for example, an IP address of 192.168.0.1, and a subnet mask of 255.255.255.0 (corresponding to a /24 subnet), device discovery will create a 192.0.0.0/8 network containing 192.168.0.0/16, containing 192.168.0.0/24, containing your device.
zDrawMapLinksBooleanCalculating network links "on the fly" is resource-intensive. If you have a large number of devices that have been assigned locations, then drawing those map links may take a long time. You can use this property to prevent the system from drawing links for specific networks (for example, a local network comprising many devices that you know does not span multiple locations).
zIconstringUse to specify device icons that appear on the device status page, Dashboard, and network map.
zPingFailThreshintSpecifies the number of pings sent without being returned before zendisc removes the device.


Comments (0)