Azure Virtual Desktop을 관리한다면, FSLogix 이슈와 싸워보셨을 것입니다. 연결되지 않는 프로필 컨테이너. 로그인 시 충돌하는 시작 메뉴. 사용자가 아무것도 보지 못한 채 응시하는 블랙 스크린 while 헬프데스크 대기열이 채워지는. VHD를 잠그고 다음 사용자의 세션으로 계단식으로 이어지는 로그아웃 중단.
모든 AVD 관리자가 거기에 있어 봤습니다. 문제는 문서의 부족이 아닙니다. Microsoft의 FSLogix 문서는 철저합니다. 문제는 P1이 오전 8:47에 발생하고 200명의 사용자가 작업을 할 수 없을 때, 문서 허브가 아닌 구조화된 프로세스가 필요하다는 것입니다.
그래서 우리가 FSLogix 문제 해결 런북 템플릿을 구축하고 오픈소스화했습니다.
왜 런북 템플릿인가?
대부분의 조직은 같은 방식으로 FSLogix를 문제 해결합니다: 부족 지식을 가진 누군가가 고치고, 아무도 그가 한 일을 적지 않습니다. 그 사람이 휴가 중일 때, 다음 인시던트가 세 배 오래 걸립니다.
런북이 그것을 바꿉니다. 모든 지원 티어에 반복 가능하고 증거-우선 워크플로를 줍니다. 로그 수집, 진단, 수정을 표준화하여 수정이 누가 당번인가에 의존하지 않도록.
우리는 몇 달의 실제 AVD 엔게이지먼트를 통해 우리 것을 구축했고, 다른 팀이 자신의 프로세스를 위한 출발점으로 사용할 수 있도록 오픈소스화했습니다.
런북 안에 무엇이 있나
템플릿은 GitHub에서 직접 렌더링되는 인라인 Mermaid 다이어그램과 함께 단일 포괄적 markdown 파일(~2,300줄)입니다. 포크하고, 환경에 맞춰 커스터마이즈하고, 살아 있는 운영 문서로 사용하도록 설계.
인시던트 분류와 결정 매트릭스
빠른 참조 조회 테이블이 증상을 행동에 매핑. 각 증상(시작 메뉴 충돌, 블랙 스크린, explorer 루프, 대규모 중단)에 대해 우선순위 순서로 세 가지 행동과 명확한 에스컬레이션 트리거를 줍니다. L1/L2 기술자가 전체 문서를 읽지 않고 해결을 시작할 수 있습니다.
진단 워크플로
시각적 흐름도(Mermaid)가 결정 트리를 안내:
- 범위 — 단일 사용자 또는 풀 전체?
- FSLogix 연결 상태 — 컨테이너가 마운트되었나?
- 분기 — 연결 실패 시 인프라 진단(저장소, 권한, AV, 인증). 연결 성공 시 프로필/AppX/셸 계층 진단.
- 수정 → 검증 → 문서화
수정 플레이북
각 플레이북이 정확한 명령과 함께 특정 근본 원인을 겨냥:
- 잠긴 VHD — SMB 핸들 찾기와 닫기(온프레미스
Get-SmbOpenFile과 Azure FilesClose-AzStorageFileHandle),CleanupInvalidSessions활성화, 재시도 설정 조정. - 권한 — Microsoft 권장
icaclsACL, Azure RBAC 할당,AccessNetworkAsComputerObject경고. - Azure AD Kerberos 실패 —
klist검증, 저장소 계정 인증 구성, Conditional Access 간섭 진단,Debug-AzStorageAccountAuth사용. - 컨테이너 가득참 —
SizeInMBs확장, 공간 소비자 분석, 압축 검증. - AV/EDR 간섭 — 전체 제외 목록(프로세스, 드라이버, 경로, 확장자), Defender PowerShell 명령, Intune 배포 지침.
- 시작 메뉴 / AppX 실패 — 충돌 이벤트 상관, 패키지 재등록,
InstallAppxPackages검증, AppLocker 확인. - 로그아웃 중단 — 핸들 식별, 프로세스 특정 수정(SearchHost, OneDrive, Defender),
CleanupInvalidSessions. - Cloud Cache 실패 — 서비스 진단, 로컬 디스크 사이징, 제공자 동기화 검증, 스플릿-브레인 복구.
- 프로필 손상 — 결정 트리(수정 vs. 재생성 vs. 복원), chkdsk, 레지스트리 하이브 수리, 백업 패턴.
- MSIX App Attach 충돌, Citrix 공존, Windows Update 회귀, 저장소 백엔드 사이의 프로필 마이그레이션.
자동화 스크립트
- 케이스 번들 수집기 — FSLogix 로그, 이벤트 로그, 레지스트리 내보내기, 네트워크 진단, Kerberos 상태, 프로필 상태를 에스컬레이션을 위해 zip 파일로 모으는 단일 PowerShell 스크립트.
- 헬스 체크 스크립트 — Intune Proactive Remediations 또는 예약된 작업을 통해 배포하여 FSLogix 서비스 상태, AV 제외, 저장소 연결, 오류율을 지속적으로 검증.
- 목적에 맞춘 분류 쿼리 — 셸 충돌, 프로필 서비스 오류, 고아 프로필을 찾는 빠른 PowerShell 한 줄짜리.
Azure Monitor를 위한 KQL 쿼리
Log Analytics를 위한 사전 구축 쿼리:
- 호스트별 FSLogix 연결 실패 수
- 프로필 로드 시간 트렌드(평균, 최대, 시간별 P95)
- 임시 프로필 생성 이벤트
- 시작 메뉴 / 셸 충돌 상관
더해 권장 알림 구성 테이블(저장소 용량, 지연, IOPS 스로틀링, FSLogix 오류, 임시 프로필).
운영 프레임워크
문제 해결 너머, 런북은 다음을 포함:
- SLA 목표와 함께 심각도 분류 매트릭스
- 알려진 좋은 기준선 — 로드 시간, 컨테이너 크기, 저장소 지연, 오류율에 대한 참조 값
- 용량 계획 — IOPS 추정 테이블, Cloud Cache 디스크 사이징 공식, 저장소 성장 투영
- Redirections.xml 지침 — 주석이 달린 안전 제외와 절대 제외하면 안 되는 경로의 “위험한 제외” 테이블
- 배포 체크리스트 — 16점 go-live 전 검증
- DR 절차 — Azure Files 소프트 삭제, 스냅샷 복구, ANF 페일오버, 복구 결정 매트릭스
- 에스컬레이션 경로 — 언제 에스컬레이트할지, 누구에게, 어떤 산물과 함께
- 사용자 커뮤니케이션 템플릿 — 중단 알림과 셀프서비스 지침
- 플레이북 연습 로그 — 어떤 플레이북이 테스트되었는지 그리고 언제 추적
누가 이것을 사용해야 하나
- 임시 수정 대신 구조화된 문제 해결 프로세스를 원하는 AVD 관리자
- 모든 스킬 수준에 걸쳐 일관되고 반복 가능한 워크플로가 필요한 지원 팀(L1–L3)
- 사전 구축된 운영 프레임워크를 원하는 새 배포를 설계하는 AVD 아키텍트
- 여러 클라이언트를 위해 AVD를 관리하고 재사용 가능한 템플릿이 필요한 MSP와 컨설턴트
런북은 의도적으로 템플릿으로 작성. 포크하고, 자리 표시자 값을 환경 세부사항(저장소 경로, 그룹 이름, SLA 목표)으로 교체하고, 도구에 맞춰 플레이북을 커스터마이즈.
우리가 어떻게 구축했나
이 런북은 실제 AVD 엔게이지먼트와 AI 보조 엔지니어링 워크플로의 조합을 통해 개발. AI 코딩 에이전트를 사용해 연구 가속, Microsoft 문서 교차 참조, PowerShell 스크립트 생성, KQL 쿼리 구축 — 그런 다음 모든 것을 프로덕션 환경에 대해 검증.
결과가 수동으로 컴파일하면 몇 주가 걸릴 문서를 몇 일 만에 전달. 엔터프라이즈 IT에서 자기 몸집에 맞서려는 소규모 팀이 필요로 하는 힘의 배수 종류입니다.
런북 받기
전체 런북이 GitHub에서 무료이며 오픈소스:
→ Big-Hat-Group-Inc/FSLogixRunbookTemplate
포크. 커스터마이즈. AVD 지원 프로세스의 기반으로 사용. 이슈를 찾거나 개선을 기여하고 싶다면, pull request를 환영.
팀이 AVD 운영 프로세스 구축, FSLogix 성능 최적화, 또는 회복력 있는 프로필 저장소 설계에 도움이 필요하다면 — 연락해 주세요. 이것이 우리가 하는 일.
Big Hat Group은 엔터프라이즈가 Microsoft 클라우드 인프라를 설계, 배포, 운영하도록 돕습니다. Azure Virtual Desktop, Windows 365, 그리고 IT 팀을 더 효과적으로 만드는 AI 구동 도구 포함. 서비스에 대해 더 알아보기.