Update ETL capture to use perfview.exe

This commit is contained in:
Ming Liu 2017-01-12 11:41:13 -08:00
Родитель cde23b944a
Коммит 148072b400
1 изменённых файлов: 23 добавлений и 8 удалений

Просмотреть файл

@ -2,27 +2,42 @@
The Azure DocumentDB .NET SDK (from version 1.11.0) support capturing trace in ETL trace log file. The trace is emitted and captured using Windows ETW with very little overhead.
## Steps to collect ETL trace file.
## Method 1: (Recommended) Use Perfview to collect and view ETL.
### Steps to collect and viewETL trace file.
1. Download Perfview tool at https://www.microsoft.com/en-us/download/details.aspx?id=28567
2. In Windows command prompt:
perfview.exe /onlyproviders=B30ABF1C-6A50-4F2B-85C4-61823ED6CF24:*:0 collect
3. When it is done, click “Stop Collection” button. “PerviewData.etl.zip” will be generated in the current directory.
4. To view the trace, double Click the PerviewData.etl.zip, go to Events, and look for "Providers/B30ABF1C-6A50-4F2B-85C4-61823ED6CF24"
### Monitor the trace in real time.
1. In Windows command prompt:
perfview.exe UserCommand Listen B30ABF1C-6A50-4F2B-85C4-61823ED6CF24:*:0
## Method 2: Use logman and svcperf to collect and view ETL.
### Steps to collect ETL trace file.
1. In Windows command prompt:
logman create trace docdbclienttrace -rt -nb 500 500 -bs 40 -p {B30ABF1C-6A50-4F2B-85C4-61823ED6CF24} -o docdbclient.etl -ft 10
logman create trace docdbclienttrace -rt -nb 500 500 -bs 40 -p {B30ABF1C-6A50-4F2B-85C4-61823ED6CF24} -o docdbclient.etl -ft 10
2. When you are ready to collect trace:
logman start docdbclienttrace
logman start docdbclienttrace
3. When finish collecting:
logman stop docdbclienttrace
logman stop docdbclienttrace
4. You should see docdbclientxxx.etl in current directory.
## You can send the ETL file to us.
## Steps to open ETL if you are interested:
### Steps to open ETL if you are interested:
1. Download the svcperf at [https://svcperf.codeplex.com/](https://svcperf.codeplex.com/)
2. Open svcperf.exe.
3. In "Manifests|Add", add the ClientEvents.man found in this folder with this
4. Open the etl file you have captured, you might need to hit F5 to refresh it.
## You can send the ETL file to docdb team for analysis.