Nastavení vaší verze k diagnostikování problémů po nasazení

Diagnostikovat problémy ve vaší webové aplikaci ASP.NET po nasazení pomocí nástroje IntelliTrace, obsahují informace o sestavení s vydaných verzí, aby mohla služba Visual Studio automaticky najít správnou zdrojové soubory a soubory symbolů, které jsou nezbytné pro ladění protokolu IntelliTrace.

Při použití nástroje Microsoft Monitoring Agent ke kontrole IntelliTrace, je také nutné nastavit nastavení monitorování výkonu aplikace na vašem webovém serveru.To zaznamenává diagnostických událostí, zatímco vaše aplikace běží a uloží události do souboru protokolu IntelliTrace.Můžete poté podívejte se na události v sadě Visual Studio Ultimate, přejděte ke kódu, kde došlo události, podívejte se na zaznamenané hodnoty v tomto okamžiku a posunout dopředu nebo dozadu prostřednictvím kód, který byl spuštěn.Poté, co najít a opravit potíže, opakujte cyklus sestavení, verze a sledovat vydaných verzí, takže může vyřešit budoucí potenciální problémy dříve a rychlejší.

Budete potřebovat:

• Visual Studio 2013 nebo Team Foundation Server 2013, 2012 nebo 2010 nastavit sestavení

• Chcete-li monitorovat aplikace a záznam diagnostická data agenta monitorování společnosti Microsoft

• Visual Studio Ultimate 2013 přehled diagnostická data a ladění kódu pomocí nástroje IntelliTrace

Krok 1: Zahrnují sestavení informací pomocí vydaných verzí

Nastavit váš proces sestavení pro vytvoření manifestu sestavení (soubor BuildInfo.config) pro webový projekt a zahrnout tento manifest s vydaných verzí.Tento manifest obsahuje informace o projektu, Správa zdrojového kódu a systém sestavení, která byla použita k vytvoření konkrétní sestavení.Tyto informace pomáhají Visual Studio, najděte odpovídající zdroje a symboly po otevření protokolu IntelliTrace můžete ověřit zaznamenané události.

Vytvoření manifestu sestavení pro automatizovaných sestavení pomocí serveru Team Foundation Server

Ať používáte správy verzí produktu Team Foundation nebo Git, postupujte takto:

Team Foundation Server 2013

Chcete-li přidat umístění zdroje, sestavení a symboly k manifestu sestavení (soubor BuildInfo.config) nastavte definici sestavení.Team Foundation Build automaticky vytvoří tento soubor a může se dostat do výstupní složky vašeho projektu.

1. Upravte definici sestavení nebo vytvořte novou definici sestavení.

   

2. Zvolte výchozí šablonu (TfvcTemplate.12.xaml) nebo vlastní šablonu.

   

3. Určete, kam chcete uložit soubor symbolů (PDB), tak, aby automaticky indexované zdroje.

   Pokud používáte vlastní šablonu, ujistěte se, že šablona má aktivitu pro indexování zdroje.Později přidáte argument MSBuild k určení, kam chcete uložit soubory symbolů.

   

   Další informace o symbolech naleznete v tématu Publikování dat symbolů.

4. Přidejte tento argument MSBuild mají být zahrnuty své sady TFS a symboly umístění v souboru manifestu sestavení:

   /p:IncludeServerNameInBuildInfo=True

   Každý uživatel, který lze získat přístup k webovému serveru můžete zobrazit tato umístění v manifestu sestavení.Ujistěte se, zda je server zdroj zabezpečené.

5. Pokud použijete vlastní šablonu, přidejte tento argument MSBuild k určení, kam chcete uložit soubor symboly:

   /p:BuildSymbolStorePath =<cesta k symbolům>

   

   A přidejte tyto řádky do souboru webového projektu (.csproj, .vbproj):

   <!-- Import the targets file. Change the folder location as necessary. -->
      <Import Project=""$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\BuildInfo\Microsoft.VisualStudio.ReleaseManagement.BuildInfo.targets" />
   

6. Spusťte nové sestavení.

**Step 2:**Verze aplikace

Team Foundation Server 2012 nebo 2010

