Shromažďování diagnostických dat za provozu pomocí samostatného nástroje pro shromažďování dat IntelliTrace

Článek
11/25/2015

Samostatné kolekce IntelliTrace umožňuje shromažďování diagnostických dat IntelliTrace pro vaše aplikace na produkční servery nebo jinými prostředími bez instalace sady Visual Studio v cílovém počítači a beze změny prostředí cílového systému.Samostatné kolekce IntelliTrace pracuje na web, SharePoint, WPF a Windows Forms aplikace.Po dokončení shromažďování údajů o, stačí odstraňte kolekce odinstalujte jej.

Podívejte se, jak IntelliTrace v akci: shromažďování a analýzu dat IntelliTrace v produkčním prostředí pro ladění (Channel 9 video)

[!POZNÁMKA]

Můžete také shromažďovat stejná data nástroje IntelliTrace pro webové aplikace a služby SharePoint aplikace spuštěna ve vzdálených počítačích pomocí Microsoft Monitoring Agent v trasování režimu.

Můžete shromažďovat události související s výkonem v datech IntelliTrace spuštěním agenta monitorování režimu.Monitorování režim má menší dopad na výkon než trasování režimu nebo samostatné kolekce IntelliTrace.Microsoft Monitoring Agent nezmění prostředí cílovém systému při instalaci.Podívejte se na téma Shromažďování diagnostických dat a dat o výkonu technologie IntelliTrace za provozu pomocí Microsoft Monitoring Agenta.

Požadavky

.NET Framework
Visual Studio Ultimate 2015 na vývojovém počítači nebo jiného počítače k otevření souborů .iTrace

[!POZNÁMKA]

Ujistěte se, k uložení souborů (PDB) váš symbol.Pro ladění pomocí nástroje IntelliTrace a krokování kódu, musí mít odpovídající zdrojové soubory a symbol soubory.Podívejte se na téma Nastavení vaší verze k diagnostikování problémů po nasazení.

Nejčastější dotazy

Jaké aplikace pracovat s kolekce?
Jak lze začít?
Jak lze získat většina data bez zpomalování Moje aplikace?
Jinou kde lze získat dat IntelliTrace?

Jaké aplikace pracovat s kolekce?

Technologie ASP.NET webové aplikace hostované na Internet Information Services (IIS)
Aplikace SharePoint 2010 a službu SharePoint 2013
Windows Presentation Foundation (WPF) a Windows Forms aplikace.

Jak lze začít?

Instalace kolekce.
Nastavte oprávnění pro adresář kolekce.
Pro webové aplikace a služby SharePoint aplikace nainstalujte rutiny prostředí IntelliTrace PowerShell.
Nastavte oprávnění pro adresář .iTrace souboru.
Shromážděte data z webové aplikace nebo aplikace služby SharePoint.

-nebo-

Shromážděte data z spravované aplikace.
Otevřete soubor .iTrace v sadě Visual Studio Ultimate.

Instalace kolekce

Na serveru pro vaše aplikace vytvořte adresář kolekcí, například: C:\IntelliTraceCollector
Získáte kolekce z Microsoft Download Center nebo z instalační složka sady Visual Studio 2103 Update 3.Kolekce IntelliTrace pro Visual Studio 2013 Update 4:
- Microsoft Download Center:
  1. Vedle IntelliTraceCollector.exe, zvolte Stáhnout.
  2. Uložte IntelliTraceCollector.exe do adresáře kolekcí, například: C:\IntelliTraceCollector
  3. Spusťte IntelliTraceCollector.exe.To extrahuje soubor IntelliTraceCollection.cab.
  - nebo -
- Sady visual Studio Instalační složka:
  1. Zkopírujte IntelliTraceCollection.cab z následující složky:
    
    ..\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\IntelliTrace\12.0.0
  2. Vložte IntelliTraceCollection.cab v adresáři kolekcí, například: C:\IntelliTraceCollector
