Analytics 서비스 설치 또는 사용

  • 아티클

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

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

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

참고

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

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

필수 구성 요소

Azure DevOps Server 2019.1의 경우:

Azure DevOps Server 2019의 경우:

분석 사용

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

참고

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

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

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

  2. 분석 사용을 선택합니다.

    분석 사용

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

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

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

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

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

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

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

    일시 중지 확인 대화 상자.사용 안 함 확인

분석 다시 시작

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

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

    분석 사용

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

    다시 시작 대화 상자를 확인합니다.

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

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

분석을 일시 중지하거나 Analytics 확장(2019)을 사용하지 않도록 설정하면 다음 기능이 비활성화됩니다.

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

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

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

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

참고

Azure DevOps Server 2019.1에서 Analytics를 사용하지 않도록 설정하는 것은 Azure DevOps Server 2019에 대한 Analytics 확장을 제거하는 것과 동일합니다.

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

Analytics 확장 설치

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

팁

분석 확장은 Azure DevOps Marketplace에서 다운로드할 필요가 없도록 Azure DevOps Server 위해 로컬 갤러리에 표시됩니다.

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

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

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

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

    참고

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

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

    분석 확장 카드

  4. 무료로 가져오기를 선택합니다.

    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로 이동하면 연결되지 않은 경우 오류가 표시되지 않습니다. 클라우드 서비스 컨텍스트로 전환하기만 하면 됩니다.

알려진 문제

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

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