Tanılama bağlantı noktaları

Bu makale şunlar için geçerlidir: ✔️ .NET Core 3.1 ve üzeri sürümler

.NET çalışma zamanı, diğer işlemlerin tanılama komutları göndermesine ve bir IPC kanalı üzerinden yanıt almasına olanak tanıyan bir hizmet uç noktası sunar. Bu uç nokta tanılama bağlantı noktası olarak adlandırılır. Komutlar tanılama bağlantı noktasına şu şekilde gönderilebilir:

• Bir bellek dökümü yakalayın.
• EventPipe izlemesi başlatın.
• Uygulamayı başlatmak için kullanılan komut satırını isteyin.

Tanılama bağlantı noktası, platforma bağlı olarak farklı aktarımları destekler. Şu anda hem CoreCLR hem de Mono çalışma zamanı uygulamaları, Windows üzerinde Adlandırılmış Kanallar ve Linux ve macOS üzerinde Unix Etki Alanı Yuvaları'nı kullanır. Android, iOS ve tvOS'ta Mono çalışma zamanı uygulaması TCP/IP kullanır. Kanal özel bir ikili protokol kullanır. Geliştiricilerin çoğu hiçbir zaman temel kanal ve protokolle doğrudan etkileşim kurmaz, bunun yerine kendi adına iletişim kuran GUI veya CLI araçlarını kullanır. Örneğin, dotnet-dump ve dotnet-trace araçları, dökümleri yakalamak ve izlemeleri başlatmak için protokol komutlarını soyut gönderir. Özel araçlar yazmak isteyen geliştiriciler için Microsoft.Diagnostics.NETCore.Client NuGet paketi, temel alınan aktarım ve protokolün .NET API soyutlamasını sağlar.

Güvenlik konuları

Tanılama bağlantı noktası, çalışan bir uygulama hakkında hassas bilgileri kullanıma sunar. Güvenilmeyen bir kullanıcı bu kanala erişim kazanırsa, bellekteki gizli diziler de dahil olmak üzere ayrıntılı program durumunu gözlemleyebilir ve rastgele programın yürütülmesini değiştirebilir. CoreCLR çalışma zamanında, varsayılan tanılama bağlantı noktası yalnızca uygulamayı başlatan kullanıcı hesabı veya süper kullanıcı izinlerine sahip bir hesap tarafından erişilebilir olacak şekilde yapılandırılır. Güvenlik modeliniz aynı kullanıcı hesabı kimlik bilgilerine sahip diğer işlemlere güvenmiyorsa, ortam değişkenini DOTNET_EnableDiagnostics=0ayarlayarak tüm tanılama bağlantı noktalarını devre dışı bırakabilirsiniz. Bu ayar, .NET hata ayıklaması veya dotnet-* tanılama araçlarından herhangi biri gibi dış araçları kullanmanızı engeller.

Varsayılan tanılama bağlantı noktası

Windows, Linux ve macOS'ta çalışma zamanı, iyi bilinen bir uç noktada varsayılan olarak bir tanılama bağlantı noktası açar. Bu, dotnet-* tanılama araçlarının alternatif bir bağlantı noktası kullanacak şekilde açıkça yapılandırılmadığında otomatik olarak bağlandıkları bağlantı noktasıdır. Uç nokta:

• Windows - Adlandırılmış Kanal \\.\pipe\dotnet-diagnostic-{pid}
• Linux ve macOS - Unix Etki Alanı Yuvası {temp}/dotnet-diagnostic-{pid}-{disambiguation_key}-socket

{pid}ondalık olarak yazılan işlem kimliği, {temp}TMPDIR ortam değişkeni veya tanımsız/boşsa TMPDIR değerdir /tmp ve {disambiguation_key} işlem başlangıç saati ondalık olarak yazılır. macOS ve NetBSD'de, işlem başlangıç zamanı UNIX dönem süresinden bu yana saniye sayısıdır. Diğer tüm platformlarda, önyükleme zamanından bu yana karışıktır.

