AutoNOC 2.5 User Guide
Preface
Acknowledgements
System Requirements
Legal

Part 1 - Introduction
1.1 The Ideal Difference
1.2 Automated Operations
1.3 Services & Scaler
1.4 Acquisition Stacks
1.5 Portal Deployment
1.6 Discovery and Crawler
1.7 Monitoring Agents
1.8 Recoiling Database
1.9 Multiple Languages
1.10 Security

Part 2 - NOC Views
2.1 Investigate
2.2 Observe
2.3 Visualize
2.4 Alarms
2.5 Analyze
2.6 Design
2.7 Configure

Part 3 - Model Design
3.1 Object Model
3.2 Devices
3.3 Sets
3.4 Set Criteria
3.5 Probes
3.6 Logs & Events
3.7 Alarms
3.8 Actions
3.9 Reports
3.10 Users
3.11 Polling
3.12 Service Levels
3.13 Dependencies
3.14 Performance

Part 4 - Developer Features
4.1 Adding SNMP MIBs
4.2 Variables
4.3 OSP API
4.4 Probe Template
4.5 Log Template
4.6 Device Template
4.7 Interface Template
4.8 Rebranding

Part 5 - Troubleshooting
5.1 General Issues
5.2 Linux
5.3 Windows

Appendix
A.1 OSP API Functions
A.2 Variables
A.3 Object Reference

4.4 Probe Template
AutoNOC probe templates define rules for the discovery, construction and data acquisition of probes that are a component of devices. For more information on devices see 3.2 - Devices. Probe templates in AutoNOC are defined under the Templates root tree item as shown in the following screenshot:

4.4.1 Discovery and Construction
When you discover a new device, AutoNOC takes the relevant probes (as defined by the device template being discovered) that have not been disabled and it tries to resolve each probe to see which ones work for the device and which ones do not.

In this process, each probe will attempt to discover as a child of an existing device component type if the component type is automatically constructed. If it is not an automatically constructed component (like a device interface) then AutoNOC will test to see if the probe works stand alone for the device and if it does, it will create the necessary category and component for it.

These settings can be customized for every probe as is shown in the following screen:

The Category field specifies which category under the device that the software will place the probe. The Component Type field specifies the type of component to create. The following is a table showing which probe templates auto-create categories and components as well as the ones that require an existing component to already be defined.

Interface
Storage
Processor
Main Memory
Service
Cable
Cable Modem
Environment
Requires an existing device component of this type.
Network
Application
Probe template creates a new component for the device.

Lastly, for probe templates that automatically create their own components, the Custom Component Name allows the user to specify a name for the component that it creates. Note also that a probe template that has been disabled will not be discovered on devices.

4.4.2 Database
Every probe and log utilizes AutoNOC's persistent, highly compressed database capability to store incoming acquired data. Log files store data as compressed text while probes have a variable ability to store data in many different formats. How each probe stores it's data is defined in the probe template and can be selected by changing the Internal Record Format field on the Expression tab of the probe template.

Supported record types include various forms of integers, floating point numbers, and text. Keep in mind that the format chosen will have an effect on how much space is used when storing the data for the probe.

For more information on AutoNOC's recoiling database architecture, see 1.8 - Recoiling Database. AutoNOC's recoiling database with data compression enables the maintenance of very large histories in a reasonable amount of disk space.

4.4.3 Graphing
Probe templates in AutoNOC also allow the user to specify how data should be graphed. The following screenshot shows the example setup of the Traffic In (Cisco) probe which computes incoming traffic to an interface on a Cisco specific device:

pic_probetemplate_traffic.png (62123 bytes)

Graph Minimum and Graph Maximum specify values that indicate the y-axis on graphs showing the data from this probe. If either field is left blank, then AutoNOC will compute the field automatically. Note that these are expressions evaluated at the scope of the probe and so your settings can be setup to vary dynamically.

The Display Format utilizes a sprintf C++ string formatting expression to display specific values with a label and to a certain precision. See any C++ manual for examples of how to author formatting expressions for use with AutoNOC.

By default, when the minimum and maximum ranges far exceed the range of the actual data being acquired then AutoNOC will zoom in and auto-scale the data (and display the maximum as text on the graph). Turn on No Graph Zoom to disable this feature. Display of the graph can also be disabled by turning off Show Graph.

4.4.4 Expression and Component Rule
Every probe has a data acquisition expression. This expression is solved, in parallel with other currently being solved expressions on the device, by the AutoNOC OSP Command Prompt. For a complete discussion of expression authoring in the interpreter see 4.3 - Interpreter.

The discussion in 1.4 - Acquisition Stacks is also very beneficial for understanding how exactly AutoNOC acquires data. When you click on the AutoNOC OSP Command Prompt button for an instance of a probe it will load the expression specified in the probe's template. This is helpful in debugging custom probe expressions and for authoring new ones.

Below the acquisition expression is a field entitled Component Rule. This expression is evaluated by the AutoNOC OSP Command Prompt. If the expression is TRUE (non-zero), then AutoNOC will hide the component that the instance probe is a child of.

4.4.5 Visualization
Some probes can also be visualized within AutoNOC. For instance, the Traffic Flow probe can be setup to actually show the direction of data flow on the network diagram live on the display. Visualization settings are available on the Visualize tab as shown in this screenshot:

The tab has two fields indicating the type of visualization to use for the probe and a 3-letter abbreviation that is used for display of the probe visualization.

(C) 2007 - All Rights Reserved - AutoNOC LLC
      Call me!