Application Insights Agent(구 상태 모니터 v2): 상세 지침

이 문서에서는 PowerShell 갤러리에 등록하고 ApplicationMonitor 모듈을 다운로드하는 방법을 설명합니다. 시작하는 데 필요한 가장 일반적인 매개 변수는 포함되어 있습니다. 인터넷에 액세스할 수 없는 경우를 위해 수동 다운로드 지침을 제공했습니다.

계측 키 가져오기

시작하려면 계측 키가 필요합니다. 자세한 내용은 Application Insights 리소스 만들기를 참조하세요.

참고

2025년 3월 31일에 계측 키 수집에 대한 지원이 종료됩니다. 계측 키 수집은 계속 작동하지만 이 기능에 대한 업데이트 또는 지원은 더 이상 제공되지 않습니다. 연결 문자열로 전환하여 새로운 기능을 활용합니다.

향상된 실행 정책을 통해 관리자 권한으로 PowerShell 실행

관리자 권한으로 실행

PowerShell에서 컴퓨터를 변경하려면 관리자 수준의 권한이 필요합니다.

실행 정책

  • 설명: 기본적으로 PowerShell 스크립트 실행은 비활성화되어 있습니다. 현재 범위에만 RemoteSigned 스크립트를 허용하는 것이 좋습니다.
  • 참조: 실행 정책에 대하여Set-ExecutionPolicy 정보를 참조하세요.
  • 명령: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process.
  • 선택적 매개 변수:
    • -Force. 확인 메시지를 무시합니다.

오류 예

Install-Module : The 'Install-Module' command was found in the module 'PowerShellGet', but the module could not be
loaded. For more information, run 'Import-Module PowerShellGet'.

Import-Module : File C:\Program Files\WindowsPowerShell\Modules\PackageManagement\1.3.1\PackageManagement.psm1 cannot
be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at
https:/go.microsoft.com/fwlink/?LinkID=135170.

PowerShell용 필수 구성 요소

$PSVersionTable 명령을 실행하여 PowerShell의 인스턴스를 감사합니다. 이 명령에서 생성되는 출력은 다음과 같습니다.

Name                           Value
----                           -----
PSVersion                      5.1.17763.316
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.17763.316
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

이 지침은 Windows 10 및 위에 나열된 버전을 이용하는 컴퓨터에서 작성 및 테스트되었습니다.

이러한 단계는 PowerShell 갤러리에서 모듈을 다운로드할 수 있도록 서버를 준비합니다.

참고

PowerShell 갤러리는 Windows 10, Windows Server 2016 및 PowerShell 6 이상에서 지원됩니다. 이전 버전에 대한 자세한 내용은 PowerShellGet 설치를 참조하세요.

  1. 향상된 실행 정책을 통해 관리자 권한으로 PowerShell을 실행합니다.

  2. NuGet 패키지 제공자를 설치합니다.

    • 설명: PowerShell 갤러리와 같은 NuGet 기반 리포지토리와 상호 작용하려면 이 공급자가 필요합니다.
    • 참조: Install-PackageProvider.
    • 명령: Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201.
    • 선택적 매개 변수:
      • -Proxy. 요청에 대한 프록시 서버를 지정합니다.
      • -Force. 확인 메시지를 무시합니다.

    NuGet이 설정되지 않은 경우 이 메시지가 표시됩니다.

    NuGet provider is required to continue
    PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based repositories. 
    The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or
    'C:\Users\t\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the NuGet provider by running
    'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'. Do you want PowerShellGet to install and import
    the NuGet provider now?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):
    
  3. PowerShell 갤러리를 신뢰할 수 있는 리포지토리로 구성합니다.

    • 설명: 기본적으로 PowerShell 갤러리는 신뢰할 수 없는 리포지토리입니다.
    • 참조: Set-PSRepository.
    • 명령: Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted.
    • 선택적 매개 변수:
      • -Proxy. 요청에 대한 프록시 서버를 지정합니다.

    PowerShell 갤러리를 신뢰할 수 없는 경우 이 메시지가 표시됩니다.

    Untrusted repository
    You are installing the modules from an untrusted repository. 
    If you trust this repository, change its InstallationPolicy value 
    by running the Set-PSRepository cmdlet. Are you sure you want to 
    install the modules from 'PSGallery'?
    [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):
    

    Get-PSRepository 명령을 실행하여 이 변경 내용을 확인하고 모든 PSRepositories 감사를 수행할 수 있습니다.

  4. PowerShellGet 최신 버전을 설치합니다.

    • 설명: 이 모듈에는 PowerShell 갤러리에서 다른 모듈을 가져오는 데 사용되는 도구가 포함되어 있습니다. 버전 1.0.0.1은 Windows 10 및 Windows Server와 함께 제공됩니다. 버전 1.6.0 이상이 필요합니다. 설치된 버전을 확인하려면 Get-Command -Module PowerShellGet 명령을 실행합니다.
    • 참조: PowerShellGet 설치.
    • 명령: Install-Module -Name PowerShellGet.
    • 선택적 매개 변수:
      • -Proxy. 요청에 대한 프록시 서버를 지정합니다.
      • -Force. "이미 설치됨" 경고를 무시하고 최신 버전을 설치합니다.

    최신 버전의 PowerShellGet을 사용하지 않는 경우 이 오류가 표시됩니다.

    Install-Module : A parameter cannot be found that matches parameter name 'AllowPrerelease'.
    At line:1 char:20
    Install-Module abc -AllowPrerelease
                   ~~~~~~~~~~~~~~~~
    CategoryInfo          : InvalidArgument: (:) [Install-Module], ParameterBindingException
    FullyQualifiedErrorId : NamedParameterNotFound,Install-Module
    
  5. PowerShell을 다시 시작합니다. 현재 세션에서는 새 버전을 로드할 수 없습니다. 새 PowerShell 세션에서 PowerShellGet의 최신 버전을 로드합니다.