Rozbalte IntelliTraceCollection.cab:
1. Na serveru pro svou aplikaci otevřete okno příkazového řádku jako správce.
2. Přejděte do adresáře kolekcí, například: C:\IntelliTraceCollector
3. Použití expand příkazu, včetně doby (.) na konci rozbalte IntelliTraceCollection.cab:
  
  Rozbalte /f:* IntelliTraceCollection.cab.
  
  [!POZNÁMKA]
  
  Období (.) zachovává podsložky, které obsahují lokalizované kolekce plánů.

Nastavení oprávnění pro adresář kolekce

Na serveru pro svou aplikaci otevřete okno příkazového řádku jako správce.
Pomocí systému Windows icacls příkazu tak, aby poskytovala serveru úplná oprávnění správce pro adresář kolekce.Příklad:

/grant icacls "C:\IntelliTraceCollector" "< Domain\AdministratorID >": F
Chcete-li shromažďovat data pro webovou aplikaci nebo aplikaci služby SharePoint:
1. Poskytněte uživateli, který bude spuštěn rutiny prostředí IntelliTrace PowerShell úplná oprávnění k adresáři kolekce.
  
  Příklad:
  
  /grant icacls "C:\IntelliTraceCollector" "< doména\ID_uživatele >": F
2. Zadejte fond aplikací pro webovou aplikaci nebo aplikace služby SharePoint pro čtení a oprávnění k adresáři kolekce.
  
  Příklad:
  - Pro webovou aplikaci v DefaultAppPool fond aplikací:
    
    / ICACLS "C:\IntelliTraceCollector" grant "IIS APPPOOL\DefaultAppPool": OBDX
  - Pro aplikaci služby SharePoint v SharePoint – 80 fond aplikací:
    
    / ICACLS "C:\IntelliTraceCollector" grant "IIS APPPOOL\SharePoint - 80": OBDX

Instalace rutin prostředí PowerShell pro IntelliTrace, aby bylo možné shromažďovat data pro webové aplikace nebo aplikace služby SharePoint

Ujistěte se, že je povoleno prostředí PowerShell na server svou aplikaci.Na většině verze systému Windows Server, je možné přidat tuto funkci v správce serveru nástroje pro správu.
Instalace rutin prostředí IntelliTrace PowerShell.
1. Otevřete příkazové okno prostředí PowerShell jako správce.
  1. Zvolte Start, Všechny programy, Příslušenství, prostředí Windows PowerShell.
  2. Zvolte jednu z následujících kroků:
    - V 64bitových operačních systémech, otevřete místní nabídku pro prostředí Windows PowerShell.Zvolte Spustit jako správce.
    - V operačních systémech 32 bitů, otevřete místní nabídku pro prostředí Windows PowerShell (x 86).Zvolte Spustit jako správce.
2. V okně příkazového prostředí PowerShell používat Import-Module příkaz Import Microsoft.VisualStudio.IntelliTrace.PowerShell.dll.
  
  Příklad:
  
  Import-Module "C:\IntelliTraceCollector\Microsoft.VisualStudio.IntelliTrace.PowerShell.dll"

Nastavení oprávnění pro adresář souboru .iTrace

Na serveru pro vaše aplikace vytvořte adresář souboru .iTrace, například: C:\IntelliTraceLogFiles

[!POZNÁMKA]

Chcete-li předejít zpomalením vaší aplikace, vyberte umístění na místním disku vysokorychlostní, který není velmi aktivní.

Soubory .iTrace a kolekcí můžete umístit na jednom místě.Nicméně pokud máte webovou aplikaci nebo aplikace SharePoint, ujistěte se, že toto místo je mimo adresář, který je hostitelem aplikace.

