다음을 통해 공유


AGDiag를 사용하여 가용성 그룹 상태 이벤트 진단

참고 항목

가용성 그룹 장애 조치(failover)를 트리거하는 Always On 가용성 그룹 상태 문제를 진단하려면 Always On 가용성 그룹 장애 조치(failover) 문제 해결을 참조하세요.

AGDiag는 클러스터 로그의 수동 분석을 자동화하고 다른 로그(SQL Server 오류 로그, Windows 이벤트 로그 등)의 관련 이벤트를 상호 연결하고 보고하는 애플리케이션입니다. AGDiag는 Windows 클러스터 및 Always On 상태 이벤트의 요약 보고서를 생성하고 검색된 각 상태 이벤트에 대한 보다 자세한 분석 결과를 제공합니다. 또한 상태 이벤트 시 가용성 그룹 주 복제본에서 적절한 로그를 제공할 때 대부분의 작업을 자동화합니다.

AGDiag에서 진단할 로그 생성

다양한 메서드를 사용하여 AGDiag가 입력으로 사용하는 로그를 생성할 수 있습니다. AGDiag는 다음 기본 로그를 사용하여 분석을 수행합니다.

  • Windows 클러스터 진단 로그
  • SQL Server 오류 로그
  • Windows 시스템 이벤트 로그
  • 시스템 상태 확장 이벤트(XEL) 파일
  • AlwaysOn Health 세션 XEL 파일

이러한 로그를 수동으로 수집하는 대신 다음 로그 수집 도구 중 하나를 사용하여 캡처할 수 있습니다.

  • LogScout
  • TSS

SQL LogScout을 사용하여 AGDiag 분석을 위한 로그 캡처

가용성 그룹 상태 이벤트를 진단하려면 SQL LogScout을 사용하여 이벤트 당시 주 역할에 있던 SQL Server 인스턴스에 대한 로그를 수집합니다.

  1. 최신 SQL LogScout 을 .zip 파일로 다운로드합니다.

  2. SQL Server가 주 복제본을 호스트하는 컴퓨터에서 .zip 파일을 저장하고 추출합니다. 이 시스템은 장애 조치(failover)가 시작되었거나 가용성 그룹이 해결 과정에 있는 곳입니다.

  3. 관리자 권한 PowerShell 명령 프롬프트 창을 열고 디렉터리를 .zip 파일을 추출한 SQL LogScout 폴더로 변경합니다.

  4. 다음 명령을 실행하여 시나리오를 Basic 캡처하고 프롬프트를 따릅니다.

    .\SQL_LogScout.ps1 -Scenario "Basic" -ServerName "<Your_Sql_Instance_Name>"
    

    관리자 권한 PowerShell 명령 프롬프트 창에서 SQL LogScout을 시작합니다.

  5. 로그 캡처 프로세스가 완료되면, AGDiag를 사용하여 SQL LogScout 폴더 내에 생성된 \output 폴더를 가리킬 수 있습니다. 이 폴더에는 SQL LogScout에서 수집한 로그가 포함되어 있습니다.

TSS를 사용하여 AGDiag에서 진단할 로그 생성

또는 이벤트 당시 주 역할에 있던 SQL Server 인스턴스에서 TSS를 사용하여 로그를 캡처할 수 있습니다.

  1. 도구 집합(TSSv2.zip)을 .zip 파일로 다운로드합니다. 자세한 내용은 TroubleShootingScript 도구 집합 소개(TSSv2)를 참조하세요.

  2. 장애 조치가 시작되거나 가용성 그룹이 해결되는 동안 가용성 그룹 주 복제본을 호스트한 SQL Server 인스턴스의 폴더에 .zip 파일을 저장하고 압축을 풉니다.

  3. 관리자 권한 명령 프롬프트 창을 열고 디렉터리를 TSSv2.zip 파일을 저장하고 추출한 TSS 폴더로 변경하고, 실행하고 TSS SDP:SQLBase, 프롬프트에 응답합니다.

    관리자 권한 명령 프롬프트 창을 사용하여 디렉터리를 TSS 폴더로 변경합니다.

  4. TSS가 SQLBase .cab 파일을 만든 후 폴더에 .cab 파일을 추출합니다.

    폴더에 SQLBase cab 파일을 추출합니다.

AGDiag 도구 다운로드

AGDiag를 다운로드하려면 다음 단계를 수행합니다.

  1. 릴리스 AGDiag Windows 릴리스 2021년 10월(서명됨)을 엽니다.

  2. agdiag.zip 링크를 선택하여 도구를 다운로드합니다.

    agdiag.zip 링크를 선택하여 도구를 다운로드합니다.

AGDiag를 시작하고 압축을 푼 TSS 로그를 입력하십시오.

도구를 다운로드한 후, 다음 단계에 따라 AGDiag를 실행하고 압축을 푼 TSS 로그를 입력합니다.

  1. .zip 파일을 추출하고 agdiag.exe 두 번 클릭하여 AGDiag를 시작합니다.

    다음 상자와 유사한 대화 상자가 나타납니다.

    AGDiag 도구를 실행합니다.

  2. 로그 폴더 선택을 선택하고 TSS SQLBase .cab 파일을 추출한 폴더를 드릴인한 다음 확인을 선택합니다.

AGDiag 보고서 해석

기본 시스템 브라우저가 AGDiag 보고서를 엽니다. 다음 그림은 보고서를 해석하는 데 도움이 됩니다.

  • 다음 AGDiag 시작 화면에서는 AGDiag 기능 및 버전 정보를 설명합니다.

    AGDiag 시작 화면.

  • AGDiag는 초기화 섹션에서 분석하는 로그를 보고합니다. 자세한 정보를 보려면 삼각형을 선택합니다(다음 이미지의 빨간색 상자에 강조 표시됨).

    AGDiag는 로그를 보고합니다.

  • 요약 보고서에는 클러스터 로그의 가용성 그룹 상태 이벤트가 나열됩니다. 특정 상태 이벤트의 자세한 보고서로 이동하려면 숫자 링크(다음 이미지의 빨간색 상자에 강조 표시됨)를 선택합니다.

    가용성 그룹 건강 이벤트

  • 감지된 각 건강 이벤트에 대한 자세한 보고서가 있습니다. 이 보고서에는 상태 이벤트, 진단 및 권장 사항과 상관 관계가 있는 로그 결과가 포함되어 있습니다. 자세한 정보를 보려면 삼각형을 선택합니다(다음 이미지의 빨간색 상자에 강조 표시됨).

    AlwaysOn 건강 이벤트입니다.

AGDiag의 알려진 문제

문서화된 문제 및 가능한 해결 방법에 대한 최신 정보는 AGDiag의 알려진 문제를 참조하세요.