IntelliTrace tek başına toplayıcıyı kullanarak üretimde tanılama verileri toplama

Makale
11/25/2015

Tek başına IntelliTrace Toplayıcı uygulamalarınızı için IntelliTrace Tanılama veri üretim sunucularına veya diğer ortamlar üzerinde hedef makinede Visual Studio yükleme ve hedef sistemin ortam değiştirme olmadan toplama olanak tanır.Tek başına IntelliTrace Toplayıcı web, SharePoint, WPF ve Windows Forms uygulamaları çalışır.Veri toplama bitirdiğinizde, yalnızca kaldırmak için toplayıcı silin.

IntelliTrace eylemi izleyin: toplama ve hata ayıklama (kanal 9 video) üretimdeki IntelliTrace verilerini analiz

[!NOT]

Ayrıca web ve SharePoint uygulamaları kullanarak uzak makinelerde çalıştırmak için aynı IntelliTrace verileri toplayabilir Microsoft İzleme Aracısı içinde İzleme modu.

Aracı çalıştırarak performans ilgili olayları IntelliTrace veri toplayabilir İzleyici modu.İzleyici modu olan küçük daha etkilidir İzleme modu veya tek başına IntelliTrace Toplayıcı.Yüklendiğinde Microsoft İzleme Aracısı hedef sistemin ortam değiştirir.Bakın Microsoft İzleme Aracısı'nı kullanarak üretimde IntelliTrace tanılama ve performans verilerini toplama.

Gereksinimler

.NET Framework
Visual Studio Ultimate .iTrace dosyaları açmak için 2015 bir geliştirme veya diğer bilgisayarda

[!NOT]

Simge (.pdb) dosyaları kaydetmek emin olun.IntelliTrace ile hata ayıklama ve kod arasında için kaynak dosyalarını ve simge dosyaları eşleşen olması gerekir.Bakın Sürümünüzü dağıtım sonrası sorunları tanılamak üzere ayarlama.

SIK SORULAN SORULAR

Toplayıcı ile hangi uygulamalar çalışıyor?
Nasıl başlayabilirim?
En çok veri Uygulamam yavaşlatmadan nasıl alabilirim?
IntelliTrace verilerini başka nereden alabilirim?

Toplayıcı ile hangi uygulamalar çalışıyor?

Internet Information Services (IIS) barındırılan ASP.NET Web uygulamaları
SharePoint 2010 ve SharePoint 2013 uygulamaları
Windows Presentation Foundation (WPF) ve Windows uygulamaları oluşturur.

Nasıl başlayabilirim?

Toplayıcı yükleyin.
Toplayıcı dizini için izinler ayarlayın.
Web uygulamaları ve SharePoint uygulamaları için IntelliTrace PowerShell cmdlet'leri yükleyin.
.İTrace dosya dizin için izinler ayarlayın.
Bir Web uygulaması veya SharePoint uygulamadan verilerini topla.

-veya-

Yönetilen bir app verilerini topla.
Visual Studio Ultimate içinde .iTrace dosyayı açın.

Toplayıcı yükleyin

Örneğin, uygulamanızın sunucuda Toplayıcı dizini oluşturun: C:\IntelliTraceCollector
Toplayıcı Microsoft Download Center veya Visual Studio 2103 Update 3 yükleme klasörü alın.Visual Studio 2013 Update 4 için IntelliTrace Toplayıcı:
- Microsoft İndirme Merkezi:
  1. Yanındaki IntelliTraceCollector.exe, seçin karşıdan.
  2. Örneğin, IntelliTraceCollector.exe Toplayıcı dizinine kaydedin: C:\IntelliTraceCollector
  3. IntelliTraceCollector.exe çalıştırın.Bu IntelliTraceCollection.cab dosya ayıklar.
  - veya -
- Visual Studio yükleme klasörü:
  1. IntelliTraceCollection.cab aşağıdaki klasörüne kopyalayın:
    
    ..\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\IntelliTrace\12.0.0
  2. Örneğin, IntelliTraceCollection.cab Toplayıcı dizininde koyun: C:\IntelliTraceCollector
