Filter
Top Products
12-33
Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide
OL-27477-07
Chapter 12 Configuring Call Home for the Cisco CSR 1000V
Configuring Diagnostic Signatures
Other than using EEM to detect events, a DS is triggered when a Tool Command Language (Tcl)
script is used to specify event detection types.
Multiple Event Detection
Multiple event detection involves defining two or more event detectors, two ore more corresponding
tracked object states, and a time period for the events to occur. The specification format for multiple
event detection can include complex event correlation for tracked event detectors. For example, three
event detectors (syslog, OIR, and IPSLA) are defined during the creation of a DS file. The correlation
that is specified for these event detectors is that the DS will execute its action if both syslog and OIR
events are triggered simultaneously, or if IPSLA is triggered alone.
Diagnostic Signature Actions
The diagnostic signature (DS) file consists of various actions that must be initiated when an event occurs.
The action type indicates the kind of action that will be initiated in response to a certain event.
Variables are elements within a DS that are used to customize the files.
DS actions are categorized into the following four types:
• call-home
• command
• emailto
• script
DS action types call-home and emailto collect event data and send a message to call-home servers or to
the defined email addresses. The message uses “diagnostic-signature” as its message type and DS ID as
the message sub-type.
The commands defined for the DS action type initiate CLI commands that can change configuration of
the device, collect show command outputs, or run any EXEC command on the device. The DS action
type script executes Tcl scripts.
Diagnostic Signature Variables
Variables are referenced within a DS and are used to customize the DS file. All DS variable names have
the prefix ds_ to separate them from other variables. The following are the supported DS variable types:
• System variable: variables assigned automatically by the device without any configuration changes.
The Diagnostic Signatures feature supports two system variables: ds_hostname and ds_signature_id.
• Environment variable: values assigned manually by using the environment variable-name
variable-value command in call-home diagnostic-signature configuration mode. Use the show
call-home diagnostic-signature command to display the name and value of all DS environment
variables. If the DS file contains unresolved environment variables, this DS will stay in pending
status until the variable gets resolved.
• Prompt variable: values assigned manually by using the call-home diagnostic-signature install
ds-id command in privileged EXEC mode. If you do not set this value, the status of the DS indicates
pending.
• Regular expression variable: values assigned from a regular expression pattern match with
predefined CLI command outputs. The value is assigned during the DS run.