•
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.
•
Syslog event variable: values assigned during a syslog event detection in the DS file. This variable is
valid only for syslog event detection.
How to Configure Diagnostic Signatures
Configuring the Call Home Service for Diagnostic Signatures
Configure the Call Home Service feature to set attributes such as the contact email address where notifications
related with diagnostic signatures (DS) are sent and destination HTTP/secure HTTP (HTTPS) URL to download
the DS files from.
You can also create a new user profile, configure correct attributes and assign it as the DS profile. For periodic
downloads, the request is sent out just following full inventory message. By changing the inventory periodic
configuration, the DS periodic download also gets rescheduled.
The predefined CiscoTAC-1 profile is enabled as a DS profile by default and we recommend using it. If
used, you only need to change the destination transport-method to the
http
setting.
Note
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
260
Configuring Call Home for the Cisco CSR 1000v
How to Configure Diagnostic Signatures