Tanılama izleme ve toplama yardımcı programı (dotnet-monitor)

  • Makale

Bu makale şunlar için geçerlidir: ✔️ dotnet-monitor sürüm 6.0.0 ve üzeri sürümler

Yükleme

İndirmenin dotnet-monitoriki yolu vardır:

  • dotnet genel aracı:

    NuGet paketinin en son sürüm sürümünü dotnet-monitor yüklemek için dotnet tool install komutunu kullanın:

    dotnet tool install --global dotnet-monitor

  • Docker görüntüsü:

    Çok kapsayıcılı ortamlarda kullanmak üzere bir Docker görüntüsü indirin:

    docker pull mcr.microsoft.com/dotnet/monitor

Özet

dotnet-monitor [-h|--help] [--version] <command>

Açıklama

Genel dotnet-monitor araç, üretim ortamlarındaki .NET uygulamalarını izlemenin ve tanılama yapıtlarını (örneğin, dökümler, izlemeler, günlükler ve ölçümler) isteğe bağlı olarak toplamanın veya belirtilen koşullar altında toplama için otomatik kuralları kullanmanın bir yoludur.

Seçenekler

  • --version

    dotnet-monitor yardımcı programının sürümünü görüntüler.

  • -h|--help

    Komut satırı yardımlarını gösterir.

Komutlar

Command
dotnet monitor collect
dotnet monitor config show
dotnet monitor generatekey

dotnet-monitor collect

.NET uygulamalarını izleyin, tanılama yapıtlarının toplanmasına izin verin ve sonuçları seçilen bir hedefe gönderin.

Özet

dotnet-monitor collect [-h|--help] [-u|--urls] [-m|--metrics] [--metricUrls] [--diagnostic-port] [--no-auth] [--temp-apikey] [--no-http-egress]

Seçenekler

  • -h|--help

    Komut satırı yardımlarını gösterir.

  • -u|--urls <urls>

    HTTP api'sinin bağlamaları. Varsayılan https://localhost:52323 değeridir.

  • -m|--metrics [true|false]

    Yönlendirmek için ölçümlerin yayımlanmasını /metrics etkinleştirin. Varsayılan değer: true

  • --metricUrls <urls>

    Ölçümler HTTP api'sine yönelik bağlamalar. Varsayılan http://localhost:52325 değeridir.

  • --diagnostic-port <path>

    Çalışma zamanı örneklerinin bağlanabileceği tanılama bağlantı noktasının tam yolu ve dosya adı. Bu seçeneğin belirtilmesi "dinleme" moduna geçer dotnet-monitor . Belirtilmediğinde ' dotnet-monitor connect' modundadır.

    Windows'da, bu geçerli bir adlandırılmış kanal adı olmalıdır. Linux ve macOS'ta, bu geçerli bir Unix Etki Alanı Yuvası yolu olmalıdır.

  • --no-auth

    API anahtarı kimlik doğrulamayı devre dışı bırakır. Varsayılan false değeridir.

    Bu seçeneğin üretim ortamlarında kullanılmaması kesinlikle önerilir.

  • --temp-apikey

    Örnek için dotnet-monitor geçici bir API anahtarı oluşturur.

  • --no-http-egress

    HTTP yanıtı aracılığıyla tanılama yapıtlarının çıkışını devre dışı bırakır. Belirtildiğinde, yapıtların çıkış sağlayıcısı kullanılarak çıkışlanması gerekir.

dotnet-monitor yapılandırma gösterisi

Yapılandırmayı, bu parametrelerle yürütülür gibi dotnet-monitor collect gösterir.

Özet

dotnet-monitor config show [-h|--help] [-u|--urls] [-m|--metrics] [--metricUrls] [--diagnostic-port] [--no-auth] [--temp-apikey] [--no-http-egress] [--level] [--show-sources]

Seçenekler

  • -h|--help

    Komut satırı yardımlarını gösterir.

  • -u|--urls <urls>

    HTTP api'sinin bağlamaları. Varsayılan https://localhost:52323 değeridir.

    Bu değer, yapılandırmaya anahtar olarak urls eşlenir.

  • -m|--metrics [true|false]

    Yönlendirmek için ölçümlerin yayımlanmasını /metrics etkinleştirin. Varsayılan true değeridir.

    Bu değer, yapılandırmaya anahtar olarak Metrics:Enabled eşlenir.

  • --metricUrls <urls>

    Ölçümler HTTP api'sine yönelik bağlamalar. Varsayılan http://localhost:52325 değeridir.

    Bu değer, yapılandırmaya anahtar olarak Metrics:Endpoints eşlenir.

  • --diagnostic-port <path>

    Çalışma zamanı örneklerinin bağlanabileceği tanılama bağlantı noktasının tam yolu ve dosya adı. Bu seçeneğin belirtilmesi "dinleme" moduna geçer dotnet-monitor . Belirtilmediğinde ' dotnet-monitor connect' modundadır.

    Windows'da, bu geçerli bir adlandırılmış kanal adı olmalıdır. Linux ve macOS'ta, bu geçerli bir Unix Etki Alanı Yuvası yolu olmalıdır.

    Bu değer, yapılandırmaya anahtar olarak DiagnosticPort:EndpointName eşlenir.

  • --no-auth

    API anahtarı kimlik doğrulamayı devre dışı bırakır. Varsayılan false değeridir.

    Bu seçeneğin üretim ortamlarında kullanılmaması kesinlikle önerilir.

    Bu değer yapılandırmaya eşlenmez.

  • --temp-apikey

    Örnek için dotnet-monitor geçici bir API anahtarı oluşturur.

    Bu değer, yapılandırmaya anahtar olarak Authentication:MonitorApiKey eşlenir.

  • --no-http-egress

    HTTP yanıtı aracılığıyla tanılama yapıtlarının çıkışını devre dışı bırakır. Belirtildiğinde, yapıtların çıkış sağlayıcısı kullanılarak çıkışlanması gerekir.

    Bu değer yapılandırmaya eşlenmez.

  • --level

    Yapılandırma düzeyi. Full yapılandırması hassas bilgileri gösterebilir. İki düzey vardır:

    • Full - Herhangi bir değerin yeniden tasfiyesi olmadan tam yapılandırma.
    • Redacted - Tüm yapılandırma ancak bilinen gizli diziler gibi hassas bilgiler yeniden oluşturulur.

  • --show-sources

    Her etkin yapılandırma değerinin hangi yapılandırma kaynağından sağlandığını tanımlar.

dotnet-monitor generatekey

HTTP kimlik doğrulaması için bir API anahtarı ve karma oluşturun.

Özet

dotnet-monitor generatekey [-h|--help] [-o|--output]

Seçenekler

  • -h|--help

    Komut satırı yardımlarını gösterir.

  • -o|--output <Cmd|Json|MachineJson|PowerShell|Shell|Text>

    API anahtarı bilgilerinin standart çıkışa yazıldığı çıkış biçimi.

    İzin verilebilen değerler şunlardır:

    • Cmd - Windows Komut İstemi veya toplu iş dosyalarında kullanılabilir biçimde çıkışlar.
    • Json - Bir JSON nesnesi biçiminde çıkışlar.
    • MachineJson - Açıklama ve açıklama içermeyen bir JSON nesnesi biçiminde çıkışlar. Otomasyon senaryoları için kullanışlıdır.
    • PowerShell - PowerShell istemlerinde ve betiklerinde kullanılabilir biçimde çıkışlar.
    • Shell - Bash gibi Linux kabuklarında kullanılabilir biçimde çıkışlar.
    • Text - Düz metin biçiminde çıkışlar.

Ayrıca bkz: