이벤트 및 메타데이터 삭제 도구
1. 소개
이벤트 및 메타데이터 삭제 도구 event_del_full은 지정한 프로젝트에서 하나 이상의 이벤트에 대한 전체 과거 데이터와 이벤트 정의 를 삭제합니다. 이벤트와 속성의 연결 관계, 연관된 메타 이벤트의 정의 및 속성 연결 관계도 함께 삭제합니다. 속성 정의 자체는 유지됩니다.
이 도구는 이벤트 데이터와 이벤트 정의를 완전히 제거해야 하는 경우에 사용합니다. 기간이나 다른 조건에 따라 일부 데이터만 삭제하는 기능은 지원하지 않습니다.
삭제 작업은 되돌릴 수 없습니다. 삭제 범위를 미리 확인하고 필요에 따라 데이터를 백업하세요. 이벤트를 삭제해도 해당 이벤트의 데이터 전송은 중지되지 않습니다. 이후에도 데이터가 전송되거나 추가 전송되면 이벤트와 해당 데이터가 다시 나타날 수 있습니다.
2. 사용 설명
2.1 작업 전 준비
이 설명은 2차 개발 도구가 배포된 프라이빗 배포 환경에 적용됩니다. 작업 전에 대상 프로젝트의 appid와 삭제할 이벤트 이름을 준비하고 다음 사항을 확인하세요.
- 대상 이벤트의 데이터 전송을 중지했으며, 처리 대기 중이거나 추가 전송할 데이터가 있는지 확인했습니다.
- 삭제가 관련 분석, 리포트 및 연관된 메타 이벤트에 미치는 영향을 확인했습니다.
- ETL(데이터 처리 서비스)을 중지해야 하는 경우 적절한 작업 시간을 정했습니다. ETL 중지는 다른 프로젝트의 데이터 처리에도 영향을 줄 수 있습니다.
현재 환경에서 이 명령을 지원하는지 확실하지 않거나 위의 영향을 확인할 수 없다면 먼저 관리자 또는 기술 지원팀에 문의하세요.
2.2 도구 실행
2차 개발 도구가 설치 및 설정된 서버에 로그인한 후 실행 권한이 있는 계정으로 명령을 실행합니다. ta 계정을 사용하는 배포 환경에서는 root로 로그인한 후 먼저 su - ta를 실행하고 도구를 시작할 수 있습니다.
ta-tool event_del_full
실행할 때 추가 파라미터는 필요하지 않습니다. 안내에 따라 입력하면 됩니다. 입력 대기 단계에서 quit을 입력하면 도구를 종료할 수 있습니다. 삭제가 시작된 후 취소하는 방법은 “3.3 실행 중 취소”를 참고하세요.
2.3 appid 입력 및 프로젝트 확인
“작업할 appId를 입력하세요”라는 안내가 표시되면 대상 프로젝트의 appid를 입력합니다. 검증이 완료되면 프로젝트 이름이 표시됩니다. 이름을 정확히 확인한 후 y를 입력하여 계속합니다. 다른 내용을 입력하면 작업이 취소됩니다.
“입력한 값에 해당하는 프로젝트가 없습니다. appid 파라미터를 확인하세요”라는 안내가 표시되면 appid를 확인한 후 명령을 다시 실행하세요.
2.4 삭제할 이벤트 이름 입력
“삭제할 이벤트 이름을 입력하세요. 여러 이벤트는 쉼표(,)로 구분하세요”라는 안내가 표시됩니다. 여기에는 표시 이름이 아닌, 데이터 전송에 사용하는 이벤트 이름(key) 을 입력합니다.
여러 이벤트는 반각 쉼표 , 또는 전각 쉼표 ,로 구분할 수 있습니다. 예를 들면 다음과 같습니다.
draw_card, gold_get
중복 입력한 이벤트 이름은 자동으로 중복 제거됩니다. 유효한 이벤트 이름을 입력하지 않으면 다시 입력하라는 안내가 표시됩니다.
2.5 삭제 내용 확인
프로젝트 이름, 삭제할 이벤트 목록 및 삭제 범위가 표시되며 연속으로 두 번 확인 해야 합니다. 내용이 정확한지 확인한 후 두 번 모두 y를 입력하여 계속합니다. 어느 한 번이라도 다른 내용을 입력하면 작업이 취소됩니다.
2.6 ETL 중지 여부 선택
ETL을 중지한 후 삭제하시겠습니까? <y/n> >라는 안내가 표시됩니다.
- y 입력: 먼저 ETL을 중지한 후 삭제를 실행하며, 작업이 끝나면 자동으로 ETL 복구를 시도합니다. 중지되는 동안 관련 노드의 데이터 처리가 영향을 받으며 다른 프로젝트에도 영향을 줄 수 있습니다.
- n 입력: ETL을 중지하지 않고 위험 확인 단계로 이동합니다. 실행 중에는 관련 이벤트 데이터가 전송되지 않도록 해야 합니다. 조건을 충족하는지 확인한 후
y를 입력하여 계속하거나, 다른 내용을 입력하여 취소합니다. - 다른 내용 입력: 작업을 취소합니다.
K8s(컨테이너화) 환경에서는 반드시 ETL 중지를 선택해야 합니다. 중지하지 않도록 선택하면 지원하지 않는다는 안내와 함께 도구가 종료되므로 명령을 다시 실행해야 합니다.
ETL을 중지해도 클라이언트의 데이터 전송이 중지되거나 아직 처리되지 않은 데이터가 제거되지는 않습니다. 따라서 어느 방식을 선택하든 먼저 데이터 전송 및 추가 전송 여부를 확인해야 합니다.
2.7 실행 대기 및 결과 확인
확인을 마치면 도구가 이벤트와 환경 상태를 점검하고, 필요한 백그라운드 동기화 작업이 끝날 때까지 기다린 후 이벤트를 하나씩 삭제합니다. 삭제할 이벤트 중 하나라도 존재하지 않으면 삭제를 시작하기 전에 작업이 종료됩니다.
실행 중에는 각 이벤트의 삭제 진행 상황이 표시되며, 종료 후에는 성공 및 실패한 이벤트 수와 목록이 출력됩니다. 이 목록을 기준으로 삭제 결과를 확인하세요. 실행 중에 취소했다면 아직 처리되지 않은 이벤트가 있는지도 확인해야 합니다.
도구는 선택한 방식에 따라 자동으로 캐시 갱신을 요청하거나 ETL 복구를 시도하므로 수동으로 호출할 필요가 없습니다. 명령이 종료될 때까지 기다린 후 추가 오류 안내가 있는지 확인하세요. 이벤트 삭제 성공이 표시되어도 데이터 처리 서비스가 성공적으로 복구되었다는 뜻은 아닙니다. 캐시 갱신 또는 ETL 복구 실패 안내가 표시되면 터미널 출력을 보관하고 관리자 또는 기술 지원팀에 문의하세요.
3. 주의 사항
3.1 삭제 범위 및 연관 영향
| 내용 | 처리 방식 |
|---|---|
| 업데이트 이벤트 데이터를 포함한 지정 이벤트의 전체 과거 데이터 | 기간 구분 없이 삭제 |
| 지정 이벤트의 정의 및 속성과의 연결 관계 | 삭제 |
| 연관된 메타 이벤트의 정의 및 속성과의 연결 관계 | 삭제 |
| 속성 정의 | 유지 |
| 유저 데이터, 프로젝트 정보 및 프로젝트 멤버 | 삭제하지 않음 |
| 지정하지 않은 이벤트의 데이터 및 이벤트 정의 | 직접 삭제하지 않음. 공유 메타 이벤트는 영향을 받을 수 있음 |
여러 이벤트가 동일한 메타 이벤트와 연관되어 있다면, 그중 하나를 삭제할 때 공유하는 메타 이벤트 정의와 속성 연결 관계도 삭제되어 다른 이벤트의 사용에 영향을 줄 수 있습니다. 이러한 연결 관계가 있다면 먼저 관리자 또는 기술 지원팀에 문의하여 영향을 확인하세요.
이 도구는 삭제된 이벤트를 참조하는 분석, 리포트 등의 설정을 자동으로 조정하지 않습니다. 미리 확인하고 삭제 후 필요에 따라 수정하세요.
3.2 일반적인 안내 및 처리 방법
| 안내 또는 현상 | 처리 방식 |
|---|---|
| 백그라운드 데이터 동기화 작업이 끝난 후 삭제해야 합니다 | 도구가 자동으로 기다린 후 재시도합니다. 오랫동안 진행되지 않으면 관리자 또는 기술 지원팀에 점검을 요청하세요. |
| 운영 담당자가 유지보수 작업을 진행 중이므로 이 기간에는 메타데이터 수정 관련 작업을 할 수 없습니다 | 유지보수 작업이 끝난 후 다시 실행하세요. 현재 상태가 확실하지 않으면 관리자에게 문의하세요. |
| 프로젝트에 이벤트가 없습니다 | 프로젝트 appid와 이벤트 이름을 확인하세요. 표시 이름을 입력한 것은 아닌지, 이미 삭제된 이벤트는 아닌지 확인하세요. |
| 잠금 대기 중 이벤트 메타데이터가 변경되어 이번 삭제가 취소되었습니다 | 프로젝트의 이벤트와 연결 관계를 다시 확인하고 삭제 범위를 확정한 후 실행하세요. |
| 일부 이벤트 삭제에 실패했습니다. 로그를 확인하세요 | 실패한 이벤트 목록과 오류 정보를 보관하고 원인을 확인한 후 “3.4 삭제 실패 후 처리”에 따라 작업하세요. |
3.3 실행 중 취소
실행이 시작된 후 취소하려면 Ctrl+C를 한 번 눌러 중지를 요청하고, 도구가 후속 정리를 마칠 때까지 기다립니다. 취소해도 이미 삭제된 데이터는 복구되지 않으며 , 처리 중인 이벤트도 일부가 이미 삭제되었을 수 있습니다.
ETL 복구에 영향을 주지 않도록 Ctrl+C를 연속으로 누르거나 프로세스를 강제로 종료하지 마세요. 취소 후 서비스 복구 실패 등의 안내가 표시되면 터미널 출력을 보관하고 관리자 또는 기술 지원팀에 문의하세요.
3.4 삭제 실패 후 처리
단일 이벤트 삭제에 실패해도 도구는 일반적으로 후속 이벤트를 계속 처리합니다. 실패한 이벤트도 데이터의 일부가 이미 삭제되었을 수 있으며, 완료된 삭제는 자동으로 복구되지 않습니다.
먼저 성공 및 실패한 이벤트 목록과 오류 정보를 보관하고 관리자 또는 기술 지원팀에 원인 확인을 요청하세요. 재시도할 때는 여전히 삭제가 필요하며 존재하는 것으로 확인된 이벤트만 입력하세요. 이미 삭제에 성공한 이벤트가 포함된 전체 목록을 그대로 다시 제출하면 이벤트가 존재하지 않아 작업이 종료될 수 있습니다.
모든 이벤트가 성공적으로 삭제되고 캐시 갱신 또는 ETL 복구만 실패했다면 해당 서비스 문제를 처리해야 합니다. 이벤트를 다시 삭제할 필요는 없습니다.