Použijte následující postup automaticky vytvořit manifest sestavení (soubor BuildInfo.config) pro váš projekt a uložte soubor ve složce výstup svůj projekt.Soubor se zobrazí jako "název projektu.BuildInfo.config"do výstupní složky, ale je přejmenován"BuildInfo.config"ve složce nasazení po publikování aplikace.

1. Instalace sady Visual Studio 2013 (všechny verze) na serveru Team Foundation sestavení.

2. V rámci definice sestavení zadejte umístění pro ukládání symbolů tak, aby byl zdroj automaticky indexován.

   Pokud používáte vlastní šablonu, ujistěte se, že šablona má aktivitu pro indexování zdroje.

3. Do definice sestavení přidejte následující argumenty nástroje MSBuild:

   • /p:VisualStudioVersion=12.0

   • /p:MSBuildAssemblyVersion=12.0

   • /tv:12.0

   • /p:IncludeServerNameInBuildInfo=True

   • /p:BuildSymbolStorePath =<cesta k symbolům>

4. Spusťte nové sestavení.

**Step 2:**Verze aplikace

Vytvoření manifestu sestavení pro ruční sestavení pomocí sady Visual Studio 2013

Použijte následující postup automaticky vytvořit manifest sestavení (soubor BuildInfo.config) pro váš projekt a uložte soubor ve složce výstup svůj projekt.Soubor se zobrazí jako "název projektu.BuildInfo.config"do výstupní složky, ale je přejmenován"BuildInfo.config"ve složce nasazení po publikování aplikace.

1. V Průzkumníka řešení, uvolnit webového projektu.

2. Otevřete soubor projektu (CSPROJ, VBPROJ).Přidejte tyto řádky:

   <!-- **************************************************** -->
   <!-- Build info -->
   <PropertyGroup>
      <!-- Generate the BuildInfo.config file -->
      <GenerateBuildInfoConfigFile>True</GenerateBuildInfoConfigFile>
      <!-- Include server name in build info --> 
      <IncludeServerNameInBuildInfo>True</IncludeServerNameInBuildInfo> 
      <!-- Include the symbols path so Visual Studio can find the matching deployed code when you start debugging. -->
      <BuildSymbolStorePath><path to symbols></BuildSymbolStorePath>
   </PropertyGroup>
   <!-- **************************************************** -->
   

3. Proveďte vrácení aktualizovaného souboru projektu se změnami.

4. Spusťte nové sestavení.

**Step 2:**Verze aplikace

Vytvoření manifestu sestavení pro ruční sestavení pomocí MSBuild.exe

Přidání, že tyto vytvářet argumenty, když spustíte sestavení:

/p:GenerateBuildInfoConfigFile=True

/p:IncludeServerNameInBuildInfo=True

/p:BuildSymbolStorePath=<cesta k symbolům>

Krok 2: Verze aplikace

Pokud použijete Web.Deploy balíček který byl vytvořen váš proces sestavení pro nasazení aplikace, manifest sestavení automaticky přejmenován z "název projektu.BuildInfo.config"na"BuildInfo.config"a je umístěn ve složce se souborem Web.config svou aplikaci na webovém serveru.

Pokud použijete k nasazení aplikace jiných metod, ujistěte se, že manifest sestavení přejmenován z "název projektu.BuildInfo.config"na"BuildInfo.config"a je umístěn ve složce se souborem Web.config svou aplikaci na webovém serveru.

Krok 3: Sledování vaší aplikace

Nastavte monitorování výkonu aplikace na vašem webovém serveru tak, aby můžete sledovat svou aplikaci pro problémy, zaznamenat diagnostické události a uložit tyto události do souboru protokolu IntelliTrace.Podívejte se na téma monitorování vydaných verzí pro problémů s nasazením.

Krok 4: Najít příčinu problému

Budete potřebovat Visual Studio Ultimate 2013 na vývojovém počítači nebo jiného počítače, abyste zkontrolovali zaznamenané události a ladění kódu pomocí nástroje IntelliTrace.Můžete také použít nástroje jako CodeLens, ladicí program mapuje a kódu mapuje k diagnostice problému.

Otevření protokolu nástroje IntelliTrace a odpovídajícího řešení

1. Otevřete protokol IntelliTrace (.iTrace soubor) ze sady Visual Studio Ultimate 2013.Nebo pokud máte aplikaci Visual Studio Ultimate 2013 na stejném počítači, dvakrát klikněte na soubor.

