Skip to content

Commit 0efd4bf

Browse files
committed
Minor clarifications
1 parent 0e63df9 commit 0efd4bf

2 files changed

Lines changed: 8 additions & 8 deletions

File tree

learn-pr/advocates/troubleshoot-optimize-internet-information-services/includes/1-introduction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This module treats troubleshooting and performance tuning as a single workflow:
1010

1111
This module teaches you about:
1212

13-
- **Failed Request Tracing (FREB):** Captures the full request pipeline with per-module timing, letting you pinpoint exactly where a request stalls or fails.
13+
- **Failed Request Tracing:** Captures the full request pipeline with per-module timing, letting you pinpoint exactly where a request stalls or fails. In older documentation and some elements of the UI, this is termed Failed Request Event Buffering (FREB).
1414
- **HTTP.sys error logs:** Show requests that the kernel-mode HTTP driver rejected *before* they ever reached a worker process.
1515
- **Performance Monitor counters:** Provide quantitative baselines and bottleneck identification for CPU, memory, disk, and request throughput.
1616
- **Tuning:** Covers application pool recycling, output caching, compression, and concurrency settings that directly impact production performance.

learn-pr/advocates/troubleshoot-optimize-internet-information-services/includes/2-logs-tracing.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -84,15 +84,15 @@ Correlate the timestamp and client IP from httperr.log with Event Viewer entries
8484

8585
## Failed Request Tracing (FREB)
8686

87-
Failed Request Tracing captures a detailed trace of the IIS request pipeline. Each trace records every module that processed the request, how long each module took, and where a failure or delay occurred. The output is written as XML files with XSLT stylesheets that you can open in a browser.
87+
Failed Request Tracing (also termed Failed Request Event Buffering (FREB)) captures a detailed trace of the IIS request pipeline. Each trace records every module that processed the request, how long each module took, and where a failure or delay occurred. The output is written as XML files with XSLT stylesheets that you can open in a browser.
8888

89-
FREB is valuable when:
89+
Failed Request Tracing is valuable when:
9090

9191
- An error is intermittent or difficult to reproduce on demand.
9292
- A request is slow but returns a 200, and you need to know *where* in the pipeline the time is spent.
9393
- IIS request logs tell you *what* happened but not *why*.
9494

95-
### Enabling FREB
95+
### Enabling Failed Request Tracing
9696

9797
**Using IIS Manager:**
9898

@@ -109,7 +109,7 @@ FREB is valuable when:
109109
> The following commands use `::` comment syntax and must be run in a Command Prompt window (`cmd.exe`), not PowerShell.
110110
111111
```cmd
112-
:: Enable FREB on the "Default Web Site"
112+
:: Enable Failed Request Tracing on the "Default Web Site"
113113
%SystemRoot%\System32\inetsrv\appcmd set config "Default Web Site" /section:system.applicationHost/sites /"[name='Default Web Site'].traceFailedRequestsLogging.enabled:true" /commit:apphost
114114
115115
:: Add a rule for all content
@@ -124,9 +124,9 @@ FREB is valuable when:
124124

125125
To trace status-code failures instead, set `failureDefinitions.statusCodes:"500-599"` on the same rule.
126126

127-
### Reading FREB output
127+
### Reading Failed Request Tracing output
128128

129-
FREB trace files are written to the directory you configured (default: `%SystemDrive%\inetpub\logs\FailedReqLogFiles\W3SVC<siteId>`). Open the XML file in a browser. The XSLT stylesheet formats it into a navigable report.
129+
Trace files are written to the directory you configured (default: `%SystemDrive%\inetpub\logs\FailedReqLogFiles\W3SVC<siteId>`). Open the XML file in a browser. The XSLT stylesheet formats it into a navigable report.
130130

131131
Key sections to examine:
132132

@@ -139,7 +139,7 @@ Key sections to examine:
139139
If you see a large time gap after an event from a specific module (for example, `ManagedPipelineHandler`), the bottleneck is in that module's processing, typically in application code or an external dependency the application is calling.
140140

141141
> [!WARNING]
142-
> Disable FREB as soon as you've captured the data you need. In production, use specific status codes or time-taken thresholds instead of tracing all requests, and set a maximum trace file count (for example, 50) to prevent unbounded growth. FREB writes one XML file per traced request, so high traffic can fill disk quickly and degrade performance.
142+
> Disable Failed Request Tracing as soon as you've captured the data you need. In production, use specific status codes or time-taken thresholds instead of tracing all requests, and set a maximum trace file count (for example, 50) to prevent unbounded growth. Failed Request Tracing writes one XML file per traced request, so high traffic can fill disk quickly and degrade performance.
143143
144144
## Walkthrough: 503 errors after deployment
145145

0 commit comments

Comments
 (0)