이러한 단계를 수행하면 PowerShell 갤러리에서 Az.ApplicationMonitor 모듈이 다운로드됩니다.

  1. PowerShell 갤러리에 대한 모든 필수 조건이 충족되는지 확인합니다.
  2. 향상된 실행 정책을 통해 관리자 권한으로 PowerShell을 실행합니다.
  3. Az.ApplicationMonitor 모듈을 설치합니다.
    • 참조: Install-Module.
    • 명령: Install-Module -Name Az.ApplicationMonitor.
    • 선택적 매개 변수:
      • -Proxy. 요청에 대한 프록시 서버를 지정합니다.
      • -AllowPrerelease. 알파 및 베타 릴리스 설치를 허용합니다.
      • -AcceptLicense. "라이선스 수락" 메시지를 무시합니다.
      • -Force. "신뢰할 수 없는 리포지토리" 경고를 무시합니다.

수동으로 모듈 다운로드 및 설치(오프라인 옵션)

어떤 이유로든 PowerShell 모듈에 연결할 수 없는 경우에는 Az.ApplicationMonitor 모듈을 수동으로 다운로드하여 설치할 수 있습니다.

최신 nupkg 파일 수동 다운로드

  1. [https://editor.swagger.io](https://www.powershellgallery.com/packages/Az.ApplicationMonitor) 로 이동합니다.
  2. 버전 기록 테이블에서 파일의 최신 버전을 선택합니다.
  3. 설치 옵션에서 수동 다운로드를 선택합니다.

옵션 1: PowerShell 모듈 디렉터리에 설치

PowerShell 세션에서 검색할 수 있도록 수동으로 다운로드한 PowerShell 모듈을 PowerShell 디렉터리에 설치합니다. 자세한 내용은 PowerShell 모듈 설치하기를 참조하세요.

Expand-Archive(v1.0.1.0)를 사용하여 zip 파일로 nupkg 압축 풀기

  • 설명: 기본 버전의 Microsoft.PowerShell.Archive(v1.0.1.0)에서 nupkg 파일의 압축을 풀 수 없습니다. 파일 이름에 .zip 확장명을 사용합니다.

  • 참조: Expand-Archive.

  • 명령:

    $pathToNupkg = "C:\az.applicationmonitor.0.3.0-alpha.nupkg"
    $pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
    $pathToNupkg | rename-item -newname $pathToZip
    $pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor"
    Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule
    

Expand-Archive(v1.1.0.0)를 사용하여 nupkg 압축 풀기

  • 설명: 확장명을 변경하지 않고 Expand-Archive의 현재 버전을 사용하여 nupkg 파일의 압축을 풉니다.

  • 참조: Expand-ArchiveMicrosoft.PowerShell.Archive.

  • 명령:

    $pathToNupkg = "C:\az.applicationmonitor.0.2.1-alpha.nupkg"
    $pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor"
    Expand-Archive -LiteralPath $pathToNupkg -DestinationPath $pathInstalledModule
    

옵션 2: 수동으로 nupkg 압축 풀기 및 가져오기

PowerShell 세션에서 검색할 수 있도록 수동으로 다운로드한 PowerShell 모듈을 PowerShell 디렉터리에 설치합니다. 자세한 내용은 PowerShell 모듈 설치하기를 참조하세요.

다른 디렉터리에 모듈을 설치하는 경우 Import-Module을 사용하여 수동으로 모듈을 가져옵니다.

중요

DLL은 상대 경로를 통해 설치됩니다. 원하는 런타임 디렉터리에 패키지의 내용을 저장하고, 쓰기 권한이 아닌 읽기 권한이 허용되어 있는지 확인합니다.

  1. 확장명을 ".zip"으로 변경하고 원하는 설치 디렉터리로 패키지의 내용을 추출합니다.
  2. Az.ApplicationMonitor.psd1의 파일 경로를 찾습니다.
  3. 향상된 실행 정책을 통해 관리자 권한으로 PowerShell을 실행합니다.
  4. Import-Module Az.ApplicationMonitor.psd1 명령을 사용하여 모듈을 로드합니다.

프록시를 통한 트래픽 라우팅

프라이빗 인트라넷에서 컴퓨터를 모니터링하는 경우 프록시를 통해 HTTP 트래픽을 라우팅해야 합니다.

PowerShell 갤러리에서 Az.ApplicationMonitor를 다운로드 및 설치하기 위한 PowerShell 명령은 -Proxy 매개 변수를 지원합니다. 설치 스크립트를 작성하는 경우 위의 지침을 검토합니다.

Application Insights SDK는 앱의 원격 분석 데이터를 Microsoft로 전송해야 합니다. web.config 파일에서 앱에 대한 프록시 설정을 구성하는 것이 좋습니다. 자세한 내용은 Application Insights FAQ: 프록시 통과를 참조하세요.

모니터링 사용

Enable-ApplicationInsightsMonitoring 명령을 사용하여 모니터링을 활성화합니다.

이 cmdlet의 사용 방법에 대한 자세한 내용은 API 참조를 참조하세요.

다음 단계

원격 분석 보기:

원격 분석 더 추가:

Application Insights Agent에서 지원하는 더 많은 작업:

  • 가이드를 참조하여 Application Insights Agent 문제를 해결할 수 있습니다.