2. Pokud chcete, aby aplikace Visual Studio automaticky otevřela odpovídající řešení nebo projekt, nebyl-li projekt vytvořen jako součást řešení, zvolte možnost Otevřít řešení.Protokol nástroje IntelliTrace neobsahuje informace o mé nasazené aplikaci. Proč tomu mohlo dojít? Co mohu udělat?

   Visual Studio automaticky regálech všechny čekající změny při otevření odpovídající řešení nebo projektu.Chcete-li získat další podrobnosti o této sadě odložených změn, podívejte se do okna Výstup nebo Průzkumník týmových projektů.

   Před provedením změny potvrdit, že máte správný zdroj.Používáte-li větvení, může pracovat v různých větvení, než kde sady Visual Studio vyhledá odpovídající zdroje, jako je vaše verze větev.

   

   Pokud máte stávající schůzek mapovat na toto řešení nebo projektu, Visual Studio vybere tento pracovní prostor pozastavení zdroje, která je nalezena.

   

   V opačném případě zvolte jiný pracovní prostor nebo vytvořte nový pracovní prostor.Sada Visual Studio bude mapovat celou větev na tento pracovní prostor.

   

   Pokud chcete vytvořit pracovní prostor s konkrétními mapováními nebo názvem, který není názvem vašeho počítače, zvolte možnost Spravovat.

   Proč sada Visual Studio hlásí, že je můj vybraný pracovní prostor nezpůsobilý?

   Proč nemohu pokračovat, dokud nevyberu kolekci týmu nebo jinou kolekci?

Diagnostikování problému s výkonem

1. V části Narušení výkonu zkontrolujte zaznamenané události výkonu, jejich celkové časy spuštění a další informace o události.Pak přejděte hlouběji do metod, které byly volány během konkrétní události výkonu.

   

   Můžete také pouze dvakrát kliknout na událost.

2. Na stránce události zkontrolujte časy spuštění těchto volání.Vyhledejte pomalé volání ve stromu spuštění.

   Pokud máte více volání vnořených nebo jiných, zobrazují se nejpomalejší volání ve vlastním oddílu.

   Rozbalte volání za účelem kontroly všech vnořených volání a hodnot, které byly zaznamenány v daném časovém okamžiku.Potom spusťte ladění z tohoto volání.

   

   Můžete také pouze dvakrát kliknout na volání.

   Pokud je metoda v kódu aplikace, sada Visual Studio přejde na tuto metodu.

   

   Nyní můžete zkontrolovat další zaznamenané hodnoty, zásobník volání, procházet kódem nebo použít okno IntelliTrace pro pohyb zpět nebo vpřed „v čase“ mezi ostatními metodami, které byly volány během této události výkonu.K čemu slouží všechny tyto další události a informace v protokolu IntelliTrace?Co víc mohu ještě udělat?Chcete-li další informace o událostech výkonu?

Diagnostikování výjimky

• V části Data výjimky zkontrolujte zaznamenané události výjimky, jejich typy, zprávy a časy, kdy výjimky nastala.Pokud se chcete dostat hlouběji do kódu, spusťte ladění od poslední události ve skupině výjimek.

  

  Můžete také pouze dvakrát kliknout na událost.

  Pokud došlo k výjimce v kódu aplikace, sada Visual Studio pokračuje tam, kde došlo k výjimce.

  

  Nyní můžete zkontrolovat další zaznamenané hodnoty, zásobník volání nebo použít okno IntelliTrace pro pohyb zpět nebo vpřed „v čase“ mezi ostatními zaznamenanými událostmi, souvisejícím kódem a hodnotami zaznamenanými v těchto časových okamžicích.K čemu slouží všechny tyto další události a informace v protokolu IntelliTrace?

Co víc mohu ještě udělat?

• Získat další informace o tomto kódu.Odkazy na tento kód naleznete historie změn, související chyby, pracovní položky, revize kódu a testování částí – vše aniž byste opustili editor - pomocí ukazatele CodeLens v editoru.

  

  

• Mapování jakém místě v kódu při ladění.Metody, které byly během ladicí relaci volat vizuálně sledovat, můžete mapovat zásobník volání.

  

