다음을 통해 공유

Analytics 서비스 설치 또는 사용

  • 아티클

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Azure DevOps Server 2020 이상 버전의 경우 Analytics 서비스를 일반적으로 사용할 수 있습니다. 서버에 추가된 모든 새 프로젝트 컬렉션에 대해 자동으로 사용하도록 설정됩니다. 이전 버전에서 업그레이드된 프로젝트 컬렉션의 경우 수동으로 사용하도록 설정해야 할 수 있습니다. 분석 보고서를 생성하려는 각 프로젝트 컬렉션에 대해 Analytics를 사용하도록 설정합니다.

Analytics는 Azure DevOps Server 2019용 미리 보기로 제공됩니다. Azure DevOps Server 2019 의 경우 분석을 사용하려는 각 프로젝트 컬렉션에 대해 로컬 마켓플레이스에서 분석 확장을 설치합니다. Azure DevOps Server 2019.1의 경우 Analytics 를 사용하려는 각 프로젝트 컬렉션에 대해 분석을 사용하도록 설정합니다. 분석 지원

참고 항목

Analytics Marketplace 확장 및 분석은 TFS 2018 이전 버전에서 지원 되지 않습니다.

Analytics는 프로젝트 컬렉션에 정의된 모든 프로젝트에 대한 분석 위젯에 대한 액세스를 지원합니다. 자세한 내용은 분석을 기반으로 하는 분석 및 위젯이란?을 참조하세요. 분석에서 사용할 수 있는 데이터는 분석에서 사용할 수 있는 데이터에 요약되어 있습니다.

필수 조건

Azure DevOps Server 2019.1의 경우:

  • Azure DevOps Server를 설치하고 구성해야 합니다. 자세한 내용은 Azure DevOps 온-프레미스 설치 및 구성을 참조 하세요.
  • 프로젝트 컬렉션을 하나 이상 추가해야 합니다. 프로젝트 컬렉션을 추가하려면 프로젝트 컬렉션 관리를 참조 하세요.
  • 분석을 사용하도록 설정, 일시 중지, 비활성화 또는 다시 시작하려면 컬렉션 수준 정보 편집 권한이 있는 프로젝트 컬렉션 관리자 그룹 그룹의 구성원이어야 합니다.

Azure DevOps Server 2019의 경우:

분석 활성화

Azure DevOps Server 2019.1로 업그레이드한 경우 다음 단계를 통해 프로젝트 컬렉션에 대한 분석을 사용하도록 설정할 수 있습니다. 그렇지 않으면 Azure DevOps Server 2019의 경우 분석 설치를 참조 하세요.

참고 항목

새로 만든 모든 프로젝트 컬렉션에 대해 분석이 자동으로 사용하도록 설정됩니다.

  1. 웹 브라우저에서 (1) 프로젝트 컬렉션, (2) 컬렉션 설정 또는 관리자 설정, (3) 분석을 선택합니다.

    컬렉션>관리자 설정>분석 열기

  2. 분석 사용 선택

    분석 활성화

    사용하도록 설정되면 분석 준비 작업이 Analytics 데이터 테이블을 채우기 시작합니다. 이 프로세스는 컬렉션의 크기에 따라 다소 시간이 걸릴 수 있습니다. 데이터 테이블에 대한 자세한 내용은 분석 데이터 모델을 참조하세요.

분석 일시 중지 또는 사용 안 함

Azure DevOps Server 2019.1로 업그레이드한 경우 다음 단계를 통해 프로젝트 컬렉션에 대한 분석을 일시 중지하거나 사용하지 않도록 설정할 수 있습니다. 그렇지 않은 경우 Azure DevOps Server 2019의 경우 Analytics 확장을 사용하지 않도록 설정하거나 제거하는 것과 동등한 작업을 수행합니다.

