Cisco Cisco TelePresence Video Communication Server Expressway
Appendix 3: Message logging
You can monitor the policy request messages and responses that are exchanged between the VCS and the
policy service.
policy service.
The best way to do this is to use the diagnostic logging tool to capture these messages:
1. Go to
Maintenance > Diagnostics > Diagnostic logging
.
2. Optionally, select Take tcpdump while logging.
3. Click Start new log.
4. (Optional) Enter some Marker text and click Add marker.
l
The marker facility can be used to add comment text to the log file before certain activities are
performed. This helps to subsequently identify the relevant sections in the downloaded diagnostic log
file.
performed. This helps to subsequently identify the relevant sections in the downloaded diagnostic log
file.
l
You can add as many markers as required, at any time while the diagnostic logging is in progress.
l
Marker text is added to the log with a "DEBUG_MARKER" tag.
5. Reproduce the system issue you want to trace in the diagnostic log.
6. Click Stop logging.
7. Click Download log to save the diagnostic log to your local file system. You are prompted to save the file
(the exact wording depends on your browser).
8. If appropriate, click Download tcpdump to also download the tcpdump file to your local file system.
Trace example: Call Policy request and response
Example Call Policy request:
Jul 19 15:30:30 vcs tvcs: UTCTime="2011-07-19 15:30:30,616" Module="network.http"
Level="DEBUG": Message="Request" Method="POST" URL=" https://192.0.2.3/api/call_policy"
Ref="0x4945360"
Data="ALLOW_INTERWORKING=TRUE&AUTHENTICATED=FALSE&AUTHENTICATION_USER_NAME=&CLUSTER_
NAME=vcs_cluster&DESTINATION_ALIAS=alice%40example.com&GLOBAL_CALL_SERIAL_NUMBER=094f761
c-b21c-11e0-91a2-000c29e127de&LOCAL_CALL_SERIAL_NUMBER=094f754a-b21c-11e0-a091-000c29e127
de&METHOD=INVITE&NETWORK_TYPE=IPV4&POLICY_TYPE=ADMIN&PROTOCOL=SIP®ISTERED_ALIAS=bob%40
example.com&SOURCE_ADDRESS=192.0.2.100%3A5061&SOURCE_IP=192.0.2.100&SOURCE_PORT=5061&TRAV
ERSAL_TYPE=TYPE_UNDEF&UNAUTHENTICATED_SOURCE_ALIAS=bob%40example.com&UTCTIME=2011-07-19%2
015%3A30%3A30&ZONE_NAME=DefaultSubZone"
Example response:
Jul 19 15:30:30 vcs tvcs: UTCTime="2011-07-19 15:30:30,625" Module="network.http"
Level="DEBUG": Message="Response" Src-ip="192.0.2.3" Src-port="5000" Dst-ip="192.0.2.20
0" Dst-port="40010" Response="200 OK" ResponseTime="0.003416"
Body="<!-- policy server -->
<cpl xmlns="urn:ietf:params:xml:ns:cpl"
xmlns:taa="http://www.tandberg.net/cpl-extensions"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:ietf:params:xml:ns:cpl cpl.xsd">
<taa:routed> <proxy/> </taa:routed> </cpl> " Ref="0x4945360"
Trace example: Registration Policy request and response
Example Registration Policy request:
External Policy on Cisco VCS Deployment Guide (X8.1)
Page 26 of 29
Appendix 3: Message logging