IntelliTraceCollection.cab genişletin:
1. Uygulamanızın sunucuda yönetici olarak bir komut istemi penceresi açın.
2. Toplayıcı dizinine, örneğin göz atın: C:\IntelliTraceCollector
3. Kullanım expand komutu, nokta ile birlikte (.) IntelliTraceCollection.cab genişletmek için sonunda:
  
  /f:* IntelliTraceCollection.cab genişletin.
  
  [!NOT]
  
  Süre (.) yerelleştirilmiş toplama planları içeren alt klasörleri korur.

Toplayıcı dizini için izinleri ayarla

Uygulamanızın sunucuda yönetici olarak bir komut istemi penceresi açın.
Windows kullanın icacls sunucu Toplayıcı dizini yönetici tam izin vermek için komutu.Örneğin:

Icacls "C:\IntelliTraceCollector" / GRANT "< Domain\AdministratorID >": F
Bir Web uygulaması veya SharePoint uygulama verilerini toplamak için:
1. IntelliTrace PowerShell cmdlet'leri Toplayıcı dizine tam izinleri çalışır kişiyle verin.
  
  Örneğin:
  
  Icacls "C:\IntelliTraceCollector" / GRANT "< etkialanı\kullanıcıkimliği >": F
2. Uygulama havuzu için Web uygulaması verin veya SharePoint uygulama okuma ve Yürütme izinleri Toplayıcı dizinine.
  
  Örneğin:
  - Bir Web uygulamasında için DefaultAppPool uygulama havuzu:
    
    ICACLS "C:\IntelliTraceCollector" / GRANT "IIS APPPOOL\DefaultAppPool": RX
  - Bir SharePoint uygulamanın SharePoint - 80 uygulama havuzu:
    
    ICACLS "C:\IntelliTraceCollector" / GRANT "IIS APPPOOL\SharePoint - 80": RX

Web uygulamaları veya SharePoint Ağ uygulamaları için veri toplamak üzere IntelliTrace PowerShell cmdlet'leri yükle

Uygulamanızın sunucuda PowerShell etkin olduğundan emin olun.Çoğu Windows Server sürümlerinde, bu özelliği ekleyebilirsiniz Sunucu Yöneticisi yönetim aracı.
IntelliTrace PowerShell cmdlet'leri yükleyin.
1. Yönetici olarak bir PowerShell komut penceresi açın.
  1. Seçin Başlat, Tüm Programlar, Donatılar, Windows PowerShell.
  2. Aşağıdaki adımları birini seçin:
    - 64-bit işletim sistemlerinde açmak için kısayol menüsünü Windows PowerShell.Seçin yönetici olarak çalıştır.
    - 32-bit işletim sistemlerinde açmak için kısayol menüsünü Windows PowerShell (x 86).Seçin yönetici olarak çalıştır.
2. PowerShell komut penceresinde kullanmak Import-Module içeri aktarmak için komutu Microsoft.VisualStudio.IntelliTrace.PowerShell.dll.
  
  Örneğin:
  
  Import-Module "C:\IntelliTraceCollector\Microsoft.VisualStudio.IntelliTrace.PowerShell.dll"

.iTrace dosya dizini için izinleri ayarla

Örneğin, uygulamanızın sunucuda .iTrace dosya dizin oluşturun: C:\IntelliTraceLogFiles

[!NOT]

Uygulamanızı yavaşlamasını önlemek için çok etkin olmayan bir yerel diskte yüksek hızlı bir konum seçin.

Aynı yerde .iTrace dosyaları ve Toplayıcı dosyaları put.Ancak, bir Web uygulaması veya SharePoint uygulama varsa, bu yer uygulamasını barındıran dizini dışında olduğundan emin olun.

Güvenlik Notu
Toplayıcı ile çalışması gereken kimliklerin .iTrace dosya dizin sınırlayın.IntelliTrace yöntem parametreleri veya dönüş değeri olarak başarılı herhangi bir veri kaydedebilirsiniz olduğundan .iTrace dosya verileri kullanıcılar, veritabanlarını, diğer kaynağı konumları ve bağlantı dizeleri gibi gizli bilgiler içerebilir. Gizli verileri görüntülemek için yetki .iTrace dosyaları açmak için bu olduğundan emin olun..İTrace dosya paylaşımı dikkatli olun.Diğer kişilerin erişimi olmalıdır, dosyaları paylaşılan güvenli bir konuma kopyalayın.

