4분 읽기

CQE 큐 등록 가이드

CQE(Custom Query Engine) 스크립트를 하나 이상의 논리 서버(LSSN)에 실행 스케줄로 등록하는 방법과, 시작일시(startdate)의 타임존 규약을 안내합니다.

🚀 CQE 큐 등록 페이지로 이동 →

📋 개요

CQE 큐 등록은 레포지토리에 등록된 스크립트(mssn)를 선택하고, 이를 실행할 논리 서버(lssn)들을 골라 실행 스케줄(tMgmtScriptList)로 등록하는 화면입니다. 등록이 끝나면 자동으로 CQELSVR 실행 목록 화면으로 이동합니다.

🕒 시작일시(startdate)의 타임존 규약 — 반드시 읽어 주세요

구분	기준
화면 입력·표시	여러분의 브라우저 로컬 시각(예: 한국이면 KST, 일본이면 JST)
전송·저장	UTC (ISO 8601). 화면이 전송 직전에 자동 변환합니다.

입력란에는 지금 쓰고 있는 PC의 시각 그대로 넣으면 됩니다. 사용자가 직접 UTC로 계산해서 넣을 필요가 없습니다.
화면이 저장 버튼을 누른 시점에 로컬 시각 → UTC로 변환해서 서버에 보냅니다. 데이터베이스에는 UTC 값이 기록됩니다.
그래서 CQELSVR 실행 목록의 lastdate 같은 열은 UTC 기준 값입니다. 로컬 시각과 시차만큼 달라 보이는 것이 정상입니다.

시작일시를 미래로 넣으면 그때까지 실행되지 않습니다

시작일시는 "이 시각 이전에는 실행하지 말라"는 의미입니다. 미래 시각을 넣으면 그 시각이 될 때까지 에이전트가 이 스케줄을 가져가지 않습니다. 지금 바로 실행하고 싶다면 시작일시를 현재 시각(또는 과거)으로 두세요. 화면을 열면 기본값으로 현재 로컬 시각이 채워져 있으므로, 즉시 실행이 목적이라면 그대로 두면 됩니다.

