다음을 통해 공유


Visual Studio 연결된 서비스를 사용하여 Azure Application Insights 추가

Visual Studio를 사용하면 연결된 서비스 기능을 사용하여 Azure Application Insights에 다음을 연결할 수 있습니다.

  • .NET Framework 콘솔 앱
  • ASP.NET MVC(Model-View-Controller)(.NET Framework)
  • ASP.NET Core
  • .NET Core(콘솔 앱, WPF, Windows Forms, 클래스 라이브러리 포함)
  • .NET Core 작업자 역할
  • Azure Functions
  • 유니버설 Windows 플랫폼 앱
  • Xamarin
  • Cordova

연결된 서비스 기능은 필요한 모든 참조와 연결 코드를 프로젝트에 추가하고 구성 파일을 적절하게 수정합니다.

필수 조건

연결된 서비스를 사용하여 Azure Application Insights에 연결

  1. Visual Studio에서 새 프로젝트를 엽니다.

  2. 솔루션 탐색기에서 연결된 서비스 노드를 마우스 오른쪽 단추로 클릭하고 바로 가기 메뉴에서 연결된 서비스 추가를 선택합니다.

  3. 연결된 서비스 탭에서 서비스 종속성의 + 아이콘을 선택합니다.

    연결된 서비스 노드를 확인할 수 없는 경우, 프로젝트>연결된 서비스>추가를 선택합니다.

  4. 종속성 추가 페이지에서 Azure Application Insights를 선택합니다.

    이 스크린샷은

    아직 로그인하지 않은 경우 Azure 계정에 로그인합니다. Azure 계정이 없으면 평가판에 등록할 수 있습니다.

  5. Azure Application Insights 구성 화면에서 기존 Azure Application Insights 구성 요소를 선택하고 다음을 선택합니다.

    새 구성 요소를 만들어야 하는 경우 다음 단계로 이동합니다. 그러지 않은 경우 7단계로 건너뜁니다.

    이 스크린샷은

  6. Application Insights 구성 요소를 만들려면 다음을 수행합니다.

    1. 화면 맨 아래에서 새 Application Insights 구성 요소 만들기를 선택합니다.

    2. Application Insights: 새로 만들기 화면에 입력하고 만들기를 선택합니다.

      이 스크린샷은

    3. Azure Application Insights 구성 화면이 표시되면 새 구성 요소가 목록에 표시됩니다. 목록에서 새 구성 요소를 선택하고 다음을 선택합니다.

  7. 계측 키 이름을 입력하거나 기본값을 선택하고 연결 문자열을 로컬 비밀 파일에 저장할지, 아니면 Azure Key Vault에 저장할지 선택합니다.

  8. 변경 내용 요약 화면에는 프로세스를 완료할 경우 프로젝트에 적용되는 모든 수정 사항이 표시됩니다. 변경 내용이 맞으면 마침을 선택합니다.

  9. 연결이 연결된 서비스 탭의 서비스 종속성 섹션에 표시됩니다.

    이 스크린샷은

연결된 서비스를 사용하여 Azure Application Insights에 연결

참고 항목