Toplayıcı ile çalışması gereken kimliklerin .iTrace dosya dizin sınırlayın.IntelliTrace yöntem parametreleri veya dönüş değeri olarak başarılı herhangi bir veri kaydedebilirsiniz olduğundan .iTrace dosya verileri kullanıcılar, veritabanlarını, diğer kaynağı konumları ve bağlantı dizeleri gibi gizli bilgiler içerebilir.
Gizli verileri görüntülemek için yetki .iTrace dosyaları açmak için bu olduğundan emin olun..İTrace dosya paylaşımı dikkatli olun.Diğer kişilerin erişimi olmalıdır, dosyaları paylaşılan güvenli bir konuma kopyalayın.

Bir Web uygulaması veya SharePoint uygulama için uygulama havuzu .iTrace dosya dizin tam erişim izinleri verin.Windows kullanabileceğiniz icacls komutu veya Windows Explorer'ı (veya dosya Gezgini) kullanın.

Örneğin:
- Windows ile izinleri ayarlamak için icacls komutu:
  - Bir Web uygulamasında için DefaultAppPool uygulama havuzu:
    
    ICACLS "C:\IntelliTraceLogFiles" / GRANT "IIS APPPOOL\DefaultAppPool": F
  - Bir SharePoint uygulamanın SharePoint - 80 uygulama havuzu:
    
    ICACLS "C:\IntelliTraceLogFiles" / GRANT "IIS APPPOOL\SharePoint - 80": F
  -veya-
- Windows Explorer'ı (veya dosya Gezgini) izinleriyle ayarlamak için:
  1. Açık özellikleri .iTrace dosya dizin için.
  2. Üzerinde Güvenlik sekmesinde, seçin Düzenle, Ekle.
  3. Emin olun yerleşik güvenlik ilkeleri görünür Bu nesne türünü seçin kutusu.Bu sahip değil, seçerseniz nesne türlerini ekleyin.
  4. Yerel bilgisayarınızın emin olun, görüntülenir Bu konumdan kutusu.Bu sahip değil, seçerseniz konumları değiştirmek için.
  5. İçindeki seçmek için nesne adlarını girin kutusuna Web uygulaması veya SharePoint uygulamanın uygulama havuzunu ekleyin.
  6. Seçin Adları Denetle adı çözümlenemedi.Seçin Tamam.
  7. Uygulama havuzu olduğundan emin olun Tam Denetim.

Bir Web uygulamasından ya da SharePoint uygulamasından veri topla

Veri toplamaya başlamak için yönetici olarak bir PowerShell komut penceresi açın, ardından bu komutu çalıştırın:

Başlangıç IntelliTraceCollection"< ApplicationPool >"< PathToCollectionPlan >< FullPathToITraceFileDirectory >

Önemli
Bu komutu çalıştırdıktan sonra türü Y veri toplamaya başlamak istediğiniz onaylamak için.

Örneğin, bir SharePoint uygulamasında veri toplamak amacıyla SharePoint - 80 uygulama havuzu:

Başlangıç-IntelliTraceCollection "SharePoint - 80" "C:\IntelliTraceCollector\collection_plan.ASP.NET.default.xml" "C:\IntelliTraceLogFiles"

ApplicationPool

Uygulamanızın çalıştığı uygulama havuzu adı

PathToCollectionPlan

Bir toplama planı Toplayıcı ayarlarını yapılandırır bir .xml dosyası yolu.

Toplayıcı ile birlikte gelen bir plan belirtebilirsiniz.Web uygulamaları ve SharePoint uygulamaları için şu planlarını iş:

collection_plan.ASP.NET.default.XML

Yalnızca IntelliTrace olayları ve özel durumları, veritabanı çağrılarının ve Web sunucusu isteklerinin dahil olmak üzere, SharePoint olayları toplar.
collection_plan.ASP.NET.Trace.XML