Başlangıçta çalışma zamanını askıya alma

Varsayılan olarak, herhangi bir tanılama aracının tanılama bağlantı noktasına bağlı olup olmadığına bakılmaksızın çalışma zamanı yönetilen kodu başlar başlamaz yürütür. Bazen, ilk program davranışını gözlemlemek için bir tanılama aracı bağlanana kadar çalışma zamanının yönetilen kodu çalıştırmayı beklemesi yararlı olabilir. Ortam değişkeninin DOTNET_DefaultDiagnosticPortSuspend=1 ayarlanması, çalışma zamanının bir araç varsayılan bağlantı noktasına bağlanana kadar beklemesine neden olur. Birkaç saniye sonra hiçbir araç eklenmezse, çalışma zamanı konsola hala bir aracın eklenmesini beklediğini açıklayan bir uyarı iletisi yazdırır.

Ek tanılama bağlantı noktalarını yapılandırma

Hem Mono hem de CoreCLR çalışma zamanları rolde connect özel yapılandırılmış tanılama bağlantı noktalarını kullanabilir. Mono, Android veya iOS üzerinde listen dotnet-dsrouter ile kullanıldığında roldeki özel TCP/IP bağlantı noktalarını da destekler. Bu özel bağlantı noktaları, kullanılabilir durumda kalan varsayılan bağlantı noktasına ek olarak bulunur. Özel bağlantı noktalarının yararlı olmasının birkaç yaygın nedeni vardır:

• Android, iOS ve tvOS'ta varsayılan bağlantı noktası yoktur, bu nedenle tanılama araçlarını kullanmak için bir bağlantı noktası yapılandırmak gerekir.
• Kapsayıcıların veya güvenlik duvarlarının olduğu ortamlarda, varsayılan bağlantı noktasının yaptığı gibi işlem kimliğine göre değişmeyen öngörülebilir bir uç nokta adresi ayarlamak isteyebilirsiniz. Daha sonra özel bağlantı noktası açıkça bir izin listesine eklenebilir veya bazı güvenlik sınırları boyunca prxied olabilir.
• İzleme araçları için aracın bir uç noktada dinlemesini sağlamak yararlı olur ve çalışma zamanı etkin bir şekilde buna bağlanmayı dener. Bu, yeni uygulamaların sürekli olarak yoklanması için izleme aracının başlatılmasını önler. Varsayılan tanılama bağlantı noktasının erişilebilir olmadığı ortamlarda, izleyiciyi izlenen her uygulama için özel bir uç noktayla yapılandırma gereksiniminden de kaçınır.

Tanılama aracı ile .NET çalışma zamanı arasındaki her iletişim kanalında bir tarafın dinleyici olması ve diğer tarafın bağlanmasını beklemesi gerekir. Çalışma zamanı, herhangi bir bağlantı noktası için rolde connect hareket etmek üzere yapılandırılabilir. (Mono çalışma zamanı, herhangi bir bağlantı noktası için rolde listen davranacak şekilde de yapılandırılabilir.) Bağlantı noktaları, bir tanılama aracının özgeçmiş komutu vermesini bekleyerek başlangıçta askıya alınacak şekilde bağımsız olarak yapılandırılabilir. Bağlanmak için yapılandırılan bağlantı noktaları, uzak uç nokta dinlenmiyorsa veya bağlantı kesilirse bağlantı girişimlerini süresiz olarak yineler. Ancak uygulama, bu bağlantının kurulmasını beklerken yönetilen kodu otomatik olarak askıya almaz. Uygulamanın bağlantı kurulmasını beklemesini istiyorsanız başlangıçta askıya alma seçeneğini kullanın.