Poznámka k zabezpečení
Omezte soubor adresář .iTrace pouze na ty identity, které musí pracovat s kolekce.Soubor s příponou .iTrace mohou obsahovat citlivé informace, jako je například data z uživatelů, databází, jiné umístění zdroje a připojovací řetězce vzhledem k tomu, že IntelliTrace zaznamenávat všechna data, která předá do parametry metody nebo jako vrácené hodnoty. Ujistěte se, že osob, kterým je možné otevřít soubory .iTrace mají oprávnění k zobrazení citlivá data.Při sdílení souborů .iTrace postupujte opatrně.Je-li jiní uživatelé musí mít přístup, zkopírujte do zabezpečeného umístění sdílené soubory.

Omezte soubor adresář .iTrace pouze na ty identity, které musí pracovat s kolekce.Soubor s příponou .iTrace mohou obsahovat citlivé informace, jako je například data z uživatelů, databází, jiné umístění zdroje a připojovací řetězce vzhledem k tomu, že IntelliTrace zaznamenávat všechna data, která předá do parametry metody nebo jako vrácené hodnoty.
Ujistěte se, že osob, kterým je možné otevřít soubory .iTrace mají oprávnění k zobrazení citlivá data.Při sdílení souborů .iTrace postupujte opatrně.Je-li jiní uživatelé musí mít přístup, zkopírujte do zabezpečeného umístění sdílené soubory.

Pro webovou aplikaci nebo aplikace SharePoint uveďte jeho fond aplikací úplná oprávnění k adresáři .iTrace souboru.Můžete použít Windows icacls příkaz, nebo použijte Průzkumníka Windows (nebo File Explorer).

Příklad:
- Chcete-li nastavit oprávnění s Windows icacls příkazu:
  - Pro webovou aplikaci v DefaultAppPool fond aplikací:
    
    / ICACLS "C:\IntelliTraceLogFiles" grant "IIS APPPOOL\DefaultAppPool": F
  - Pro aplikaci služby SharePoint v SharePoint – 80 fond aplikací:
    
    / ICACLS "C:\IntelliTraceLogFiles" grant "IIS APPPOOL\SharePoint - 80": F
  -nebo-
- Chcete-li nastavit oprávnění pomocí programu Průzkumník Windows (nebo File Explorer):
  1. Otevřít Vlastnosti pro adresář .iTrace souboru.
  2. Na zabezpečení vyberte Upravit, Přidat.
  3. Přesvědčte se, zda objekty integrovaného zabezpečení se zobrazí v Vyberte tento typ objektu pole.Pokud se má, volbu typy objektů jej přidat.
  4. Ujistěte se, že se zobrazí v místním počítači z tohoto umístění pole.Pokud se má, volbu umístění ho změnit.
  5. V Zadejte názvy objektů k výběru pole, přidejte fondu aplikací pro webovou aplikaci nebo aplikace služby SharePoint.
  6. Zvolte Kontrola názvů k překladu názvu.Zvolte OK.
  7. Zkontrolujte, zda má fond aplikací Úplné řízení.

Shromažďování dat z webové aplikace nebo aplikace služby SharePoint

Chcete-li spustit shromažďování dat, otevřete příkazové okno prostředí PowerShell jako správce a potom spusťte tento příkaz:

Start IntelliTraceCollection"< ApplicationPool >"< PathToCollectionPlan >< FullPathToITraceFileDirectory >

Důležité
Po spuštění tohoto příkazu, zadejte Y potvrďte, že chcete spustit shromažďování dat.

Chcete-li například shromáždit data z aplikace SharePoint v SharePoint - 80 fond aplikací:

Start-IntelliTraceCollection "SharePoint – 80" "C:\IntelliTraceCollector\collection_plan.ASP.NET.default.xml" "C:\IntelliTraceLogFiles"

ApplicationPool

Název fondu aplikací, kde běží aplikace

PathToCollectionPlan

Cesta k plán shromažďování, soubor .xml, který konfiguruje nastavení pro kolekce.

Můžete zadat plán, který je součástí kolekce.Následujících plánů pracovat pro webové aplikace a služby SharePoint aplikace:

collection_plan.ASP.NET.default.XML