İşlev çağrılarını toplar ve collection_plan.ASP.NET.default.xml tüm verileri.Bu planı için ayrıntılı bir analiz iyi, ancak uygulamanızı daha fazla collection_plan.ASP.NET.default.xml aşağı yavaşlatabilir.

Uygulamanızı yavaşlamasını kaçınmak için bu planlar özelleştirebilir veya kendi planınızı oluşturabilirsiniz.Güvenlik için herhangi bir özel plan Toplayıcı dosyaları güvenli aynı konuma yerleştirin.Bakın oluşturma ve özelleştirme IntelliTrace toplama planları ve nasıl bulabilirim en veri Uygulamam yavaşlatmadan?

[!NOT]

Varsayılan olarak, .iTrace dosyasının en büyük boyutu 100 MB ' dir..İTrace dosyası bu sınıra ulaştığında, daha yeni girişler için boş alan açmak için eski girişleri dosyanın Toplayıcı siler.Bu sınır değiştirmek için toplama planın Düzenle MaximumLogFileSize özniteliği.

Bu koleksiyon planlar yerelleştirilmiş sürümlerini nereden bulabilirim?

Yerelleştirilmiş planları toplayıcının klasörlerdeki bulabilirsiniz.

FullPathToITraceFileDirectory

.İTrace dosya dizinin tam yolu.

Güvenlik Notu
Tam yolu, göreli bir yol sağlar.

Toplayıcı uygulama havuzu için ekler ve veri toplama başlatır.

Şu anda .iTrace dosya açabilir miyim? Hayır, dosya sırasında veri toplama kilitlendi.

Sorunu yeniden.
Anlık .iTrace dosyanın almak için şu sözdizimini kullanın:

Kontrol noktası IntelliTraceCollection"< ApplicationPool >"
Toplama durumunu denetlemek için şu sözdizimini kullanın:

Get-IntelliTraceCollectionStatus

Veri toplama durdurmak için şu sözdizimini kullanın:

Stop-IntelliTraceCollection"< ApplicationPool >"

Önemli
Bu komutu çalıştırdıktan sonra türü Y verilerinin toplanması durdurmak istediğinizden onaylamak için.Aksi takdirde, Toplayıcı iTrace veri topladığı dosya kilitli kalacaktır veya dosya faydalı bilgiler içermeyebilir devam edebilir.

Visual Studio Ultimate içinde .iTrace dosyayı açın.

Yönetilen bir app verilerini topla

Uygulamanızı başlatmak ve aynı zamanda verilerini toplamak için şu sözdizimini kullanın:

< FullPathToIntelliTraceCollectorExecutable >\IntelliTraceSC.exe Başlat/CP:< PathToCollectionPlan >/f:< FullPathToITraceFileDirectoryAndFileName >< PathToAppExecutableFileAndFileName >

Örneğin, bir app verilerini toplamak için adlı Uygulamam:

/F:"C:\IntelliTraceLogFiles\MyApp.itrace C:\IntelliTraceCollector\IntelliTraceSC.exe /cp:"C:\IntelliTraceCollector\collection_plan.ASP.NET.default.xml Başlat"" "C:\MyApp\MyApp.exe"

FullPathToIntelliTraceCollectorExecutable

Toplayıcı yürütülebilir, IntelliTraceSC.exe tam yolu

PathToCollectionPlan

Bir toplama planı Toplayıcı ayarlarını yapılandırır bir .xml dosyası yolu.

Toplayıcı ile birlikte gelen bir plan belirtebilirsiniz.Aşağıdaki planlar yönetilen uygulamalar için çalışma:

collection_plan.ASP.NET.default.XML

Yalnızca, IntelliTrace olayları özel durumları, veritabanı çağrılarının ve Web sunucusu isteklerinin dahil olmak üzere görüntüler.
collection_plan.ASP.NET.Trace.XML

İşlev çağrılarını toplar ve collection_plan.ASP.NET.default.xml tüm verileri.Bu planı için ayrıntılı bir analiz iyi, ancak uygulamanızı daha fazla collection_plan.ASP.NET.default.xml aşağı yavaşlatabilir.