이전에 사용하도록 설정된 분석만 일시 중지하거나 사용하지 않도록 설정할 수 있습니다.

  1. 분석 설정 페이지에서 분석 일시 중지 또는 분석 사용 안 함을 선택합니다.

    분석 일시 중지 또는 사용 안 함

  2. 서비스를 일시 중지하거나 사용하지 않도록 설정할지 확인합니다.

    일시 중지 대화 상자를 확인합니다. 사용 안 함 확인

분석 다시 시작

Azure DevOps Server 2019.1의 경우 프로젝트 컬렉션에 대해 일시 중지한 후 분석을 다시 시작할 수 있습니다. 서비스를 다시 시작하면 준비 작업이 다시 활성화되어 데이터 테이블을 업데이트하고 최신 상태로 만들어 일시 중지된 이후 업데이트됩니다.

  1. 분석 설정 페이지에서 분석 다시 시작을 선택합니다.

    분석 활성화

  2. 서비스를 다시 시작할지 확인합니다.

    다시 시작 확인 대화 상자.

    사용하도록 설정되면 분석 준비 작업이 Analytics 데이터 테이블을 채우기 시작합니다. 이 프로세스는 컬렉션의 크기에 따라 다소 시간이 걸릴 수 있습니다.

분석을 일시 중지하거나 사용하지 않도록 설정하면 어떻게 되나요?

분석을 일시 중지하거나 분석 확장(2019)을 사용하지 않도록 설정하면 다음 기능을 사용하지 않도록 설정합니다.

분석을 일시 중지하면 데이터가 유지되지만 준비 작업에서 데이터 업데이트가 중지됩니다. 나중에 서비스를 다시 시작할 수 있으며 데이터가 업데이트됩니다.

분석을 사용하지 않도록 설정하거나 분석 확장(2019)을 제거하면 모든 Analytics 준비 작업이 해제되고 분석 테이블에 저장된 분석 데이터가 삭제됩니다. 기록 추세를 캡처하는 모든 분석 데이터는 손실됩니다. 컬렉션에 저장된 다른 데이터는 삭제되지 않습니다. 이 작업은 취소할 수 없습니다. 기록 데이터 및 추세 데이터가 삭제되면 복원할 수 없습니다. 분석을 다시 사용하도록 설정해도 기록 데이터는 복원되지 않습니다.

분석을 사용하지 않도록 설정하거나 제거하면 다음 작업이 수행됩니다.

  • 스테이징 작업이 실행되지 않으며 Analytics 테이블에 업데이트된 정보가 없습니다.
  • 테이블 데이터가 삭제되고 분석이 다시 사용하도록 설정되면 모든 데이터를 처음부터 다시 채워야 합니다.

참고 항목

Azure DevOps Server 2019.1에서 분석을 사용하지 않도록 설정하는 것은 Azure DevOps Server 2019에 대한 분석 확장을 제거하는 것과 같습니다.

데이터 테이블에 대한 자세한 내용은 분석 데이터 모델을 참조하세요.

Analytics 확장 설치

Azure DevOps Server 2019.1로 업그레이드하지 않은 경우 분석 확장을 설치하여 프로젝트 컬렉션에 대한 분석 위젯 및 보고서에 액세스할 수 있습니다. 분석 확장은 온-프레미스 설치 관리자 내에 제공됩니다. 확장을 설치하면 기능을 사용할 수 있습니다. 설치하기 위해 확장 파일을 수동으로 다운로드할 필요가 없습니다.

팁