Shromažďuje pouze události IntelliTrace a SharePoint události, včetně výjimek, volání databáze a požadavky webového serveru.
collection_plan.ASP.NET.Trace.XML

Volání funkce shromažďuje a všechna data v collection_plan.ASP.NET.default.xml.Tento plán platí pro podrobnou analýzu, ale může zpomalit svou aplikaci více než collection_plan.ASP.NET.default.xml.

Chcete-li předejít zpomalením svou aplikaci, přizpůsobit tyto plány nebo vytvořit vlastní plán.Zabezpečení umístí všechny vlastní plány ve stejném umístění zabezpečené jako soubory kolekcí.Podívejte se na téma vytváření a přizpůsobení plány kolekce IntelliTrace a Jak lze získat nejvíce dat bez zpomalování Moje aplikace?

[!POZNÁMKA]

Ve výchozím nastavení je maximální velikost souboru .iTrace 100 MB.Pokud soubor .iTrace nedosáhne tohoto limitu, kolekce odstraní nejstarší položky v souboru uvolněte místo pro novější položky.Chcete-li změnit tento limit, upravit plán shromažďování MaximumLogFileSize atributu.

Kde lze najít lokalizované verze těchto plánů kolekce?

Lokalizované plány najdete v podsložkách kolekce.

FullPathToITraceFileDirectory

Úplná cesta k adresáři .iTrace souboru.

Poznámka k zabezpečení
Zadejte úplnou cestu, nejedná se o relativní cestu.

Kolekce připojí k fondu aplikací a zahájení sběru dat.

Můžete otevřít soubor .iTrace v současné době? Ne, soubor je uzamčen při shromažďování dat.

Problém reprodukovat.
Pořizování snímku .iTrace souboru, použijte tuto syntaxi:

Kontrolního bodu IntelliTraceCollection"< ApplicationPool >"
Chcete-li zkontrolovat stav kolekce, použijte tuto syntaxi:

Get-IntelliTraceCollectionStatus

Chcete-li ukončit shromažďování dat, použijte tuto syntaxi:

Stop-IntelliTraceCollection"< ApplicationPool >"

Důležité
Po spuštění tohoto příkazu, zadejte Y potvrďte, že chcete zastavit shromažďování dat.Kolekce v ostatních případech může pokračovat, shromažďování dat, iTrace soubor zůstane uzamčené nebo soubor nemusí obsahovat potřebná data.

Otevřete soubor .iTrace v sadě Visual Studio Ultimate.

Shromažďování dat ze spravované aplikace

Pokud chcete spustit aplikaci a shromažďování dat současně, použijte tuto syntaxi:

< FullPathToIntelliTraceCollectorExecutable >\IntelliTraceSC.exe spuštění /cp:< PathToCollectionPlan >/f:< FullPathToITraceFileDirectoryAndFileName >< PathToAppExecutableFileAndFileName >

Například, aby shromažďovala data z aplikace s názvem Moje aplikace:

/F:"C:\IntelliTraceLogFiles\MyApp.itrace C:\IntelliTraceCollector\IntelliTraceSC.exe spuštění /cp:"C:\IntelliTraceCollector\collection_plan.ASP.NET.default.xml"" "C:\MyApp\MyApp.exe"

FullPathToIntelliTraceCollectorExecutable

Úplná cesta k spustitelný soubor, kolekce IntelliTraceSC.exe

PathToCollectionPlan

Cesta k plán shromažďování, soubor .xml, který konfiguruje nastavení pro kolekce.

Můžete zadat plán, který je součástí kolekce.Následujících plánů pracovat pro spravovaných aplikacích:

collection_plan.ASP.NET.default.XML

Shromažďuje IntelliTrace události pouze, včetně výjimek, volání databáze a požadavky webového serveru.
collection_plan.ASP.NET.Trace.XML

