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

  • Makale

Bu makale şunlar için geçerlidir: ✔️ dotnet-monitor sürüm 6.0.0 ve sonraki 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>

Description

Genel dotnet-monitor araç, üretim ortamlarındaki .NET uygulamalarını izlemenin ve isteğe bağlı olarak tanılama yapıtlarını (dökümler, izlemeler, günlükler ve ölçümler gibi) 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ım gösterir.

Komutlar

Komut
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ım gösterir.

  • -u|--urls <urls>

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

  • -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. http://localhost:52325 varsayılan değerdir.

  • --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 'bağlan' 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. false varsayılan değerdir.

    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ışı yapılmalıdır.

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ım gösterir.

  • -u|--urls <urls>

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

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

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

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

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

  • --metricUrls <urls>

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

    Bu değer, anahtar olarak yapılandırmaya 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 'bağlan' 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, anahtar olarak yapılandırmaya DiagnosticPort:EndpointName eşlenir.

  • --no-auth

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

    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, anahtar olarak yapılandırmaya 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ışı yapılmalıdır.

    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 tadil edilmeden 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ım gösterir.

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

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

    İzin verilebilen değerler şunlardır:

    • Cmd - Windows Komut İstemi veya toplu iş dosyalarında kullanılabilen 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ılabilen bir biçimde çıkışlar.
    • Text - Düz metin biçiminde çıkışlar.

Ayrıca Bkz.