.NET Framework 프로젝트의 경우 연결된 서비스 UI가 약간 다릅니다. 차이점을 확인하려면 이 페이지의 Visual Studio 2019 버전과 비교 합니다.

  1. Visual Studio에서 새 프로젝트를 엽니다.

  2. 솔루션 탐색기에서 연결된 서비스 노드를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 추가를 선택하여 사용 가능한 서비스 메뉴를 엽니다.

    연결된 서비스 상황에 맞는 메뉴 옵션을 보여 주는 스크린샷.

    연결된 서비스 노드를 확인할 수 없는 경우, 프로젝트>연결된 서비스>추가를 선택합니다.

  3. Azure Application Insights 플러그인 디펜던시 연결 페이지가 나타납니다. 로컬 에뮬레이터, Application Insights Sdk(로컬) 및 라이브 Azure 애플리케이션 Insights 서비스에 연결하기 위한 두 가지 옵션이 표시됩니다. 로컬 에뮬레이터로 시작하면 비용을 절감하고 초기 개발을 간소화할 수 있습니다. 나중에 이 단계를 반복하고 다른 옵션을 선택하여 라이브 서비스로 마이그레이션할 수 있습니다.

    이 스크린샷은 Application Insights 선택 항목을 보여 줍니다.

    Application Insights SDK를 로컬로 사용하도록 선택한 경우 다음을 클릭하여 프로젝트 수정 방법을 보여주는 변경 내용 요약 화면을 확인합니다. 프로젝트에 NuGet 패키지 참조가 추가되고 로컬 에뮬레이터에 대한 연결 코드가 프로젝트에 추가됩니다.

    나중에 이 단계를 반복하고 다른 옵션을 선택하여 라이브 서비스로 마이그레이션할 수 있습니다.Azure 서비스에 연결하려면 다음 단계를 계속 진행하거나 아직 로그인하지 않은 경우 계속하기 전에 Azure 계정에 로그인하세요. Azure 계정이 없으면 평가판에 등록할 수 있습니다.

  4. Azure Application Insights 구성 화면에서 기존 Azure Application Insights 구성 요소를 선택하고 다음을 선택합니다.

    새 구성 요소를 만들어야 하는 경우 다음 단계로 이동합니다. 그러지 않은 경우 7단계로 건너뜁니다.

    이 스크린샷은

  5. Application Insights 구성 요소를 만들려면 다음을 수행합니다.

    1. 화면 맨 아래에서 새 Application Insights 구성 요소 만들기를 선택합니다.

    2. Application Insights: 새로 만들기 화면에 입력하고 만들기를 선택합니다.

      이 스크린샷은

    3. Azure Application Insights 구성 화면이 표시되면 새 구성 요소가 목록에 표시됩니다. 목록에서 새 구성 요소를 선택하고 다음을 선택합니다.

  6. 연결 설정의 이름과 계측 키 이름을 입력하거나 기본값을 적용합니다.

    참고 항목

    보안을 강화하기 위해 Visual Studio 17.12 이상에서 이 단계에서는 연결 설정 이름을 만듭니다. 이전 버전에서는 연결 문자열 만듭니다. 로컬 파일 시스템에 저장된 연결 문자열은 실수로 노출되는 경우 보안 위험을 초래할 수 있습니다.

  7. 추가 설정을 클릭하고 연결 문자열 로컬 비밀 파일에 저장할지 또는 Azure Key Vault저장할지 선택합니다.

    Application Insights에 연결 - 추가 설정 화면을 보여 주는 스크린샷.

  8. 변경 내용 요약 화면에는 프로세스를 완료할 경우 프로젝트에 적용되는 모든 수정 사항이 표시됩니다. 변경 내용이 맞으면 마침을 선택합니다.

  9. 솔루션 탐색기에서 연결된 서비스 노드를 두 번 클릭하여 연결된 서비스 탭을 엽니다. 연결은 서비스 종속성 섹션 아래에 나타납니다:

    이 스크린샷은

    추가한 종속성 옆의 점 3개를 클릭하면 연결과 같은 다양한 옵션이 표시되어 마법사를 다시 열고 연결을 변경할 수 있습니다. 창 오른쪽 상단에 있는 점 3개를 클릭하면 로컬 종속성을 시작하고 설정을 변경하는 등의 옵션을 볼 수도 있습니다.

  10. 시작 코드 파일(템플릿의 Program.cs )을 열고 다음과 유사한 줄이 추가되었는지 확인합니다.

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
    

다음 단계

ASP.NET Core 프로젝트의 경우 ASP.NET Core 애플리케이션용 Application Insights에서 앱에 대한 모니터링을 사용하도록 설정하는 방법을 알아봅니다.

ASP.NET 프로젝트의 경우 ASP.NET 웹 사이트에 대한 Application Insights 구성을 참조하세요.

링크는 이미 수행한 초기 설정 단계 후 문서의 섹션으로 이동합니다.