Volání funkce shromažďuje a všechna data v collection_plan.ASP.NET.default.xml.Tento plán platí pro podrobnou analýzu, ale může zpomalit svou aplikaci více než collection_plan.ASP.NET.default.xml.

[!POZNÁMKA]

Ve výchozím nastavení je maximální velikost souboru .iTrace 100 MB.Pokud soubor .iTrace nedosáhne tohoto limitu, kolekce odstraní nejstarší položky v souboru uvolněte místo pro novější položky.Chcete-li změnit tento limit, upravit plán shromažďování MaximumLogFileSize atributu.

Kde lze najít lokalizované verze těchto plánů kolekce?

Lokalizované plány najdete v podsložkách kolekce.

FullPathToITraceFileDirectoryAndFileName

Úplná cesta k adresáři .iTrace souboru a název souboru .iTrace .itrace rozšíření.

Poznámka k zabezpečení
Zadejte úplnou cestu, nejedná se o relativní cestu.

PathToAppExecutableFileAndFileName

Cesta a název spravované aplikace

Zastavte shromažďování dat ukončením aplikace.
Otevřete soubor .iTrace v sadě Visual Studio Ultimate.

Otevřete soubor .iTrace v sadě Visual Studio Ultimate

[!POZNÁMKA]

Pro ladění pomocí nástroje IntelliTrace a krokování kódu, musí mít odpovídající zdrojové soubory a symbol soubory.Podívejte se na téma Nastavení vaší verze k diagnostikování problémů po nasazení.

Přesunout soubor .iTrace nebo zkopírujte jej do počítače pomocí sady Visual Studio Ultimate.
Poklepejte na soubor .iTrace mimo sadu Visual Studio nebo otevření souboru v rámci sady Visual Studio.

Visual Studio ukazuje IntelliTrace Souhrn stránky.Ve většině částí, můžete zkontrolovat události nebo jiných položek, zvolte položku a spustit ladění pomocí nástroje IntelliTrace v okamžiku kde a kdy došlo k události.Podívejte se na téma Ladění aplikace pomocí uložených dat IntelliTrace.

[!POZNÁMKA]

Pro ladění pomocí nástroje IntelliTrace a krokování kódu, musí mít odpovídající zdrojové soubory a symbol soubory ve svém počítači vývoje.Podívejte se na téma Nastavení vaší verze k diagnostikování problémů po nasazení.

Jak získat většina data bez zpomalování Moje aplikace?

IntelliTrace může shromažďovat velké množství dat, takže dopad na výkon svou aplikaci závisí na data, která shromažďuje IntelliTrace a druh kód, který ji analyzuje.Podívejte se na téma Optimalizace shromažďování snímků IntelliTrace na produkční servery.

Zde najdete několik způsobů, jak získat data týkající se většina bez zpomalování svou aplikaci:

Kolekce spusťte pouze v případě, že si myslíte, že došlo k potížím, nebo když můžete reprodukovat problém.

Spustit shromažďování, reprodukovat a poté se zastaví kolekce.Otevřete soubor .iTrace v sadě Visual Studio Ultimate a zkoumat data.Podívejte se na téma Otevřít soubor protokolu IntelliTrace v sadě Visual Studio Ultimate..
Pro webové aplikace a služby SharePoint aplikace zaznamenává kolekce dat pro každou aplikaci, který sdílí zadaný fond aplikací.Může dojít ke zpomalení libovolná aplikace, který sdílí stejné fond aplikací, přestože moduly pro jednu aplikaci lze zadat pouze v kolekci plánu.

Chcete-li zabránit kolekce zpomalením dalších aplikací, hostování každou aplikaci ve své vlastní fondu aplikací.
Najdete v událostech v plánu kolekce, pro kterou IntelliTrace shromažďuje data.Upravte plán kolekce zakázání události, které nejsou relevantní nebo vás nezajímají.

Chcete-li událost zakázat, nastavte enabled atribut pro <DiagnosticEventSpecification> elementu, který chcete false:

