Diagnostic Signature Variables; How To Configure Diagnostic Signatures; Configuring The Call Home Service For Diagnostic Signatures - Cisco CSR 1000v Series Software Configuration Manual

How to Configure Diagnostic Signatures

• 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
• Environment variable: values assigned manually by using the environment variable-name variable-value
• Prompt variable: values assigned manually by using the call-home diagnostic-signature install ds-id
• Regular expression variable: values assigned from a regular expression pattern match with predefined
• Syslog event variable: values assigned during a syslog event detection in the DS file. This variable is
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.
Note 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.
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
260
Diagnostic Signatures feature supports two system variables: ds_hostname and ds_signature_id.
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.
command in privileged EXEC mode. If you do not set this value, the status of the DS indicates pending.
CLI command outputs. The value is assigned during the DS run.
valid only for syslog event detection.
Configuring Call Home for the Cisco CSR 1000v