Cisco Systems CSR 1000V manual Diagnostic Signature Actions, Diagnostic Signature Variables, 12-33

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-namevariable-valuecommand in call-home diagnostic-signature configuration mode. Use the show call-homediagnostic-signaturecommand 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-homediagnostic-signature install ds-idcommand 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.

	Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide
OL-27477-07		12-33