<DiagnosticEventSpecification enabled="false">

Pokud enabled atribut neexistuje, je událost povolena.

Jak to zvýšit výkon?
- Po spuštění můžete zkrátit zakázáním události, které nejsou relevantní pro aplikaci.Zakažte například Windows Workflow události pro aplikace, které nepoužívají Windows Workflow.
- Můžete zlepšit výkon při spuštění a modul runtime zakázáním události registru pro aplikace, které přístup do registru, ale nezobrazovat problémy s nastavení registru.
Zkontrolujte moduly v plánu kolekce, pro kterou IntelliTrace shromažďuje data.Upravte plán kolekce mají být zahrnuty pouze moduly, které vás zajímají:
1. Otevřete plán kolekce.Najít <ModuleList> elementu.
2. V <ModuleList>, nastavte isExclusionList atribut false.
3. Použití <Name> elementu, který chcete určit každý modul s jedním z následujících hodnot: název souboru, hodnota řetězce, které mají být zahrnuty všechny modulu, jejichž název obsahuje tento řetězec nebo veřejný klíč.
Můžete například ke shromažďování dat od právě hlavní Web modul Fabrikam vlákno webové aplikace, vytvořte seznam podobný následujícímu:
```
<ModuleList isExclusionList="false">
   <Name>FabrikamFiber.Web.dll</Name>
</ModuleList>
```
Chcete-li shromažďovat data z jakékoli modulu, jehož název obsahuje "Fabrikam", vytvořte seznam byste se:
```
<ModuleList isExclusionList="false">
   <Name>Fabrikam</Name>
</ModuleList>
```
Chcete-li shromažďovat data z modulů tak, že určíte jejich tokenů veřejných klíčů, vytvořte seznam byste se:
```
<ModuleList isExclusionList="false">
   <Name>PublicKeyToken:B77A5C561934E089</Name>
   <Name>PublicKeyToken:B03F5F7F11D50A3A</Name>
   <Name>PublicKeyToken:31BF3856AD364E35</Name>
   <Name>PublicKeyToken:89845DCD8080CC91</Name>
   <Name>PublicKeyToken:71E9BCE111E9429C</Name>
</ModuleList>
```
Jak to zvýšit výkon?

Tím omezíte množství informací o volání metody a jiná data služby WMI, která IntelliTrace shromažďuje při spuštění aplikace a běží.Tato data umožňuje:
- Krokovat kód po získání data.
- Zkontrolujte hodnoty předány a vrácená z volání funkce.
Proč není místo toho vyloučit modulů?

Ve výchozím nastavení, vyloučit plány kolekce modulů nastavením isExclusionList atribut true.S výjimkou modulů mohou stále výsledkem však shromažďování dat z modulů, které nevyhovují kritéria v seznamu a nemusí zájem, jako je například modulů třetích stran nebo open source.
Je k dispozici žádná data, která není shromažďovat IntelliTrace?

Ano, abyste snížili vliv na výkon, IntelliTrace omezuje shromažďování dat do hodnoty primitivní datové typy předána a vrácená z metody a k hodnotám primitivní datové typy v polích na nejvyšší úrovni objekty předána a vrácená z metody.

Předpokládejme, že máte AlterEmployee Podpis metody, která přijme celé číslo id a Employee objektu oldemployee:

public Employee AlterEmployee(int id, Employee oldemployee)

Employee Typu má následující atributy: Id, Name, a HomeAddress.Existuje vztah přidružení mezi Employee a Address typu.

Kolekce zaznamenává hodnoty pro id, Employee.Id, Employee.Name a Employee vrácená z objektu AlterEmployee metody.Kolekce však není zaznamenání informací o Address objektu, než bez ohledu na se, zda byla null.Kolekce také nezaznamená data o místní proměnné v AlterEmployee metodu pouze v případě jiných metod použijete ty místní proměnné jako parametry, které jsou v tomto okamžiku jsou zaznamenány jako parametry metody.