일반적인 해결 방법

문제 해결

Console 워크스페이스 화면에서 로그인, 설정, 워크스페이스 생성, 실행, 로그, 업데이트, 청구 준비 문제를 분류합니다.

고객 관리자고객 멤버플랫폼 운영자

마지막 업데이트 2026년 6월 18일

대부분의 워크스페이스 문제는 그 원인이 Console에 바로 표시됩니다. 상태 표시, 차단 메시지 또는 빌드 및 런타임 로그입니다. 이 가이드는 분류 순서를 안내하며(먼저 신호를 읽고, 그다음 해당하는 작업을 수행), 에스컬레이션할 때 필요한 세부 정보를 담고 있는 대화 상자로 안내합니다.

Console 워크스페이스 문제를 보고하는 경우, 지원 케이스를 열기 전에 아래에 설명된 워크스페이스 지원 대화 상자와 로그 보기부터 시작하세요. 이들은 인계 시 포함해야 할 정확한 상태, 빌드 ID 및 에이전트 준비 상태를 제공합니다.

먼저 워크스페이스 상태를 읽으세요

왼쪽 탐색에서 내 워크스페이스를 엽니다. 각 행에는 상태 표시가 나타납니다 — Running, Stopped, Dormant, 진행 중인 빌드 또는 Unhealthy와 같은 주의 상태입니다. 그리드 위의 헤더에는 현재 보기에서 주의가 필요한 워크스페이스 수도 표시되므로 스크롤하기 전에 문제를 발견할 수 있습니다.

각 행의 오른쪽에는 인라인 작업이 있습니다: 시작, 중지, 연결 메뉴, 로그, 그리고 업데이트, 일정 편집, 삭제가 포함된 오버플로 메뉴(워크스페이스 작업 열기)입니다. 어떤 작업이 활성화되는지는 워크스페이스 상태와 사용자의 역할에 따라 다릅니다. 상태 표시를 사용해 아래의 올바른 다음 섹션을 선택하세요.

각 상태와 작업의 전체 의미는 워크스페이스 관리를 참조하세요.

워크스페이스의 지원 대화 상자 열기

지원 대화 상자는 단일 워크스페이스를 분류하기 위한 주요 화면입니다. 여기에는 상태 점검, 런타임 에이전트 준비 상태, 스토리지 및 공유 드라이브 상태, 관리형 액세스 참조, 최근 사용량이 한곳에 모여 있습니다.

1. 내 워크스페이스에서 해당 워크스페이스를 찾습니다.
2. 그 행의 오버플로 메뉴(워크스페이스 작업 열기)를 엽니다.
3. 지원을 선택합니다.
4. 상태 점검, 런타임 에이전트, 스토리지, 워크스페이스 통합 섹션을 검토합니다.
5. 대화 상자에서 런타임 로그 또는 빌드 로그를 사용하여 해당하는 로그 스트림을 엽니다.

지원 대화 상자는 플랫폼 운영자와 고객 관리자가 사용할 수 있습니다. 고객 멤버이고 표시되지 않는 경우, 해당 워크스페이스에 대해 고객 관리자에게 열어 달라고 요청하세요. 지원 세부 정보는 범위가 제한됩니다. 워크스페이스에 접근 권한이 있는 사람만 이를 볼 수 있으며, 관리형 액세스 참조는 보호된 상태로 유지됩니다 — 비밀 값은 표시되지 않습니다.

에스컬레이션할 때는 워크스페이스 이름, 표시된 상태 신호, 에이전트 준비 수 (예: 1 / 1 ready)를 포함하세요. 세션 토큰, 쿠키 또는 비공개 프롬프트는 포함하지 마세요.

워크스페이스 로그 읽기

로그는 워크스페이스가 시작에 실패한 이유, 프로비저닝 중 멈춘 이유 또는 실행 후 예기치 않게 동작한 이유를 확인하는 가장 빠른 방법입니다.

1. 워크스페이스 행에서 로그 작업을 열거나, 지원 대화 상자에서 런타임 로그 / 빌드 로그를 사용합니다.
2. 워크스페이스가 프로비저닝 중인 동안 Console은 빌드 로그를 표시합니다. 사용 가능해지는 즉시 기본 에이전트 테일 런타임 스트림으로 전환됩니다.
3. 지금 새로 고침으로 다시 로드하고, 로그 다운로드로 현재 스트림을 텍스트로 저장합니다.

푸터는 무엇이 테일링되고 있는지 확인해 줍니다(예: “워크스페이스의 기본 에이전트 로그를 실시간 테일링 중”). 지원 케이스에 로그를 첨부할 때는 스크린샷을 붙여넣지 말고 텍스트를 다운로드하고, 토큰이나 쿠키는 포함하지 마세요.

워크스페이스 생성이 차단됨

생성 페이지는 실행을 허용하기 전에 차단 항목을 표시합니다. 그것을 읽고 해결한 다음에만 다시 시도하세요. 일반적인 차단 항목:

