워크벤치
워크벤치는 Agent가 구동하는 데이터 개발 작업 협업 공간입니다. 명확한 작업 목표를 중심으로 Agent가 처리 단계를 스스로 계획하고, 도구를 호출해 정보를 수집하며, 실행 결과에 따라 작업을 계속 진행합니다. 관련 작업은 같은 작업 공간에 모아 함께 후속 조치하고 돌아볼 수 있습니다.
현재 워크벤치는 아직 얼리 액세스 단계로, 운영 점검 시나리오를 먼저 제공합니다. 데이터 작업 실패를 출발점으로 증거를 자동 수집하고 원인을 찾아 처리 제안을 제시합니다.
1. 워크벤치, 작업 공간, 점검 작업 이해하기
얼리 액세스 버전은 현재 작업 플로우 실행 실패와 작업 실행 실패 두 가지 알림에 대한 점검을 지원합니다. 장애 하나가 점검 작업 하나에 대응하며, 점검 작업에는 원본 알림, 점검 계획, 실행 과정, 증거, 결론, 처리 제안이 계속 기록됩니다.
세 가지 핵심 대상
| 객체 | 의미 | 사용 방법 |
|---|---|---|
| 이상 이벤트 | 실패 유형 알림 규칙에서 생성되며, 점검의 출발점 | 실패 대상, 발생 시간, 알림 컨텍스트 확인 |
| 점검 작업 | 단일 이상에 대해 수행하는 한 번의 완전한 진단 | 계획, 단계, 증거, 결론, 제안 확인 |
| 작업 공간 | 관련 점검 작업을 묶는 컨테이너로, 데이터 개발 공간과는 다름 | 같은 문제나 업무 흐름의 진행 상황을 모으고 작업 공간 브리핑 생성 |
작업 공간을 나누는 방법
같은 문제, 같은 업무 흐름 또는 계속 후속 조치가 필요한 관련 작업은 같은 작업 공간에 넣는 것이 좋습니다. 그러면 브리핑으로 공통 원인과 전체 진행 상황을 파악하기 쉽습니다. 서로 관련 없는 문제는 작업 공간을 따로 만드십시오. 문제 처리가 끝나면 작업 공간을 보관하여 과거 작업이 현재 점검을 방해하지 않도록 할 수 있습니다.
2. 운영 점검 시작하기
시작하기 전에
공간에 실패 유형 알림 규칙이 하나 이상 활성화되어 있는지 확인하십시오. 워크벤치에는 알림 규칙이 발견한 이상만 표시되며, 알림 규칙이 없으면 점검할 이상 이벤트를 얻을 수 없습니다.
이상과 작업 공간 선택
점검 작업을 새로 만들 때 점검할 이상을 선택하고, 기존 작업 공간에 넣을지 새 작업 공간을 만들지 결정합니다. 같은 문제에 대한 점검 작업이 이미 있으면 원래 작업 공간에 넣는 것을 우선하고, 독립된 문제라면 새 작업 공간을 만듭니다.
진단 컨텍스트 보충. 최근에 코드, 의존성 또는 설정을 변경했거나 정상 결과에 대한 명확한 기대가 있다면 추가 설명에 적어 두십시오. 워크벤치는 알림 텍스트만으로 판단하지 않고 이 정보도 점검에 반영합니다.
이상 상세 보기. 생성 전에 실패 대상, 알림 시간, 관련 정보를 확인하여 잘못된 이상에 대해 점검을 시작하지 않도록 합니다.
점검 계획 확인
수동으로 만든 작업은 먼저 점검 계획을 생성합니다. 점검 목표, 범위, 알려진 컨텍스트가 정확한지 중점적으로 확인하고, 빠진 내용이 있으면 배경을 보충하거나 목표를 조정한 다음 실행을 확인합니다. 계획이 확인되면 워크벤치가 증거를 조회하고 진단을 진행합니다.
3. 워크벤치의 점검 방식
점검 메커니즘
- 이상 이벤트와 추가 정보를 바탕으로 점검 계획을 생성합니다.
- 계획에 따라 작업 인스턴스, 실행 로그, 지표, 변경 기록 등의 정보를 조회합니다.
- 한 단계를 완료할 때마다 확보한 증거를 다시 검토하고, 단서가 부족하면 점검 단계를 추가하거나 관련 담당자에게 정보를 요청합니다.
- 증거가 충분해지면 장애 원인, 영향 범위, 처리 제안을 정리합니다.
점검 그래프의 각 노드는 진단 단계 하나에 대응합니다. 노드를 선택하면 조회 목적, 실행 결과, 증거 출처를 볼 수 있어 결론이 어떻게 도출되었는지 판단할 수 있습니다.
점검과 협업하는 방법
증거에 따라 정보 보충. 추가 정보 필요 알림을 받으면 업무 배경, 기대 결과, 최근 변경 또는 알려진 영향 범위를 제공하십시오. 점검은 새 정보를 바탕으로 계속 진행됩니다.
원래 대상으로 돌아가 확인. 전체 로그나 작업 설정을 확인해야 하면 점검 작업에서 연결된 작업 인스턴스나 자산으로 이동할 수 있습니다.
처리 범위
워크벤치는 진단과 제안까지만 담당하며 복구를 자동으로 실행하지 않습니다. 작업 재실행, 코드 수정, 의존성 조정, 설정 변경 등의 작업은 여전히 권한이 있는 담당자가 확인한 후 수행해야 합니다.
4. 작업 공간 브리핑으로 전체 진행 상황 파악하기
작업 공간 브리핑은 현재 작업 공간에서 보관되지 않은 작업의 정보를 모아 보여 줍니다. 문제에 이미 결론이 났는지, 다음에 무엇을 처리해야 하는지, 여러 점검이 공통 원인을 가리키는지 빠르게 판단하는 데 적합합니다.
| 영역 | 답하는 질문 | 적합한 조치 |
|---|---|---|
| 확인 완료 | 어떤 문제에 명확한 원인이나 결론이 있는지 | 결론을 확인하고 조치가 완료되었는지 확인 |
| 작업 제안 | 현재 실행할 수 있는 후속 조치는 무엇인지 | 담당자를 지정하고 해당 작업에서 근거 확인 |
| 점검 포인트 | 계속 주시할 만한 단서, 현상 또는 패턴은 무엇인지 | 여러 이상에 공통 원인이 있는지 판단 |
작업이 추가되거나 상태가 바뀌거나 점검이 완료되면 브리핑을 업데이트하여 최신 요약을 받을 수 있습니다. 브리핑은 보관되지 않은 작업만 집계하며, 작업 제안은 최근 새로 만든 작업의 제안을 중심으로 요약합니다.
브리핑에서 작업으로 돌아가기
브리핑은 전체를 훑어보기 위한 것으로, 개별 작업의 완전한 증거를 대신하지 않습니다. 제안의 근거를 확인해야 하면 관련 작업 수나 해당 항목을 통해 구체적인 점검 작업으로 들어가 실행 과정, 증거, 컨텍스트를 확인할 수 있습니다.
5. 권장: 자동 생성 활성화
활성화하기 좋은 시나리오
지속적인 운영이 필요하고 실패 후 바로 진단에 들어가고 싶은 운영 환경에서는 자동 생성을 활성화하는 것을 권장합니다. 사람이 이상을 발견하고 작업을 반복해서 만드는 대기 시간을 줄일 수 있습니다.
| 설정 | 역할 | 권장 사항 |
|---|---|---|
| 자동 생성 | 새 실패 알림이 발생하면 점검 작업을 자동으로 생성 | 운영 환경에서는 활성화 권장 |
| 계획 자동 확인 | 작업이 생성되면 바로 진단 계획 실행을 시작 | 대기를 줄이지만 복구를 자동으로 실행하지는 않음 |
| 작업 공간 전략 | 시스템이 작업 공간을 자동으로 생성하거나, 항상 지정 작업 공간에 추가 | 같은 업무를 계속 주시한다면 고정 작업 공간을 지정 가능 |
적용 규칙
활성화한 후에는 그 이후에 새로 발생했고 아직 처리되지 않은 실패 알림만 처리하며, 과거 알림에 대해서는 작업을 소급 생성하지 않습니다. 자동으로 생성된 작업은 자산 담당자에게 우선 할당됩니다. 지정 작업 공간이 보관된 상태라면 다시 복원하여 사용하고, 삭제된 경우에는 시스템이 생성하는 작업 공간으로 되돌아갑니다.
자동 생성과 외부 알림을 함께 활성화하는 것을 권장합니다. 시스템이 문제를 계속 발견하고 진단하며, 정보 보충이 필요하거나 처리할 수 있게 되었을 때 관련 담당자가 제때 알림을 받습니다.
6. @나와 외부 알림으로 제때 처리하기
@나에는 본인이 후속 조치해야 하는 점검 알림이 모여 표시됩니다. 처리 대기와 읽음 상태를 구분할 수 있으며, 해당 작업으로 바로 이동할 수 있습니다.
| 알림 유형 | 표시 시점 | 해야 할 일 |
|---|---|---|
| 추가 정보 필요 | 기존 증거가 부족하여 점검에 업무 컨텍스트가 더 필요함 | 기대 결과, 최근 변경 또는 영향 범위 보충 |
| 처리 제안 생성됨 | 점검에서 실행 가능한 제안이 나옴 | 제안 근거를 확인하고 후속 조치 계획 |
수동으로 만든 작업에서 처리 제안이 나오면 기본적으로 작업 생성자에게 알리고, 자동으로 생성된 작업은 자산 담당자에게 우선 알립니다.
워크벤치를 벗어나도 알림 받기
Feishu 등 외부 채널에서 메시지를 받으려면 공간 관리자가 워크벤치 작업 진단 알림 알림 규칙을 활성화하고 개인 구독을 허용한 다음, 데이터 개발 공간에 알림 채널을 연결해야 합니다. 이후 유저가 필요에 따라 개인 구독을 활성화합니다.
외부 알림을 받지 못할 때
- 공간에서 워크벤치 작업 진단 알림 규칙이 활성화되어 있는지 확인합니다.
- 관리자가 개인 구독을 허용했는지, 본인이 구독을 활성화했는지 확인합니다.
- 현재 데이터 개발 공간에 사용 가능한 알림 채널이 연결되어 있는지 확인합니다.
관리 권한이 없으면 공간 관리자에게 위 설정을 요청하십시오.