Dotazy a odpovědi

D: Proč zahrnují informace o projektu, Správa zdrojového kódu, sestavení a symboly s mé verze?

Visual Studio používá tyto informace můžete vyhledat odpovídající řešení a zdroje pro verzi, kterou se snažíte ladění.Po otevření protokolu IntelliTrace a vyberte události, která spustí ladění, Visual Studio používá symboly najít a zobrazí kód kde došlo k události.Poté můžete podívat na hodnoty, které byly zaznamenány a posunout dopředu nebo dozadu prostřednictvím provádění kódu.

Pokud používáte sady TFS a tyto informace není v sestavení manfiest (BuildInfo.config soubor), Visual Studio vyhledá odpovídající zdroj a symboly na vaše aktuálně připojených TFS.Pokud sadu Visual Studio nemůže najít správnou TFS nebo odpovídající zdroj, budete vyzváni k výběru různých TFS.

Otázka: Protokol nástroje IntelliTrace neobsahuje informace o mé nasazené aplikaci.Proč tomu mohlo dojít?Co mám udělat?

To by mohlo dojít při nasazení z vývojového počítače nebo nejste připojeni k sady TFS během nasazení.

1. Přejděte do složky vašeho projektu nasazení.

2. Vyhledejte a otevřete manifest sestavení (soubor BuildInfo.config).

3. Ujistěte se, zda že má soubor požadované informace:

Pole	Určuje
ProjectName	Název projektu v sadě Visual Studio.Příklad: <ProjectName>FabrikamFiber.Extranet.Web</ProjectName>
Správa zdrojových kódů	Informace o vaší správy zdrojového kódu a tyto požadované vlastnosti: SADY TFS ProjectCollectionUri: The identifikátor URI pro kolekci Team Foundation Server a project ProjectItemSpec: cesta k souboru svou aplikaci projektu (CSPROJ nebo VBPROJ) ProjectVersionSpec: verzi pro váš projekt Příklad: <SourceControl type="TFS"> <TfsSourceControl> <ProjectCollectionUri>http://fabrikamfiber:8080/tfs/FabrikamFiber</ProjectCollectionUri> <ProjectItemSpec>$/WorkInProgress/FabrikamFiber/FabrikamFiber.CallCenter/FabrikamFiber.Web/FabrikamFiber.Web.csproj</ProjectItemSpec> <ProjectVersionSpec>LFabrikamFiber_BuildAndPublish_20130813@$/WorkInProgress</ProjectVersionSpec> </TfsSourceControl> </SourceControl> Git GitSourceControl: umístění GitSourceControl schématu RepositoryUrl: The identifikátor URI pro Team Foundation Server, kolekce projektu a úložiště Git ProjectPath: cesta k souboru svou aplikaci projektu (CSPROJ nebo VBPROJ) CommitId: id pro vaše potvrzení Příklad: <SourceControl type="Git"> <GitSourceControl xmlns="https://schemas.microsoft.com/visualstudio/deploymentevent_git/2013/09"> <RepositoryUrl>http://gittf:8080/tfs/defaultcollection/_git/FabrikamFiber</RepositoryUrl> <ProjectPath>/FabrikamFiber.CallCenter/FabrikamFiber.Web/FabrikamFiber.Web.csproj</ProjectPath> <CommitId>50662c96502dddaae5cd5ced962d9f14ec5bc64d</CommitId> </GitSourceControl> </SourceControl>
Sestavení	Informace o systému sestavení, buď "TeamBuild" nebo "MSBuild", a tyto požadované vlastnosti: BuildLabel (pro TeamBuild): název sestavení a číslo.Tento popisek slouží také jako název události nasazení.Další informace o čísla sestavení, naleznete v části Zadávání smysluplných názvů pro dokončená sestavení s použitím čísel sestavení. SymbolPath (doporučeno): seznam identifikátorů URI pro umístění symboly (soubor PDB) oddělených středníky.Je možné, že tyto identifikátory URI jsou adresy URL nebo UNC.To výrazně zjednodušuje pro sadu Visual Studio najít odpovídající symboly vám pomůže při ladění. BuildReportUrl (pro TeamBuild): umístění sestavy sestavení do sady TFS BuildId (pro TeamBuild): v serveru TFS podrobné informace identifikátor URI pro sestavení.Tento identifikátor URI slouží také jako ID události nasazení.To musí id musí být jedinečný, pokud nepoužíváte TeamBuild. BuiltSolution: cesta k souboru řešení sadou Visual Studio použije k vyhledání a otevřete odpovídající řešení.Toto je obsah vlastnosti MSBuild SolutionPath. Příklad: SADY TFS <Build type="TeamBuild"> <MsBuild> <BuildLabel kind="label">FabrikamFiber_BuildAndPublish_20130813.1</BuildLabel> <SymbolPath>\\fabrikamfiber\FabrikamFiber.CallCenter\Symbols</SymbolPath> <BuildReportUrl kind="informative, url" url="http://fabrikamfiber:8080/tfs/FabrikamFiber/_releasePipeline/FindRelease?buildUri=fabrikamfiber%3a%2f%2f%2fBuild%2fBuild%2f448">Build Report Url</BuildReportUrl> <BuildId kind="id">1c4444d2-518d-4673-a590-dce2773c7744,fabrikamfiber:///Build/Build/448</BuildId> <BuiltSolution>$/WorkInProgress/FabrikamFiber/FabrikamFiber.CallCenter/FabrikamFiber.CallCenter.sln</BuiltSolution> </MsBuild> </Build> Git <Build type="MSBuild"> <MSBuild> <SymbolPath>\\gittf\FabrikamFiber.CallCenter\Symbols</SymbolPath> <BuiltSolution>/FabrikamFiber.CallCenter/FabrikamFiber.CallCenter.sln</BuiltSolution> </MSBuild> </Build>