Özel bağlantı noktaları ortam değişkeni kullanılarak DOTNET_DiagnosticPorts yapılandırılır. Bu değişken, bağlantı noktası açıklamalarının noktalı virgülle ayrılmış listesine ayarlanmalıdır. Her bağlantı noktası açıklaması, çalışma zamanının veya listen rolünü denetleyen ve çalışma zamanının connect başlangıçta askıya alınması gerekip gerekmediğini denetleyen bir uç nokta adresi ve isteğe bağlı değiştiricilerden oluşur. Windows'da uç nokta adresi, ön eki olmayan adlandırılmış bir kanalın \\.\pipe\ adıdır. Linux ve macOS'ta, Unix Etki Alanı Yuvası'nın tam yoludur. Android, iOS ve tvOS'ta adres bir IP ve bağlantı noktasıdır. Örneğin:

1. DOTNET_DiagnosticPorts=my_diag_port1 - (Windows) Çalışma zamanı adlandırılmış kanala \\.\pipe\my_diag_port1bağlanır.
2. DOTNET_DiagnosticPorts=/foo/tool1.socket;foo/tool2.socket - (Linux ve macOS) Çalışma zamanı hem Unix Etki Alanı Yuvalarına /foo/tool1.socket/foo/tool2.sockethem de öğesine bağlanır.
3. DOTNET_DiagnosticPorts=127.0.0.1:9000 - (Android, iOS ve tvOS) Çalışma zamanı, bağlantı noktası 9000'de IP 127.0.0.1'e bağlanır.
4. DOTNET_DiagnosticPorts=/foo/tool1.socket,nosuspend - (Linux ve macOS) Bu örnekte değiştirici vardır nosuspend . Çalışma zamanı, bir dış aracın oluşturduğu Unix Etki Alanı Yuvası'na /foo/tool1.socket bağlanmaya çalışır. Ek tanılama bağlantı noktaları normalde başlatma sırasında özgeçmiş komutunu beklerken çalışma zamanının askıya alınmasına neden olur, ancak nosuspend çalışma zamanının beklememesini sağlar.

Bir bağlantı noktasının tam söz dizimi şeklindedir address[,(listen|connect)][,(suspend|nosuspend)]. connect veya belirtilmezse connectlisten varsayılan değerdir (ve listen yalnızca Android veya iOS'ta Mono çalışma zamanı tarafından desteklenir). suspend veya belirtilmezse suspendnosuspend varsayılan değerdir.

dotnet tanılama araçlarında kullanım

Dotnet-dump, dotnet-counters ve dotnet-trace gibi araçlar, tanılama bağlantı noktası aracılığıyla bir .NET uygulamasıyla iletişim kuran tüm destek collect veya monitor fiilleri destekler.

• Bu araçlar bağımsız değişkenini kullandığında --processId , araç otomatik olarak varsayılan tanılama bağlantı noktası adresini hesaplar ve buna bağlanır.
• Bağımsız değişkeni belirtirken --diagnostic-port , araç verilen adresi dinler ve uygulamanızı bağlanacak şekilde yapılandırmak için ortam değişkenini kullanmanız DOTNET_DiagnosticPorts gerekir. dotnet-counters ile ilgili eksiksiz bir örnek için bkz . Tanılama Bağlantı Noktasını Kullanma.

Tanılama bağlantı noktasına ara sunucu eklemek için ds-router kullanma

Tüm dotnet-* tanılama araçları yerel Adlandırılmış Kanal veya Unix Etki Alanı Yuvası olan bir tanılama bağlantı noktasına bağlanmayı bekler. Mono genellikle yalıtılmış donanımlarda veya erişilebilir olması için TCP üzerinden ara sunucu gerektiren öykünücülerde çalışır. dotnet-dsrouter aracı, araçların bu ortamlarda kullanılabilmesi için yerel Adlandırılmış Kanal veya Unix Etki Alanı Yuvası'na TCP'ye ara sunuculuk yapabilir. Daha fazla bilgi için bkz . dotnet-dsrouter.