The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Cisco IOS supports HTTP/s server, and Nginx acts as the front-end HTTP/s server. The web server enhancements feature includes serviceability enhancements that are needed for identifying the issues at the customer site. As part of the serviceability, log files collection is supported. Session management resiliency is also supported.
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Feature Name |
Releases |
Feature Information |
---|---|---|
Web Server Enhancements |
Cisco IOS XE Everest 16.6.1 Release |
Cisco IOS supports HTTP/s server, and Nginx acts as the front-end HTTP/s server. The web server enhancements feature includes serviceability enhancements that are needed for identifying the issues at the customer site. As part of the serviceability, log files collection is supported. Session management resiliency is also supported. This feature is supported on Cisco ASR 1000 Series Aggregation Services Routers, Cisco 4400 Series Integrated Services Routers, Cisco Cloud Services Routers 1000v Series, Catalyst 3650, and Catalyst 3850 Switching Platforms. |
After a configuration change, the session details are retained and re-authentication is not needed for web user interface.
Serviceability enhancements improve the debug ability of Nginx (HTTP server) by enabling btrace for Nginx debugs or logs. The default btrace log level is notice. Use the set platform software trace nginx R0 btrace command to change the log level for a particular module or all modules inside the Nginx process.
To modify the trace level to increase or decrease the amount of trace message output, you can set a new trace level using the set platform software trace nginx command. Trace levels can be set for each nginx process using the all-modules keyword in the set platform software trace nginx command, or per module within a process.
1.
enable
2.
set platform software trace nginx R0 all-modules {debug | emergency | error | info | noise | notice | verbose | warning}
3.
exit
1.
enable
2.
set platform software trace nginx R0 ngx_wsman {debug | emergency | error | info | noise | notice | verbose | warning}
3.
exit
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable
Example: Device> enable |
Enables privileged EXEC mode. | ||
Step 2 |
set platform software trace nginx R0 ngx_wsman {debug | emergency | error | info | noise | notice | verbose | warning}
Example: Device# set platform software trace nginx R0 ngx_wsman error |
Sets log level for a particular module or all modules inside the nginx process.
| ||
Step 3 |
exit
Example: Device# exit |
Exits privileged EXEC mode. |
The following example shows how to view the trace level of Nginx Webserver process for route processer slot 0:
Device# show platform software trace level nginx R0 Module Name Trace Level ----------------------------------------------- bipc Noise bsignal Noise btrace Noise cdllib Noise cdlutil Noise chasfs Noise evlib Noise evutil Noise mqipc Noise nginx Noise ngx_core Noise ngx_wsman Noise prelib Noise rsaios Noise services Noise syshw Noise tdl_aaa_common Noise tdl_aaa_proxy Noise tdl_cdlcore Noise tdl_ngxws Noise tdl_tps Noise tdl_ui Noise tdllib Noise tps-client Noise
The following example shows how to view the Nginx trace messages:
Device# show platform software trace message nginx R0 ................... 2017/05/18 00:38:06.809 [btrace] [23315]: UUID: 0, ra: 0, TID: 0 (debug): tracing initialized as module 482 --- DECODE 7319:7310:15 DONE --- 2017/05/18 00:38:06.809 [btrace] [23315]: UUID: 0, ra: 0, TID: 0 (note): Successfully registered module [482] [uiutil] 2017/05/18 00:38:06.809 [btrace] [23315]: UUID: 0, ra: 0, TID: 0 (debug): [BINOS_BTRACE_LEVEL_MODULE_UIUTIL] is not set 2017/05/18 00:38:06.809 [btrace] [23315]: UUID: 0, ra: 0, TID: 0 (info): Set default level for module [482] [uiutil] to [15]
Related Topic |
Document Title |
---|---|
Additional HTTP configuration information |
Using the Cisco Web Browser User Interface |
Additional HTTPS configuration information |
HTTPS - HTTP Server and Client with SSL 3.0 |
Additional HTTP and HTTPS commands |
Cisco IOS Network Management Command Reference |
Description |
Link |
---|---|
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies. To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds. Access to most tools on the Cisco Support website requires a Cisco.com user ID and password. |