[!NOT]

Varsayılan olarak, .iTrace dosyasının en büyük boyutu 100 MB ' dir..İTrace dosyası bu sınıra ulaştığında, daha yeni girişler için boş alan açmak için eski girişleri dosyanın Toplayıcı siler.Bu sınır değiştirmek için toplama planın Düzenle MaximumLogFileSize özniteliği.

Bu koleksiyon planlar yerelleştirilmiş sürümlerini nereden bulabilirim?

Yerelleştirilmiş planları toplayıcının klasörlerdeki bulabilirsiniz.

FullPathToITraceFileDirectoryAndFileName

.İTrace dosya dizinini ve .iTrace dosya adı ile tam yolu .itrace uzantısı.

Güvenlik Notu
Tam yolu, göreli bir yol sağlar.

PathToAppExecutableFileAndFileName

Yönetilen uygulamanızı yolunu ve dosya adı

Veri toplama uygulama çıkılarak durdurun.
Visual Studio Ultimate içinde .iTrace dosyayı açın.

Visual Studio Ultimate'te .iTrace dosyasını açın

[!NOT]

IntelliTrace ile hata ayıklama ve kod arasında için kaynak dosyalarını ve simge dosyaları eşleşen olması gerekir.Bakın Sürümünüzü dağıtım sonrası sorunları tanılamak üzere ayarlama.

.İTrace dosya Taşı veya Visual Studio Ultimate ile bir bilgisayara kopyalayın.
Visual Studio dışında .iTrace dosyasını çift tıklatın veya dosya açma Visual Studio içinde.

Visual Studio gösterir IntelliTrace Özet sayfa.Çoğu bölümlerde olayları veya diğer öğeleri gözden geçirin, bir öğe seçin ve kullanabilirsiniz IntelliTrace ile noktasında hata ayıklamaya başlamak yerde ve her zaman bir olay oluştu.Bakın Kaydedilen IntelliTrace verilerini kullanarak uygulamanızın hatalarını ayıklama.

[!NOT]

IntelliTrace ile hata ayıklama ve kod arasında için kaynak dosyalarını ve geliştirme makinenizde dosyaları simgesi eşleşen olması gerekir.Bakın Sürümünüzü dağıtım sonrası sorunları tanılamak üzere ayarlama.

En çok veri Uygulamam yavaşlatmadan nasıl sağlarım?

Uygulamanızın performansına etkisi IntelliTrace toplar veri ve onu çözümler kod türü bağlıdır için IntelliTrace çok sayıda verileri toplayabilir.Bakın IntelliTrace toplamasını üretim sunucularında en iyi duruma getirme.

Uygulamanızı yavaşlatmadan en çok veri almak için bazı yollar şunlardır:

Toplayıcı yalnızca bir sorun var. ne zaman ya da sorunu yeniden çalıştırın.

Koleksiyonunu başlatmak, sorunu yeniden ve ardından toplamasını durdur.Visual Studio Ultimate içinde .iTrace dosyayı açın ve verileri inceleyin.Bakın Visual Studio Ultimate IntelliTrace günlük dosyasını açın..
Web uygulamaları ve SharePoint uygulamaları için belirtilen uygulama havuzu paylaşan her uygulama için veri toplayıcı kaydeder.Modüller tek bir uygulama için yalnızca bir toplama planında belirtebilirsiniz olsa da bu aynı uygulama havuzunda paylaşan herhangi bir uygulama yavaşlatabilir.

Diğer uygulamaları yavaşlamasını öğesinden Toplayıcı önlemek için her uygulama kendi uygulama havuzunda ana bilgisayar.
Olayları gözden geçirin toplama planında kendisi için IntelliTrace verilerini toplar.Sizi ilgilendiren yok veya ilgili olmayan olayları devre dışı bırakmak için toplama planı düzenleyin.

Bir olay devre dışı bırakmak için ayarlanan enabled için öznitelik <DiagnosticEventSpecification> öğesine false:

<DiagnosticEventSpecification enabled="false">

Varsa enabled öznitelik yoksa, Olay etkinleştirildi.