고객 멤버는 청구 및 설정 차단 항목을 고객 관리자에게 에스컬레이션해야 합니다. 대상, 별칭 또는 프로비저닝 차단 항목은 ISM 지원에 에스컬레이션하세요. 이를 해소하는 상위 설정에 대해서는 첫 번째 워크스페이스 생성 및 카탈로그 및 준비를 참조하세요.

프로비저닝 시작 후 생성 실패

빌드가 시작된 다음 실패하는 경우, 스토리지를 수동으로 삭제하지 마세요. 로그 보기를 빌드 모드로 열어 실패 내용을 읽은 다음, 고객 관리자 또는 운영자에게 Console을 통해 다시 시도, 취소, 중지 또는 삭제할지 결정하도록 요청하세요. 수동 런타임 정리는 운영자 대체 수단이며, 일반적인 고객 경로가 아닙니다.

빌드가 멈춰 다른 작업을 차단함

빌드가 활성 상태인 동안에는 시작, 중지, 업데이트, 삭제를 실행할 수 없습니다. 워크스페이스가 빌드 중에 멈춰 있는 경우, 활성 빌드를 취소하여 다른 작업을 실행할 수 있도록 하세요.

1. 워크스페이스 행의 오버플로 메뉴를 엽니다.
2. 빌드 취소를 선택합니다.
3. 활성 빌드 취소 대화 상자에서 빌드 취소로 확인하거나, 빌드 계속 실행으로 실행을 유지합니다.

대화 상자는 활성 빌드의 이름을 표시하므로 올바른 빌드를 취소하고 있는지 확인할 수 있습니다. 취소된 후에는 해당 행의 다른 작업이 다시 사용 가능해집니다.

업데이트 검토에 추가 매개변수가 표시됨

워크스페이스를 업데이트할 때, 활성 템플릿은 일반적으로 저장된 매개변수를 유지합니다. 그럴 수 없는 경우, Console은 업데이트 검토를 열어 빌드가 시작되기 전에 제안된 값을 확인할 수 있도록 합니다.

1. 행의 오버플로 메뉴에서 업데이트를 선택합니다.
2. 검토가 필요한 경우, Console은 조정 가능한 값과 업데이트 사유와 함께 매개변수 검토를 표시합니다.
3. 값을 확인한 다음 업데이트 실행을 선택합니다. Console은 빌드를 시작하기 전에 서버 측에서 검증합니다.
4. 업데이트를 시작하지 않고 빠져나가려면 업데이트 검토 닫기를 사용합니다.

업데이트는 빌드 중에 저장된 워크스페이스 자격 증명을 비밀 값을 노출하지 않고 새로 고칠 수 있습니다. 업데이트 실행 후 상태는 자동으로 업데이트됩니다 — 로그를 열어 빌드를 관찰하세요.

워크스페이스가 휴면 상태가 됨

워크스페이스는 일정 기간 비활성 상태가 지난 후 고객 계정의 휴면 정책에 따라 휴면으로 표시될 수 있습니다. 휴면 워크스페이스는 Dormant 표시를 보여 주며 그 행에는 활성화 작업이 제공됩니다. 시작하면 다시 돌아옵니다.

휴면 및 정리 정책 자체(휴면 표시 및 휴면 삭제 기간)는 플랫폼 운영자가 관리하며 고객 플랜 아래에 존재합니다. 고객 관리자와 멤버는 휴면 정책을 적용하지 않습니다. 워크스페이스가 예기치 않게 정리된 경우, 워크스페이스 이름과 사라진 날짜를 함께 ISM 지원에 에스컬레이션하세요.

워크스페이스 실행이 잘못된 위치를 엶

실행하려면 행의 연결 메뉴를 사용하세요. 브라우저는 공개 워크스페이스 URL을 통해 브라우저 내 편집기를 열고, VS Code Desktop과 JetBrains Gateway는 편집기 딥 링크를 사용하며, 로그는 Console 측 시작 스트림을 표시합니다. Windows 워크스페이스는 비공개 터널을 통한 원격 데스크톱 옵션을 추가합니다.

실행 작업이 내부 서비스 주소나 브라우저로 도달할 수 없는 위치를 여는 경우, 워크스페이스 이름, 선택한 실행 옵션(브라우저, VS Code Desktop, JetBrains Gateway 또는 원격 데스크톱), 그리고 표시된 URL 호스트와 함께 보고하세요. 세션 토큰이나 쿠키는 포함하지 마세요.

실행 중인 워크스페이스에서 Archibot 도구가 오래되어 보임

실행 중인 워크스페이스는 시작할 때 사용한 이미지의 Archibot 도구와 편집기 확장 기능을 유지합니다. 워크스페이스에 최근 발표된 Archibot 동작, 편집기 변경 또는 도구 업데이트가 누락된 경우, 지원되는 업데이트 경로(위)를 실행하거나 새 워크스페이스를 생성하세요.

지원을 위해서는 워크스페이스 이름과 어떤 클라이언트가 영향을 받았는지(브라우저, VS Code Desktop 또는 JetBrains Gateway)를 포함하세요. 세션 로그, 쿠키, 토큰 또는 비공개 프롬프트는 포함하지 마세요. 워크스페이스 내 어시스턴트가 도달할 수 있는 범위는 워크스페이스 Archibot 및 공유 드라이브를 참조하세요.