분석 확장은 Azure DevOps Server의 로컬 갤러리에 표시되므로 Azure DevOps Marketplace에서 다운로드할 필요가 없습니다.

  1. 웹 브라우저에서 (1) 프로젝트 컬렉션, (2) 관리자 설정 및 (3) 확장을 선택합니다.

    컬렉션>관리자 설정>확장 열기

  2. 로컬 확장 찾아보기를 선택합니다.

    로컬 마켓플레이스 찾아보기

    참고 항목

    로컬 마켓플레이스에서 확장을 설치하는 것은 호스트된 마켓플레이스에서 설치하는 것과 동일합니다. 유일한 차이점은 호스트된 마켓플레이스에 확장 등급 및 사용자 주석이 표시되어 있다는 점입니다.

  3. 로컬 Marketplace가 새 브라우저 탭에서 열립니다. 분석 확장 카드를 선택합니다.

    분석 확장 카드

  4. Get it free를 선택합니다.

    Analytics Marketplace 확장의 스크린샷. 무료 가져오기를 선택합니다.

  5. 프로젝트 컬렉션을 선택한 다음 설치를 선택합니다.

    프로젝트 컬렉션 선택

  6. 설치가 완료되면 다음과 유사한 이미지가 표시됩니다. 컬렉션 진행을 선택하여 컬렉션 에 대한 웹 포털로 돌아갑니다.

    설치된 Analytics Marketplace 확장, 컬렉션 진행의 스크린샷

    필요에 따라 다른 프로젝트 컬렉션에 Analytics 확장을 설치하려면 브라우저 뒤로 단추를 선택합니다.

Analytics 확장 사용 안 함 또는 제거

Analytics 확장을 사용하지 않도록 선택하면 작업이 실행되지 않습니다. 분석 데이터가 동기화되지 않으며 관련 기능을 사용할 수 없습니다. 그러나 데이터는 삭제되지 않습니다. 분석 확장을 제거하면 Analytics 데이터베이스 테이블에서 데이터가 삭제됩니다. 확장을 다시 설치하면 데이터가 처음부터 다시 채워집니다.

  1. 확장 메뉴를 열고 확장 관리를 선택합니다.

    확장 관리 탭의 스크린샷

  2. 관리 탭에서 확장의 바로 가기 메뉴를 엽니다.

  3. 필요에 따라 사용 안 함 또는 제거를 선택합니다.

배포에서 제거된 경우 분석 확장 복원

배포에서 분석 확장을 제거하는 경우 온라인 마켓플레이스에서 확장을 설치하여 복원할 수 있습니다. 서버 설정으로 인해 온라인 마켓플레이스를 사용할 수 없습니다. 예를 들어 방화벽이 일부 나가는 연결을 차단할 수 있습니다. 이 경우에도 다음 단계를 사용하여 로컬 마켓플레이스로 복원할 수 있습니다.

  1. 분석 확장 설치 섹션에 제공된 지침에 따라 컬렉션 설정을 엽니다.

    확장을 선택한 다음 로컬 확장을 찾습니다.

  2. 페이지 아래쪽으로 스크롤하고 확장 관리를 선택합니다.

    확장 관리

  3. 확장 업로드를 선택한 다음 클릭을 선택하여 업로드합니다. Microsoft.TeamFoundation.Extension.Analytics.vsix 파일이 포함된 폴더로 찾습니다.

    확장 업로드

    .vsix 파일은 다음 경로의 애플리케이션 계층 폴더 설치에서 찾을 수 있습니다.

    C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsix

    확장을 업로드하면 로컬 마켓플레이스로 복원됩니다. 여기에서 컬렉션에 설치할 수 있습니다.

서버의 연결이 끊어지는지 확인하는 방법

서버가 인터넷에서 연결이 끊어진 경우 로컬 마켓플레이스에서 분석을 설치해야 합니다.

Azure DevOps Server가 연결이 끊어진 상태인지 확인할 수 있습니다. 호스트된 마켓플레이스를 탐색할 때 연결된 아이콘과 서버 이름이 맨 위에 표시되는지 확인합니다.

서버가 연결되어 있는지 여부 확인

온-프레미스 서버에서 Marketplace로 이동하면 연결되지 않은 경우 오류가 표시되지 않습니다. 클라우드 서비스 컨텍스트로 전환하기만 하면 됩니다.

알려진 문제

예를 들어 https://OnPrem.MyCompany.com공용 URL을 사용하여 확장을 설치하는 경우 TLS/SSL 오류와 같은 콜백 오류가 발생할 수 있습니다.

이 문제를 해결하려면 애플리케이션 계층을 호스트하는 컴퓨터에서 확장을 설치하고 로컬 컴퓨터 URL https://myMachineName을 가리킬 수 있습니다.