⚠️ 과거에는 화면이 로컬 시각 문자열을 UTC 변환 없이 그대로 보내서, UTC로 동작하는 DB에 시차만큼 미래 시각이 저장되는 문제가 있었습니다(giip #2537). 그 경우 픽업 순서에서 영구히 밀려 스케줄이 아예 실행되지 않았습니다. 현재는 화면이 변환 책임을 지도록 고쳐졌습니다.

🔍 화면 구성

1. 스크립트 선택 (mssn)

mssn 입력: 실행할 스크립트의 고유 ID를 직접 입력합니다.
선택 버튼: 클릭하면 현재 프로젝트(csn)의 스크립트 레포지토리 목록이 팝업으로 열립니다. 키워드로 검색하고 Prev / Next로 페이지를 넘길 수 있으며, 행의 선택을 누르면 mssn과 script type이 자동으로 채워집니다.
필수 항목입니다. 비워 두면 저장되지 않습니다.

2. 대상 서버 선택 (LSSN 그룹)

현재 프로젝트(csn)에 등록된 논리 서버 목록이 체크박스로 표시됩니다. LSSN — 용도 @ 호스트명 형태로 보여집니다.
여러 서버를 동시에 선택할 수 있으며, 선택한 서버 각각에 스케줄이 등록됩니다.
최소 1개 이상을 선택해야 저장됩니다.

3. 실행 옵션

csn: 프로젝트 번호. 로그인 세션에서 자동으로 채워집니다.
interval: 반복 실행 주기(분 단위).
active: 스케줄 활성 여부. 꺼 두면 등록만 되고 자동 실행되지 않습니다.
script type: 스크립트 종류(스크립트 선택 시 자동 입력됩니다).
repeat: 반복 실행 여부. 끄면 1회성 스케줄이 됩니다.
startdate: 시작일시(YYYY-MM-DD HH:mm). 위 "타임존 규약" 절 참조.
auid: 실행 요청자 ID. 로그인 세션의 사용자 ID가 기본값으로 채워집니다.

4. 커스텀 값 (custom_values)

원본 스크립트를 수정하지 않고 값만 바꿔 실행하고 싶을 때 사용합니다. 원본 스크립트 안에 {{customvalues}} 라고 표시된 자리에 여기에 입력한 내용이 치환되어 삽입됩니다.

5. 저장 / 취소

Save: 입력값을 검증하고 큐에 등록한 뒤, CQELSVR 실행 목록 화면으로 이동합니다.
Cancel: 등록하지 않고 실행 목록 화면으로 돌아갑니다.

⚙️ 요구사항

**로그인 세션(CSN)**이 필요합니다. 세션이 없으면 서버 목록과 스크립트 목록을 불러올 수 없습니다.
등록하려는 스크립트(mssn)와 서버(lssn)가 모두 현재 프로젝트에 속해 있어야 합니다.

문제 해결

증상	원인	해결
LSSN 그룹 목록이 비어 있음	현재 프로젝트(csn)에 등록된 논리 서버가 없거나 세션이 만료됨	상단에서 올바른 프로젝트를 선택했는지 확인하고, 필요하면 다시 로그인합니다.
"mssn 은 필수입니다" 오류	스크립트를 선택하지 않고 저장을 눌렀음	선택 버튼으로 레포지토리에서 스크립트를 고릅니다.
"최소 하나의 LSSN 을 선택하세요" 오류	대상 서버를 하나도 체크하지 않았음	LSSN 그룹에서 서버를 1개 이상 체크합니다.
"시작일: YYYY-MM-DD HH:mm 또는 ISO 형식 사용" 오류	시작일시 형식을 해석할 수 없음	`2026-09-15 14:30` 형태로 다시 입력합니다. 비워 두어도 됩니다.
등록했는데 실행 목록의 `lastdate`가 입력한 시각과 다르게 보임	`lastdate`는 UTC 기준으로 표시되고, 입력은 로컬 시각이었음	정상 동작입니다. 시차만큼 차이 나는 것이 맞습니다.
등록했는데 몇 분이 지나도 에이전트가 가져가지 않음	시작일시를 미래로 지정했거나, `active`가 꺼져 있음	시작일시를 확인하고, 즉시 실행이 필요하면 현재 시각으로 다시 등록합니다. `active`도 켜져 있는지 확인합니다.

🔌 CQE API (자동화용)

이 화면의 동작은 다음 CQE API 버브(byAK/bySk 디스패처)에 대응합니다. 요청은 text(버브+파라미터 이름), jsondata(값), token을 보냅니다.

CQEQueuePut mssn lssngroup csn interval active script_type custom_values repeat startdate auid — 선택한 서버들(lssngroup, 쉼표 구분)에 스케줄을 등록합니다. startdate는 UTC ISO 8601 문자열(예: 2026-09-15T05:30:00.000Z)로 보내야 합니다. 로컬 시각 문자열을 그대로 보내면 DB에 미래 시각이 저장되어 스케줄이 실행되지 않습니다.
CQERepoList csn <offset> [N'keyword'] — 스크립트 선택 팝업에 표시할 레포지토리 목록을 조회합니다(한 번에 15건).
LSVRList csn — 해당 프로젝트에 등록된 논리 서버 목록을 조회합니다(LSSN 그룹 체크박스에 사용).

권한 모델: 이 페이지의 API는 giip-issue 스킬의 x-api-key(SK) 방식이 아니라, 로그인 세션의 user_id+token 값을 함께 전송하는 세션 토큰 방식입니다.

인접 기능 전체 사양: CQELSVR 실행 목록 가이드, CQE 레포지토리 스크립트 관리 가이드, giipdb docs/30_Specs/CQE_SPECIFICATION.md.

버전: 1.0 최종 업데이트: 2026-09-15 소스 파일: giipv3/public/help/cqeQueuePut.ko.md