Feedback
Table Of Contents
clear mediatrace incomplete-sessions
frequency (session parameters)
mediatrace profile perf-monitor
metric-list (monitoring profile)
response-timeout (session parameters)
show mediatrace flow-specifier
show mediatrace path-specifier
show mediatrace profile system
show mediatrace profile perf-monitor
show mediatrace responder app-health
show mediatrace responder sessions
show mediatrace session-params
Cisco MediaTrace Commands
admin-params
To configure adminitrator parameters for a Mediatrace performance monitoring profile, use the admin-params command in monitoring profile configuration mode. To return to the default setting, use the no form of this command.
admin-params
no admin-params
Syntax Description
This command has no arguments or keywords.
Command Modes
Monitoring profile configuration (config-mt-prof-perf)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
This command enters admin parameters configuration mode and enables you to configure administrator parameters for a performance monitoring profile. You can configure the sampling interval.
Examples
The following example shows how to configure administrator parameters for a performance monitoring profile:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# admin-paramsRouter(config-mt-prof-perf-params)#sampling-interval 10Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
clear mediatrace incomplete-sessions
To clear ongoing Mediatrace polls, use the clear mediatrace incomplete-sessions command in privileged EXEC mode.
clear mediatrace incomplete-sessions
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
This command clears ongoing Mediatrace polls. This command must be entered in different session.
Examples
The following example clears incomplete Mediatrace sessions:
Router# clear mediatrace incomplete-sessionsRelated Commands
clock-rate (RTP parameters)
To configure the clock rate for samples taken of Real-Time Transport Protocol (RTP) metrics for a Mediatrace performance monitoring profile, use the clock-rate command in RTP parameters configuration mode. To return to the default setting, use the no form of this command.
clock-rate {type-number | type-name | default} rate
no clock-rate {type-name | default}
Syntax Description
Command Default
The clock rate is set to 96000 Hz
Command Modes
RTP parameters configuration (config-mt-prof-perf-rtp-params)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
Each payload type has a specific clock rate associated with it. However, because the clock rate can vary depending on the payload codec type, a keyword is provided to set the expected clock rate.
The available values for type-name and type-number are celb (25), cn (13), dvi4 (5) (8000 Hz as described in RFC 3551, RTP Profile for Audio and Video Conferences with Minimal Control), dvi4-2 (6) (8000 Hz as described in RFC 3551), dvi4-3 (16) (DVI4 Dipol 11025 Hz), dvi4-4 (17) DVI4 Dipol 22050 Hz), g722 (9), g723 (4), g728 (15), g729 (18), gsm (3), h261 (31), h263 (34), jpeg (26), l16 (11) (L16 channel 1), l16-2 (10) (L16 channel 2), lpc (7), mp2t (33), mpa (14), mpv (32), nv (28), pcma (8), pcmu (0), qcelp (12).
Examples
The following example shows how to configure the clock rate for a performance monitoring profile:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# metric-list rtpRouter(config-mt-prof-perf-rtp-params)#clock-rate gsm 10000Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
dest-ip (flow)
To configure the IP address of the destination node for the flow, use the dest-ip command in flow configuration mode. To remove the configuration for the destination node, use the no form of this command.
dest-ip ip-address dest-port port
no dest-ip ip-address
Syntax Description
ip-address
IP address of the destination node for the flow.
dest-port port
Specifies the port number of the destination node for the flow.
Defaults
No destination node for the flow is configured.
Command Modes
Flow configuration (config-mt-flowspec)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
When specifying the IP address of the destination node for the flow, you must also specify the port number.
Examples
The following example shows how to configure the IP address of the destination node for the flow:
Router(config)# mediatrace flow-specifier flow-4Router(config-mt-flowspec)# dest-ip 10.10.10.4 dest-port 4800Related Commands
frequency (session parameters)
To configure the interval between samples taken of metrics, use the frequency command in session parameters configuration mode. To return to the default setting, use the no form of this command.
frequency {frequency | on-demand} inactivity-timeout seconds
no frequency
Syntax Description
Command Default
The frequency is set to 120 seconds
The inactivity-timeout is set to 360 seconds.Command Modes
Session parameters configuration (config-mt-sesparam)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The value of the inactivity-timeout should be three times the value of the frequency.
Examples
The following example shows how to configure the frequency for a session parameters:
Router(config)# mediatrace session-params sess-4Router(config-mt-sesparam)# frequency 20 inactivity-timeout 20Related Commands
history (session parameters)
To configure the number of history buckets retained for metrics collected for a Mediatrace session, use the history command in session parameters configuration mode. To return to the default setting, use the no form of this command.
history data-sets-kept buckets
no history data-sets-kept
Syntax Description
data-sets-kept buckets
Number of history buckets retained. The default is 3. The maximum value is 10.
Command Default
The number of history buckets retained is set to three.
Command Modes
Session parameters configuration (config-mt-sesparam)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The maximum number of history buckets allowed is 10.
Examples
The following example shows how to configure the number of history buckets retained for a session parameters:
Router(config)# mediatrace session-params sess-4Router(config-mt-sesparam)# history data-sets-kept 1Related Commands
ip-protocol (flow)
To specify which metrics are monitored for a Mediatrace flow-specifier or path-specifier profile, use the ip-protocol command in flow configuration mode. To return to the default setting, use the no form of this command.
ip-protocol {tcp | udp}
no ip-protocol
Syntax Description
Command Default
The UDP metrics are monitored.
Command Modes
Flow configuration (config-mt-flowspec)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no protocol is specified, UDP metrics are monitored.
Examples
The following example shows how to specify that UDP metrics are monitored for a flow-specifier profile:
Router(config)# mediatrace flow-specifier flow-4Router(config-mt-flowspec)# ip-protocol tcpRelated Commands
max-dropout
To configure the maximum number of dropouts allowed when sampling Real-Time Transport Protocol (RTP) metrics for a Mediatrace performance monitoring profile, use the max-dropout command in RTP parameters configuration mode. To return to the default setting, use the no form of this command.
max-dropout number
no max-dropout
Syntax Description
Command Default
The maximum number of allowed dropouts is set to 10.
Command Modes
RTP parameters configuration (config-mt-prof-perf-rtp-params)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The definition of maximum dropouts is the maximum number of packets to ignore ahead the current packet in terms of sequence number.
Examples
The following example shows how to configure the maximum number of allowed dropouts for a performance monitoring profile:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# metric-list rtpRouter(config-mt-prof-perf-rtp-params)# max-dropout 4Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
max-reorder
To configure the maximum number of reorders allowed when sampling Real-Time Transport Protocol (RTP) metrics for a Mediatrace performance monitoring profile, use the max-reorder command in RTP parameters configuration mode. To return to the default setting, use the no form of this command.
max-reorder number
no max-reorder
Syntax Description
Command Default
The maximum number of allowed reorders is set to 5.
Command Modes
RTP parameters configuration (config-mt-prof-perf-rtp-params)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The definition of maximum rereorders is the maximum number of packets to ignore behind the current packet in terms of sequence number.The maximum value for the maximum number of allowed reorders is 20.
Examples
The following example shows how to configure the maximum number of allowed reorders for a performance monitoring profile:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# metric-list rtpRouter(config-mt-prof-perf-rtp-params)# max-reorder 4Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
mediatrace
To configure Mediatrace sessions, use the mediatrace command in global configuration mode. To remove Mediatrace sessions, use the no form of this command.
mediatrace session-number
no mediatrace session-number
Syntax Description
Command Default
No Mediatrace sessions are configured.
Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
This command enters Mediatrace session configuration mode and enables you to associate the following Mediatrace profile configurations with the session:
•
Path-specifier profile
•
•
•
•
Examples
The following example shows how to enter Mediatrace session configuration mode:
Router(config)# mediatrace 4Related Commands
mediatrace initiator
To enable the Mediatrace Initiator, use the mediatrace initiator command in global configuration mode. To disable the Mediatrace Initiator, use the no form of this command.
mediatrace initiator {source-ip ip-address | source-interface interface-name} [force] [max-sessions number]
no mediatrace initiator [force]
Syntax Description
Command Default
The Mediatrace Initiator is disabled.
When the Mediatrace Initiator is enabled, the maximum number of mediatrace sessions is set to 20.Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
Mediatrace Initiator is disabled by default. Therefore, no Mediatrace services are available until you issue this command for the Mediatrace Initiator. Before you can use Mediatrace, you must issue this command on one of the nodes in the media path and issue the mediatrace responder command on all nodes that you want to support Mediatrace.
Tip
You can also use this command to set the maximum sessions that can be started by the Mediatrace Initiator. The upper limit for the maximum number of mediatrace sessions is platform-dependant.
Examples
The following example shows how to enable the Mediatrace Initiator on the local interface with an IP address of 10.10.2.2:
Router(config)# mediatrace initiator source-ip 10.10.2.2Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
mediatrace responder
To enable the Mediatrace Responder, use the mediatrace responder command in global configuration mode. To disable the Mediatrace Responder, use the no form of this command.
mediatrace responder [max-sessions number]
no mediatrace responder
Syntax Description
Command Default
The Mediatrace Responder are disabled.
The maximum number of mediatrace sessions is set to 20.Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
Mediatrace Responder is disabled by default. Therefore, no Mediatrace services are available until you issue this command for the Mediatrace Responder. Before you can use Mediatrace, you must issue the mediatrace initiator command on one of the nodes in the media path and issue this command on all nodes that you want to support Mediatrace.
You can also use this command to set the maximum sessions that can be used by the Mediatrace Responder. The upper limit for the maximum number of mediatrace sessions is platform-dependant.
Examples
The following example shows how to enable the Mediatrace Responder on a node with an IP address of 10.10.10.4:
Router(config)# mediatrace responder max-sessions 12Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
mediatrace path-specifier
To configure the path-specifier profile for Mediatrace, use the mediatrace path-specifier command in global configuration mode. To remove the path specifier profile, use the no form of this command.
mediatrace path-specifier name [disc-proto rsvp] destination-ip ip-address [port number]
no mediatrace path-specifier name
Syntax Description
Command Default
No path-specifier profile is configured.
Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
After using this command to enter path configuration mode, you can configure the source address and port of the path.
You can associate a path-specifier profile with one or more actual Mediatrace sessions when they are configured.
Examples
The following example shows how to configure a path-specifier profile with a destination address of 10.10.2.8:
Router(config)# mediatrace path-specifier path-2 destination ip 10.10.2.8Related Commands
mediatrace poll
To perform an on-demand fetch of data, use the mediatrace poll command in privileged EXEC mode.
mediatrace poll {session number | {[timeout value] path-specifier {name path-name} | [disc-proto rsvp] destination ip-address [port number]} [source ip-address [port number]] [ip-protocol {tcp | udp}] } {app-health | hops | system [profile system-profile-name] | [configless] perf-monitor [profile profile-name]} {flow-specifier name | source-ip ipaddress source-port number dest-ip ipaddress dest-port numbern ip-protocol {tcp | udp}}}
Syntax Description
Command Default
The timeout is 60 seconds.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
For existing Performance Monitor profiles, the minimum value of the timeout allowed will depend on the sampling-interval configured in profile. If default perf-monitor profile is used then default value of sampling-interval is 30 second so minimum timeout value is 60 seconds.
The following examples show some ways you can use the mediatrace poll command to perform an on-demand fetch of data from the hops on a specific path:
•
•
•
–
–
If Cisco Mediatrace is not collecting all of the data that you want:
•
•
•
Examples
Note
The following example shows how to fetch the default system metrics when the source IP address, source port, and destination port are not known. Cisco Mediatrace uses the best local IP address as source IP address to find which hops are using RSVP.
mediatrace poll path dest ip-address system
The following example shows how to fetch the default system metrics when the source and destination port numbers are not known. RSVP finds the hop between the specified source and destination.
mediatrace poll path source ip-address dest ip-address system
The following example shows how to fetch the default system metrics when the source and destination port numbers are known. RSVP finds the hop using this information.
mediatrace poll path source ip-address port number destination ip-address port number ip-protocol udp system
The following example shows how to fetch the default set of RTP metrics. Cisco Mediatrace uses the path parameters to discover hops and uses the inline flow specifier profile as a filter for Performance Monitor data.
mediatrace poll path source ip-address dest ip-address perf-monitor source-ip ip-address source-port number dest-ip ip-address dest-port number ip-protocol udp
The following example shows how to fetch the default set of TCP metrics. Cisco Mediatrace uses the path parameters to discover hops and uses the inline flow-specifier profile as a filter for Performance Monitor data.
mediatrace poll path source ip-address dest ip-address perf-monitor source-ip ip-address source-port number dest-ip ip-address dest-port number ip-protocol tcp
The following example shows how to fetch the default set of RTP metrics. Cisco Mediatrace uses the best local IP address as source IP address for finding hops on the path and uses the inline flow specifier profile as a filter for Performance Monitor data.
mediatrace poll path dest ip-address perf-monitor source-ip ip-address source-port number dest-ip ip-address dest-port number ip-protocol udp
The following example shows how to fetch the default set of TCP metrics. Cisco Mediatrace uses the best local IP address as source IP address for finding hops on the path and uses the inline flow-specifier profile as a filter for Performance Monitor data.
mediatrace poll path dest ip-address perf-monitor source-ip ip-address source-port number dest-ip ip-address dest-port number ip-protocol tcp
The following example shows how to fetch the default set of RTP metrics from an existing static policy configured on the Responders. This command does not configure the Performance Monitor, so for more information, see Configuring Performance Monitor. Cisco Mediatrace uses the path parameters to discover hops and use the inline flow specifier profile as a filter for Performance Monitor data.
mediatrace poll path source ip-address dest ip-address configless perf-monitor flow-specifier source ip-address port number dest ip-address port number ip-protocol udp
This example shows the output is produced by the following hops poll command:
mediatrace poll path-specifier source 10.10.130.2 destination 10.10.132.2 hopsStarted the data fetch operation.Waiting for data from hops.This may take several seconds to complete...Data received for hop 1Data received for hop 2Data fetch complete.Results:Data Collection Summary:Request Timestamp: 22:47:56.788 PST Fri Oct 29 2010Request Status: CompletedNumber of hops responded (includes success/error/no-record): 2Number of hops with valid data report: 2Number of hops with error report: 0Number of hops with no data record: 0Detailed Report of collected data:Number of Mediatrace hops in the path: 2Mediatrace Hop Number: 1 (host=responder1, ttl=254)Reachability Address: 10.10.12.3Ingress Interface: Gi0/1Egress Interface: Gi0/2Mediatrace Hop Number: 2 (host=responder2, ttl=253)Reachability Address: 10.10.34.3Ingress Interface: Gi0/1Egress Interface: Gi0/2Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
mediatrace profile perf-monitor
To configure a Mediatrace performance monitoring profile, use the mediatrace profile perf-monitor command in global configuration mode. To remove a performance monitoring profile, use the no form of this command.
mediatrace profile perf-monitor name
no mediatrace profile perf-monitor name
Syntax Description
Command Default
No Mediatrace performance monitoring profile is configured.
Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
After using this command to enter perf-prof configuration mode, you can configure the following optional parameters:
•
•
•
•
•
You can associate a performance monitoring profile with one or more actual Mediatrace sessions when they are configured.
Examples
The following example shows how to configure a performance monitoring profile:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# metric-list rtpRouter(config-mt-prof-perf-rtp-params)# clock-rate 84Router(config-mt-prof-perf-rtp-params)# max-dropout 2Router(config-mt-prof-perf-rtp-params)# max-reorder 4Router(config-mt-prof-perf-rtp-params)# min-sequential 2Router(config-mt-prof-perf-rtp-params)# exitRouter(config-mt-prof-perf)# admin-paramsRouter(config-mt-prof-perf-params)# sampling-interval 20Related Commands
mediatrace profile system
To configure a system-data monitoring profile, use the mediatrace profile system command in global configuration mode. To remove a system profile, use the no form of this command.
mediatrace profile system name
no mediatrace profile system name
Syntax Description
Command Default
No Mediatrace system-data profile is configured.
Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
After using this command to enter system-data profile configuration mode, you can configure which of the following types of system data are monitored:
•
•
•
You can associate a system-data monitoring profile with one or more actual Mediatrace sessions when they are configured.
Examples
The following example shows how to configure a sysem-data monitoring profile:
Router(config)# mediatrace profile system system-8Router(config-sys-prof)# metric-list CPU MEMORYRelated Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
mediatrace schedule
To configure when a Mediatrace session will occur, use the mediatrace schedule command in global configuration mode. To remove a Mediatrace schedule, use the no form of this command.
mediatrace schedule session ID [life {forever | seconds}] [start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss}] [ageout seconds] [recurring]
no mediatrace schedule session ID
Syntax Description
Command Default
No schedule is specified for the session and it is in the pending state.
Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Examples
The following example shows how to configure a session schedule that will start now and last 60 seconds:
Router(config)# mediatrace schedule 22 life 60 nowRelated Commands
mediatrace session-params
To configure session-parameters, use the mediatrace session-params command in global configuration mode. To remove the session-parameters configuration, use the no form of this command.
mediatrace session-params name
no mediatrace session-params name
Syntax Description
Command Default
No session-parameters profile is configured.
Command Modes
Global configuration (config)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
After using this command to enter session-parameters configuration mode, you can configure the following parameters:
•
•
•
•
•
You can associate a session-parameters profile with one or more actual Mediatrace sessions when they are configured.
Examples
The following example shows how to configure a session-parameters profile:
Router(config)# mediatrace session-params session-4Router(config-mt-sesparam)# frequency 20 inactivity-timeout 40Router(config-mt-sesparam)# history data-sets-kept 2Router(config-mt-sesparam)# response-timeout 20Router(config-mt-sesparam)# route-change reaction-time 4Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
metric-list (monitoring profile)
To specify monitoring parameters for a Mediatrace performance monitoring profile, use the metric-list command in monitoring profile configuration mode. To return to the default setting, use the no form of this command.
metric-list {tcp | rtp}
no metric-list {tcp | rtp}
Syntax Description
tcp
Configures monitoring parameters for TCP packets.
rtp
Configures monitoring parameters for Real-Time Transport Protocol (RTP) packets.
Command Default
The RTP metrics are monitored.
Command Modes
Monitoring profile configuration (config-mt-prof-perf)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
This command specifies whether TCP packet or RTP packet are monitored and enters monitoring parameters configuration mode for a performance monitoring profile. For RTP, you can configure the following parameters:
•
•
•
•
Examples
The following example shows how to configure monitoring parameters for RTP packets:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# metric-list rtpRouter(config-mt-prof-perf-rtp-params)# clock-rate 84Router(config-mt-prof-perf-rtp-params)# max-dropout 2Router(config-mt-prof-perf-rtp-params)# max-reorder 4Router(config-mt-prof-perf-rtp-params)# min-sequential 2Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
metric-list (system profile)
To specify which metrics are monitored for a Mediatrace system-data profile.use the metric-list command in system profile configuration mode. To return to the default setting, use the no form of this command.
metric-list {intf | cpu | memory}
no metric-list {intf | cpu | memory}
Syntax Description
intf
(Optional) Monitor interface metrics.
cpu
(Optional) Monitor CPU metrics.
memory
(Optional) Monitor memory metrics.
Command Default
The interface metrics are monitored.
Command Modes
System profile configuration (config-mt-prof-sys)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no metric list is specified, Interface metrics are monitored.
Examples
The following example shows how to specify that CPU metrics are monitored:
Router(config)# mediatrace profile system sp-4Router(config-mt-prof-sys)# metric-list cpuRelated Commands
min-sequential
To configure the minimum number of packets in a sequence used to classify a Real-Time Transport Protocol (RTP) flow for a Mediatrace performance monitoring profile, use the min-sequential command in RTP parameters configuration mode. To return to the default setting, use the no form of this command.
min-sequential number
no min-sequential number
Syntax Description
Command Default
The minimum number of packets in a sequence is set to 5.
Command Modes
RTP parameters configuration (config-mt-prof-perf-rtp-params)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The maximum value for the minimum number of packets in a sequence used to classify a RTP flow is 10.
Examples
The following example shows how to configure the minimum number of packets in a sequence used to classify a RTP flow for a performance monitoring profile:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# metric-list rtpRouter(config-mt-prof-perf-rtp-params)# min-sequential 4Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
path-specifier
To associate a Mediatrace path-specifier profile with a Mediatrace session, use the path-specifier command in session configuration mode. To remove the association, use the no form of this command.
path-specifier name
no path-specifier name
Syntax Description
Command Default
No path-specifier profile is configured.
Command Modes
Session configuration (config-mt-session)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
You can associate a path-specifier profile with one or more actual Mediatrace sessions.
Examples
The following example shows how to associate a Mediatrace path-specifier profile to a Mediatrace session:
Router(config)# mediatrace 4Router(config-mt-session)# path-specifier ps-4Related Commands
profile perf-monitor
To associate a performance monitoring profile and a flow-specifier profile with a Mediatrace session, use the profile perf-monitor command in session configuration mode. To remove the association, use the no form of this command.
profile perf-monitor pm-name flow-specifier fs-name
no profile perf-monitor pm-name flow-specifier fs-name
Syntax Description
Command Default
No performance monitoring profile is configured.
Command Modes
Session configuration (config-mt-session)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
You can associate a performance monitoring profile with one or more actual Mediatrace sessions.
Examples
The following example shows how to associate a Mediatrace performance monitoring profile to a Mediatrace session:
Router(config)# mediatrace 4Router(config-mt-session)# profile perf-monitor pm-4 flow-specifier fs-2Related Commands
profile system
To associate a Mediatrace system profile to a Mediatrace session, use the profile system command in session configuration mode. To remove the association, use the no form of this command.
profile system name
no profile system name
Syntax Description
Command Default
No system profile is configured.
Command Modes
Session configuration (config-mt-session)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
You can associate a system profile with one or more actual Mediatrace sessions.
Examples
The following example shows how to associate a Mediatrace system profile to a Mediatrace session:
Router(config)# mediatrace 4Router(config-mt-session)# profile system sprofile-4Related Commands
response-timeout (session parameters)
To configure the number of seconds the Mediatrace Initiator will wait for the Responder to provide metrics, use the response-timeout command in session parameters configuration mode. To return to the default setting, use the no form of this command.
response-timeout seconds
no response-timeout seconds
Syntax Description
seconds
The number of seconds the Mediatrace Initiator will wait for the Responder to provide metrics.
Command Default
The response-timeout is set to 60 seconds.
Command Modes
Session parameters configuration (config-mt-sesparam)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The maximum value for the response-timeout is 65535 seconds. The response timeout should be less than the frequency.
Examples
The following example shows how to configure the response-timeout for a session parameters:
Router(config)# mediatrace session-params sess-4Router(config-mt-sesparam)# response-timeout 20Related Commands
route-change reaction-time
To configure the number of seconds the Mediatrace Initiator will wait for a response to a route change notification, use the route change command in session parameters configuration mode. To return to the default setting, use the no form of this command.
route-change reaction-time seconds
no route-change reaction-time seconds
Syntax Description
seconds
Number of seconds the Mediatrace Initiator will wait for a response to a route change notification.
Command Default
The route change reaction time is set to 5 seconds.
Command Modes
Session parameters configuration (config-mt-sesparam)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The maximum value for the route change reaction time is 60 seconds.
Examples
The following example shows how to configure the route change reaction time for a session parameters:
Router(config)# mediatrace session-params sess-4Router(config-mt-sesparam)# route-change reaction-time 20Related Commands
sampling-interval
To configure the interval, in seconds, between samples taken of metrics for a Mediatrace performance monitoring profile, use the sampling-interval command in admin parameters configuration mode. To return to the default setting, use the no form of this command.
sampling-interval seconds
no sampling-interval seconds
Syntax Description
Command Default
The sampling interval is set to 30 minutes.
Command Modes
Admin parameters configuration (config-mt-prof-perf-params)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
The sampling interval can set to a maximum of 30 minutes.
Examples
The following example shows how to configure the sampling interval for a performance monitoring profile:
Router(config)# mediatrace profile perf-monitor v-mon-4Router(config-mt-prof-perf)# admin-paramsRouter(config-mt-prof-perf-params)#sampling-interval 10Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
session-params
To associate a Mediatrace session-params profile to a Mediatrace session, use the session-params command in session configuration mode. To remove the association, use the no form of this command.
session-params name
no session-params name
Syntax Description
Command Modes
Session configuration (config-mt-session)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
You can associate a session-params profile with one or more actual Mediatrace sessions.
Examples
The following example shows how to associate a Mediatrace session-params profile to a Mediatrace session:
Router(config)# mediatrace 4Router(config-mt-session)# session-params sp-4Related Commands
show mediatrace flow-specifier
To display the parameters configured for flow-specifier profiles, use the show mediatrace flow-specifier command in privileged EXEC mode.
show mediatrace flow-specifier [name]
Syntax Description
Command Default
All flow-specifier profiles are displayed.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no flow-specifier profile name is entered with this command, all profiles are displayed.
Examples
The following example displays flow-specifier profiles:
Router# show mediatrace flow-specifier flow-1Flow Specifier: flow-1Source address/port:Destination address/port:Protocol: udpTable 8 describes the significant fields shown in the display.
Related Commands
show mediatrace initiator
To display the parameters configured for the Mediatrace Initiator profile, use the show mediatrace initiator command in privileged EXEC mode.
show mediatrace initiator
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
There is only one Mediatrace Initiator profile that can be displayed.
Examples
The following example displays the Mediatrace Initiator profile:
Router# show mediatrace initiatorVersion: Mediatrace 1.0Mediatrace Initiator status: enabledSource IP: 1.1.1.1Number of Maximum Allowed Active Session: 127Number of Configured Session: 1Number of Active Session : 0Number of Pending Session : 0Number of Inactive Session : 1Note: the number of active session may be higher than max active sessionbecause the max active session count was changed recently.Table 9 describes the significant fields shown in the display.
Related Commands
show mediatrace path-specifier
To display the parameters configured for path-specifier profiles, use the show mediatrace path-specifier command in privileged EXEC mode.
show mediatrace path-specifier [name]
Syntax Description
Command Default
All path-specifier profiles are displayed.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no path-specifier profile name is entered with this command, all profiles are displayed.
Examples
The following example displays path-specifier profiles:
Router# show mediatrace path-specifier flow-1Path Configuration: ps1Destination address/port: 10.10.10.1Source address/port: 10.10.10.4Gateway address/vlan:Discovery protocol: rsvpTable 12 describes the significant fields shown in the display.
Related Commands
show mediatrace profile system
To display the parameters configured for system-data profiles, use the show mediatrace profile system command in privileged EXEC mode.
show mediatrace profile system [name]
Syntax Description
Command Default
All system-data profiles are displayed.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no system-data profile name is entered with this command, all profiles are displayed.
Examples
The following example displays system-data profiles:
Router# show mediatrace profile systemSystem Profile: sys-1Metric List: intfTable 11 describes the significant fields shown in the display.
Table 11 show mediatrace profile system Field Descriptions
System Profile
Name assigned to the profile.
Metric List
Whether metrics are collected for interfaces, CPUs, or memory.
Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
show mediatrace profile perf-monitor
To display the parameters configured for performance monitoring profiles, use the show mediatrace profile perf-monitor command in privileged EXEC mode.
show mediatrace profile perf-monitor [name]
Syntax Description
Command Default
All performance monitoring profiles are displayed.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no performance monitoring profile name is entered with this command, all profiles are displayed.
Examples
The following example displays performance monitoring profiles:
Router# show mediatrace profile perf-monitorPerf-monitor Profile: vprof-4Metric List: rtpRTP Admin Parameter:Max Dropout: 5Max Reorder: 5Min Sequential: 5Admin Parameter:Sampling Interval (sec): 30Table 12 describes the significant fields shown in the display.
Related Commands
mediatrace profile perf-monitor
Configures Mediatrace performance monitoring profiles.
show mediatrace responder app-health
To display application health information for the Mediatrace Responder, use the show mediatrace responder app-health command in privileged EXEC mode.
show mediatrace responder app-health
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Examples
The following example displays application health information for the Mediatrace Responder:
Router# show mediatrace responder app-healthMediatrace App-Health Stats:Number of all requests received: 0Time of the last request received:Initiator ID of the last request received: 0Requests dropped due to queue full: 0Responder current max sessions: 45Responder current active sessions: 0Session down or tear down requests received: 0Session timed out and removed: 0HOPS requests received: 0VM dynamic polling requests received: 0VM dynamic polling failed: 0VM configless polling requests received: 0VM configless polling failed: 0SYSTEM data polling requests received: 0SYSTEM data polling requests failed: 0APP-HEALTH polling requests received: 0Route Change or Interface Change notices received: 0Last time Route Change or Interface Change:Unknown requests received: 0Table 13 describes the significant fields shown in the display.
Related Commands
show mediatrace responder sessions
To display session information for the Mediatrace Responder, use the show mediatrace responder sessions command in privileged EXEC mode.
show mediatrace responder sessions [global-session-id | brief | details]
Syntax Description
Command Default
The detailed session information is displayed for the Mediatrace Responder
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no session ID is entered with this command, inforamtion for all sessions is displayed.
Examples
The following example displays brief session information for the Mediatrace Responder:
Router# show mediatrace responder sessions briefLocal Responder configured session list:Current configured max sessions: 45Current number of active sessions: 0session-id initiator-name src-ip src-port dst-ip dst-port det-l2 host-18 10.10.10.2 200 10.10.10.8 200Table 14 describes the significant fields shown in the display.
Related Commands
show mediatrace session
To display information for Mediatrace sessions, use the show mediatrace session command in privileged EXEC mode.
show mediatrace session [config | data | hops | stats]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
You must have at least one active session before most session information can be displayed.
Examples
The following example displays session configuration information:
Router# show mediatrace session configSession Index: 1Global Session Id: 0---------------------------Session Details:Path-Specifier: ps1Session Params: sp1Collectable Metrics Profile: s1Flow Specifier: fs1Schedule:Operation frequency (seconds): 120 (not considered if randomly scheduled)Next Scheduled Start Time: Pending triggerGroup Scheduled : FALSERandomly Scheduled : FALSELife (seconds): 3600Entry Ageout (seconds): neverRecurring (Starting Everyday): FALSEStatus of entry (SNMP RowStatus): notInServiceTable 16 describes the significant fields shown in the display.
Related Commands
show mediatrace session-params
To display the parameters configured for Mediatrace sessions, use the show mediatrace session-params command in privileged EXEC mode.
show mediatrace session-params [name]
Syntax Description
Command Default
All session profiles are displayed.
Command Modes
Privileged EXEC (#)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
If no session profile name is entered with this command, all profiles are displayed.
Examples
The following example displays session profiles:
Router# show mediatrace session-paramsSession Parameters: s-1Response timeout (sec): 60Frequency: On DemandInactivity timeout (sec): 300History statistics:Number of history buckets kept: 3Route change:Reaction time (sec): 5Table 16 describes the significant fields shown in the display.
Related Commands
source-ip (flow)
To configure the IP address of the source node for the flow, use the source-ip command in flow configuration mode. To remove the configuration for the source node, use the no form of this command.
source-ip ip-address [source-port port]
no source-ip ip-address [source-port port]
Syntax Description
ip-address
IP address of the source node for the flow.
source-port port
Port number of the source node for the flow.
Command Modes
Flow configuration (config-mt-flowspec)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
When specifying the IP address of the source node for the flow, the port number is optional.
Examples
The following example shows how to configure the IP address of the source node for the flow:
Router(config)# mediatrace flow-specifier flow-4Router(config-mt-flowspec)# source-ip 10.10.10.4Related Commands
source ip (path)
To configure the IP address of the source node for the path, use the source-ip command in path configuration mode. To remove the configuration for the source node, use the no form of this command.
source ip ip-address [port port]
no source ip ip-address [port port]
Syntax Description
ip-address
IP address of the source node for the path.
port port
Port number of the source node for the path.
Command Modes
Path configuration (config-mt-path)
Command History
15.1(3)T
This command was introduced.
12.2(58)SE
This command was integrated into Cisco IOS Release 12.2(58)SE.
Usage Guidelines
When specifying the IP address of the source node for a path, the port number is optional.
Examples
The following example shows how to configure the IP address of the source node for the path:
Router(config)# mediatrace path-specifier path-4Router(config-mt-path)# source ip 10.10.10.4Related Commands
