다음을 통해 공유

진단 모니터링 및 수집 유틸리티(dotnet-monitor)

  • 아티클

이 문서 적용 대상: ✔️ dotnet-monitor 버전 6.0.0 이상 버전

설치

dotnet-monitor를 다운로드하는 방법에는 두 가지가 있습니다.

  • dotnet 전역 도구:

    dotnet-monitor NuGet 패키지의 최신 릴리스 버전을 설치하려면 dotnet tool install 명령을 사용합니다.

    dotnet tool install --global dotnet-monitor

  • Docker 이미지:

    다중 컨테이너 환경에서 사용할 Docker 이미지를 다운로드합니다.

    docker pull mcr.microsoft.com/dotnet/monitor

개요

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

설명

dotnet-monitor 전역 도구는 프로덕션 환경에서 .NET 애플리케이션을 모니터링하고 필요에 따라 또는 지정된 조건에서 수집하기 위한 자동화된 규칙을 사용하여 진단 아티팩트(예: 덤프, 추적, 로그, 메트릭)를 수집하는 방법을 제공합니다.

옵션

  • --version

    dotnet-monitor 유틸리티의 버전을 표시합니다.

  • -h|--help

    명령줄 도움말을 표시합니다.

명령

명령
dotnet monitor collect
dotnet monitor config show
dotnet monitor generatekey

dotnet-monitor collect

.NET 애플리케이션을 모니터링하고, 진단 아티팩트를 수집할 수 있으며, 선택한 대상으로 결과를 보냅니다.

개요

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

옵션

  • -h|--help

    명령줄 도움말을 표시합니다.

  • -u|--urls <urls>

    HTTP API에 대한 바인딩입니다. 기본값은 https://localhost:52323입니다.

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

    /metrics 경로에 대한 메트릭 게시를 사용하도록 설정합니다. 기본값은 true

  • --metricUrls <urls>

    메트릭 HTTP API에 대한 바인딩입니다. 기본값은 http://localhost:52325입니다.

  • --diagnostic-port <path>

    런타임 인스턴스가 연결할 수 있는 진단 포트의 정규화된 경로 및 파일 이름입니다. 이 옵션을 지정하면 dotnet-monitor가 '수신 대기' 모드로 전환됩니다. 지정하지 않으면 dotnet-monitor는 '연결' 모드에 있습니다.

    Windows에서 이 이름은 유효한 명명된 파이프 이름이어야 합니다. Linux 및 macOS에서 유효한 Unix 도메인 소켓 경로여야 합니다.

  • --no-auth

    API 키 인증을 사용하지 않도록 설정합니다. 기본값은 false입니다.

    프로덕션 환경에서는 이 옵션을 사용하지 않는 것이 좋습니다.

  • --temp-apikey

    dotnet-monitor 인스턴스에 대한 임시 API 키를 생성합니다.

  • --no-http-egress

    HTTP 응답을 통해 진단 아티팩트 송신을 사용하지 않도록 설정합니다. 지정된 경우 송신 공급자를 사용하여 아티팩트를 송신해야 합니다.

dotnet monitor config show

이러한 매개 변수를 사용하여 dotnet-monitor collect가 실행된 것처럼 구성을 표시합니다.

개요

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

옵션

  • -h|--help

    명령줄 도움말을 표시합니다.

  • -u|--urls <urls>

    HTTP API에 대한 바인딩입니다. 기본값은 https://localhost:52323입니다.

    이 값은 구성에 urls 키로 매핑됩니다.

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

    /metrics 경로에 대한 메트릭 게시를 사용하도록 설정합니다. 기본값은 true입니다.

    이 값은 구성에 Metrics:Enabled 키로 매핑됩니다.

  • --metricUrls <urls>

    메트릭 HTTP API에 대한 바인딩입니다. 기본값은 http://localhost:52325입니다.

    이 값은 구성에 Metrics:Endpoints 키로 매핑됩니다.

  • --diagnostic-port <path>

    런타임 인스턴스가 연결할 수 있는 진단 포트의 정규화된 경로 및 파일 이름입니다. 이 옵션을 지정하면 dotnet-monitor가 '수신 대기' 모드로 전환됩니다. 지정하지 않으면 dotnet-monitor는 '연결' 모드에 있습니다.

    Windows에서 이 이름은 유효한 명명된 파이프 이름이어야 합니다. Linux 및 macOS에서 유효한 Unix 도메인 소켓 경로여야 합니다.

    이 값은 구성에 DiagnosticPort:EndpointName 키로 매핑됩니다.

  • --no-auth

    API 키 인증을 사용하지 않도록 설정합니다. 기본값은 false입니다.

    프로덕션 환경에서는 이 옵션을 사용하지 않는 것이 좋습니다.

    이 값은 구성에 매핑되지 않습니다.

  • --temp-apikey

    dotnet-monitor 인스턴스에 대한 임시 API 키를 생성합니다.

    이 값은 구성에 Authentication:MonitorApiKey 키로 매핑됩니다.

  • --no-http-egress

    HTTP 응답을 통해 진단 아티팩트 송신을 사용하지 않도록 설정합니다. 지정된 경우 송신 공급자를 사용하여 아티팩트를 송신해야 합니다.

    이 값은 구성에 매핑되지 않습니다.

  • --level

    구성 수준. Full 구성은 중요한 정보를 표시할 수 있습니다. 다음 두 가지 수준이 있습니다.

    • Full - 값을 수정하지 않은 전체 구성입니다.
    • Redacted - 전체 구성이지만 알려진 비밀과 같은 중요한 정보가 수정됩니다.

  • --show-sources

    각 유효 구성 값이 제공되는 구성 원본을 식별합니다.

dotnet-monitor generatekey

HTTP 인증을 위한 API 키 및 해시를 생성합니다.

개요

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

옵션

  • -h|--help

    명령줄 도움말을 표시합니다.

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

    API 키 정보가 표준 출력에 기록되는 출력 형식입니다.

    허용되는 값은 다음과 같습니다.

    • Cmd - Windows 명령 프롬프트 또는 일괄 처리 파일에서 사용할 수 있는 형식으로 출력됩니다.
    • Json - JSON 개체 형식으로 출력됩니다.
    • MachineJson - 주석 및 설명 없이 JSON 개체 형식으로 출력됩니다. 자동화 시나리오에 유용합니다.
    • PowerShell - PowerShell 프롬프트 및 스크립트에서 사용할 수 있는 형식으로 출력됩니다.
    • Shell - Bash와 같은 Linux 셸에서 사용할 수 있는 형식으로 출력합니다.
    • Text - 일반 텍스트 형식으로 출력됩니다.

참고 항목