Nasıl bu performansını?
- Başlangıç saati uygulamaya ilgili olmayan olayları devre dışı bırakarak azaltır.Örneğin, Windows iş akışını kullanmayan uygulamalar için Windows iş akışı olayları devre dışı bırakın.
- Kayıt defterine erişim ancak kayıt defteri ayarları ile ilgili sorunları gösterme uygulamalar için kayıt defteri olayları devre dışı bırakarak hem Başlangıç hem de çalışma zamanı performansı geliştirebilir.
Kendisi için IntelliTrace verilerini toplar toplama planında modülleri inceleyin.Sizi ilgilendiren modülleri dahil etmek için toplama planı düzenleyin:
1. Toplama planı açın.Bulma <ModuleList> öğesi.
2. İçindeki <ModuleList>, ayarlayın isExclusionList özniteliğini false.
3. Kullanım <Name> öğenin her modülü aşağıdakilerden birini belirtin: dosya adı, bu dize veya ortak anahtar adı içeren herhangi bir modül dahil edilecek dize değeri.
Örneğin, yalnızca ana Web modülünden Fabrikam Fiber Web uygulamasının veri toplamak için bunun gibi bir liste oluşturun:
```
<ModuleList isExclusionList="false">
   <Name>FabrikamFiber.Web.dll</Name>
</ModuleList>
```
"Fabrikam" adı içeren modülünden veri toplamak için bunun gibi bir liste oluşturun:
```
<ModuleList isExclusionList="false">
   <Name>Fabrikam</Name>
</ModuleList>
```
Kendi ortak anahtar belirteci belirterek modüllerinden veri toplamak için bunun gibi bir liste oluşturun:
```
<ModuleList isExclusionList="false">
   <Name>PublicKeyToken:B77A5C561934E089</Name>
   <Name>PublicKeyToken:B03F5F7F11D50A3A</Name>
   <Name>PublicKeyToken:31BF3856AD364E35</Name>
   <Name>PublicKeyToken:89845DCD8080CC91</Name>
   <Name>PublicKeyToken:71E9BCE111E9429C</Name>
</ModuleList>
```
Nasıl bu performansını?

Bu yöntem çağrı bilgileri ve uygulamayı başlatır ve çalışır, IntelliTrace toplayan diğer araçları veri miktarını azaltır.Bu veriler şunları sağlar:
- Kodlardan verilerini topladıktan sonra adım.
- Geçirilen ve işlev çağrıları döndürülen değerler inceleyin.
Neden modülleri yerine bırakılsın mı?

Varsayılan olarak, toplama planları modülleri ayarlayarak dışarıda isExclusionList özniteliğini true.Ancak, modüller hariç yine de listenin ölçütleri karşılayan yoksa ve, üçüncü taraf veya açık kaynaklı modülleri gibi ilginizi değil modülleri'den veri toplama neden olabilir.
IntelliTrace toplama olmayan herhangi bir veri var mı?

Evet, performans etkisinin azalmasına, IntelliTrace veri değerlerine geçirilen ve geçirilen ve yöntemleri döndürülen en üst düzey nesneler üzerinde yöntemleri ilk ve son alanlarda basit veri türlerinin değerlerini döndürülen temel veri türleri koleksiyonunu kısıtlar.

Örneğin, olduğunuz varsayalım bir AlterEmployee kabul eden bir tamsayı yöntem imzası id ve bir Employee nesne oldemployee:

public Employee AlterEmployee(int id, Employee oldemployee)

Employee Türü öznitelikleri şunlardır: Id, Name, ve HomeAddress.Arasında bir ilişki ilişki var Employee ve Address türü.

Toplayıcı değerleri kaydeder id, Employee.Id, Employee.Name ve Employee döndürülen nesne AlterEmployee yöntemi.Toplayıcı hakkında bilgi ancak kaydetmez Address olup olmadığını null olduğu dışında nesne.Toplayıcı de yerel değişkenleri ilgili verileri kaydetmez AlterEmployee yöntemi sürece, bu noktada, yöntem parametreleri olarak kaydedilir parametre olarak, yerel değişkenleri diğer yöntemleri kullanabilirsiniz.