Archibot이 워크스페이스 도구를 사용할 수 없음

도구 사용은 워크스페이스 프로필, 연결된 서비스 및 사용 가능한 자격 증명에 따라 달라집니다. 도구를 사용할 수 있어야 할 때 Archibot이 도구를 사용하지 않고 답하는 경우, “워크스페이스에서 …을 검색해” 또는 ”…에 대한 SQL 개수를 실행해”와 같은 직접적인 요청으로 다시 시도하고, 에스컬레이션하는 경우 표시된 요청 또는 세션 ID를 포함하세요.

OneDrive가 관련된 경우, 다시 시도하기 전에 Console에서 연결을 확인하세요 — OneDrive 접근은 워크스페이스 사용자가 소유하며, 재연결이 필요할 때 지원 대화 상자가 이를 알려 줍니다. 공유 드라이브가 관련된 경우, 드라이브가 표시되는지 그리고 요청이 Archibot이 사용하기를 원하는 폴더 또는 파일 영역을 참조하는지 확인하세요.

Archibot 워크스페이스에서 개인 보조 AI 로그인을 사용할 수 있나요?

Console 관리형 워크스페이스 설정을 통해서는 불가능합니다. Archibot 관리형 워크스페이스는 워크스페이스 하네스를 통해 개인 공급자 계정 로그인 파일을 저장, 복사 또는 라우팅하지 않으며, 관리형 보조 AI 옵션은 고객 대상 설정 선택지로 노출되지 않습니다.

오늘 다른 공급자별 어시스턴트가 필요한 경우, 해당 공급자의 공식 CLI를 자신의 워크스페이스 셸에서 사용하고 Archibot 관리형 자격 증명 흐름 밖에서 거기서 직접 로그인하세요. 이렇게 하면 고객 청구 귀속이 개인 공급자 구독과 분리되고, 홈 디렉터리나 셸 환경에서 계정 로그인 페이로드를 업로드하는 것을 방지할 수 있습니다.

Archibot 방식의 페어 프로그래밍에는 워크스페이스의 관리형 Archibot 진입점을 사용하세요. 개인 공급자 로그인은 분리된 상태로 유지되며 청구 귀속을 변경하지 않습니다.

계정 설정 또는 분석 탐색이 누락됨

로그아웃했다가 다시 로그인하세요. 예상한 탐색이 여전히 누락된 경우, 계정이 고객 관리자 역할에 매핑되지 않았을 수 있습니다. 사용자 이메일, 회사 또는 고객 계정, 예상 역할, 실제로 보이는 탐색 항목, 그리고 대략적인 로그인 시간을 함께 에스컬레이션하세요. 각 역할이 도달할 수 있는 범위는 액세스 역할을 참조하세요.

고객 멤버가 계정 전체 분석을 볼 수 없음

이는 예상된 동작입니다. 고객 멤버는 자신의 사용량을 검토할 수 있지만, 계정 전체 사용량은 고객 관리자와 플랫폼 운영자에게 속합니다. 고객 수준의 사용량 검토는 고객 관리자에게 요청하세요. 사용량 및 청구를 참조하세요.

분석이 비어 보임

순서대로 확인하세요:

1. 선택한 고객 범위.
2. 선택한 기간.
3. 조정 상태.
4. 해당 기간 동안 워크스페이스가 실행 중이었는지 여부.
5. 공급자 사용량이 아직 지연되고 있는지 여부.

기간이 올바르고 사용량이 여전히 누락된 경우, 선택한 기간과 표시된 조정 상태를 지원에 보내세요.

초대가 접근 거부로 이어짐

1. ID 공급자에서 로그아웃합니다.
2. 초대를 다시 엽니다.
3. 초대 수락 흐름을 완료합니다.
4. 수락 후 Console을 직접 엽니다.

초대가 이미 사용되었거나 만료된 경우, 고객 관리자 또는 운영자에게 재발급을 요청하세요. 초대 링크를 지원 채팅에 붙여넣지 마세요.

계정 설정, 대상이 “ISM 대기 중”으로 표시됨

공유 호스팅 테넌트의 경우 대상은 일반적으로 검토 전용 페이지입니다. 고객 관리자는 거기서 운영자 관리형 대상과 템플릿 별칭 준비 상태를 확인하지만, 대상 자격 증명을 직접 등록하거나 편집하지는 않습니다.

여전히 Waiting on ISM으로 표시되는 경우, 고객 또는 테넌트 이름, 대상이 비어 있는지 또는 준비되지 않은 대상을 표시하는지, 그리고 표시된 템플릿 별칭 또는 준비 메시지를 지원에 보내세요. 고객 관리자 설정을 참조하세요.

여전히 막혀 있다면

워크스페이스 이름, 표시된 상태와 차단 메시지, 지원 대화 상자의 빌드 ID, 그리고 다운로드한 로그 파일을 수집하세요. 그런 다음 지원 인계의 세부 정보와 함께 케이스를 여세요. 첨부하는 어떤 것에도 비밀, 토큰, 쿠키 및 비공개 프롬프트가 포함되지 않도록 하세요.