Otázka: Proč sada Visual Studio hlásí, že je můj vybraný pracovní prostor nezpůsobilý?

Odpověď: Vybraný pracovní prostor neobsahuje žádná mapování mezi složkou správy zdrojového kódu a místní složkou.Chcete-li vytvořit mapování pro tento pracovní prostor, zvolte možnost Spravovat.V opačném případě zvolte již namapovaný pracovní prostor nebo vytvořte nový pracovní prostor.

Otázka: Proč nemohu pokračovat, dokud nevyberu kolekci týmu nebo jinou kolekci?

Odpověď: K tomu může dojít z některého z těchto důvodů:

• Sada Visual Studio není připojena k serveru TFS.

  

• Sada Visual Studio nenašla řešení nebo projekt v aktuální kolekci týmu.

  Pokud soubor manifestu sestavení (<název projektu>.Neurčí BuildInfo.config), kde sady Visual Studio můžete vyhledat odpovídající zdroj sady Visual Studio používá vaše TFS aktuálně připojených k nalezení odpovídající řešení nebo projektu.Pokud nemá aktuální kolekce týmu odpovídající zdroj, vyzve vás sada Visual Studio k připojení k jiné kolekci týmu.

• Visual Studio najít řešení nebo projekt v kolekci uvedené v souboru manifestu sestavení (<název projektu>.BuildInfo.config).

  Zadaný server TFS nemusí již mít odpovídající nebo dokonce existující zdroj. Možným důvodem je, že jste migrovali na nový server TFS.Pokud zadaný server TFS neexistuje, může přibližně po minutě vypršet časový limit sady Visual Studio a poté budete vyzváni k připojení do jiné kolekce.Chcete-li pokračovat, připojte se ke správnému serveru TFS.

  

Otázka: Co je to pracovní prostor?

Odpověď: Váš pracovní prostor ukládá kopii zdroje, takže ji můžete vyvinout a otestovat samostatně před vrácením práce se změnami.Pokud ještě nemáte pracovní prostor, který je přímo namapován na nalezené řešení nebo projekt, pak vás sada Visual Studio vyzve k výběru dostupného pracovního prostoru nebo k vytvoření nového pracovního prostoru s názvem vašeho počítače jako výchozím názvem pracovního prostoru.

Otázka: Proč se zobrazí tato zpráva o nedůvěryhodných symbolech?

O: tato zpráva se zobrazí, když cesta k symbolům v souboru manifestu sestavení (<název projektu>.BuildInfo.config) není zahrnut do seznamu důvěryhodných symbol cest.Cestu můžete přidat do seznamu cest symbolů v možnostech ladicího programu.