생성¶
POST /api/v1/checker/add
개요¶
일반, 지능형 또는 AI 시맨틱 모니터를 생성합니다.
호출 전 및 사용 단계¶
먼저 대상 워크스페이스에서 DQL을 검증하고, 알고리즘에 따라 전체 jsonScript와 유효한 연결 객체를 작성합니다. 일반 규칙은 기본적으로 기본 모니터 그룹에 추가되며, 새 규칙은 기본적으로 활성화됩니다. 먼저 비활성화해야 하는 경우 status=2를 명시적으로 지정합니다. 생성 시 고비용 DQL 검사, 매개변수 검증 및 스케줄 제출이 동기적으로 수행됩니다. 한 번의 검사 결과를 반환하지 않으며, HTTP 200을 알림이 이미 전달되었다는 의미로 간주하지 않습니다.
API 호출, 스케줄, 데이터베이스, 태그/연결 및 캐시는 하나의 서비스 간 원자적 트랜잭션이 아닙니다. 오류 발생 시 이미 기본 규칙/스케줄이 존재할 수 있으므로, 재시도 전에 목록/get에서 uuid, status 및 최종 연결을 확인하여 중복 작업을 피합니다. 외부 이벤트는 생성/저장된 secret+subUri로 Webhook을 구성하며, 이 요청에서는 이벤트를 트리거하지 않습니다. 지능형 V2 구성은 10분 고정 스케줄을 사용하고 YAML을 동기적으로 검증합니다. AI 시맨틱 참조는 여전히 데이터 권한의 제약을 받으며, 예산 제한은 실제 소비 약정으로 간주할 수 없습니다.
요청 헤더¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Body 요청 매개변수¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| alertPolicyUUIDs[*] | string | 배열 단일 항목입니다. 예시: altpl_example가져오기 또는 입력 방법: 알림 정책 목록에서 uuid를 가져옵니다. |
|
| permissionSet[*] | string | 단일 작업 주체입니다. 예시: wsAdmin가져오기 또는 입력 방법: 현재 워크스페이스의 역할/멤버/팀에서 가져옵니다. |
|
| jsonScript.targets[*] | json | 유형에 따라 하위 구조를 사용합니다. 예시: {"dql": "M::cpu:(avg(usage_idle)) BY host", "alias": "Result", "qtype": "dql"}가져오기 또는 입력 방법: 하나의 쿼리 또는 조합 멤버입니다. |
|
| jsonScript.targets[*].dql | string | qtype으로 지정되는 DQL 또는 PromQL 텍스트입니다. 예시: M::cpu:(avg(usage_idle)) BY host가져오기 또는 입력 방법: 대상 워크스페이스의 실제 데이터를 기준으로 작성하고 검증합니다. |
|
| jsonScript.targets[*].qtype | string | 선택 사항이며 일반적으로 dql입니다. 예시: dql가져오기 또는 입력 방법: DQL이면 dql, PromQL이면 promql을 선택합니다. |
|
| jsonScript.targets[*].alias | string | 일반 플러그인은 Result 또는 빈 값만 허용하며 중복되면 안 됩니다. 예시: Result가져오기 또는 입력 방법: 일반 단일 쿼리는 Result를 사용하고, 조합 멤버는 A/B 등으로 할당합니다. |
|
| jsonScript.targets[*].monitorCheckerId | string | combinedCheck 전용이며, 멤버는 Cron 충돌이 있는 규칙일 수 없습니다. 예시: rul_checker_example가져오기 또는 입력 방법: 현재 워크스페이스의 모니터 목록에서 사용 가능한 멤버 UUID를 가져옵니다. |
|
| jsonScript.groupBy[*] | string | 단일 차원입니다. 예시: host가져오기 또는 입력 방법: 실제 DQL BY 필드입니다. |
|
| jsonScript.checkFuncs[*] | json | seniorCheck는 첫 번째 항목에 따라 사용합니다. 예시: {"funcId": "example.func", "kwargs": {}}가져오기 또는 입력 방법: 기존 호환 사용자 지정 함수 구성에서 가져옵니다. |
|
| jsonScript.checkFuncs[*].funcId | string | 호환 함수 식별자입니다. 예시: example.func가져오기 또는 입력 방법: 실제 사용 가능한 함수 ID입니다. |
|
| jsonScript.checkFuncs[*].kwargs | json | 동적 객체이며 통일된 필수 하위 키가 없습니다. 예시: {}가져오기 또는 입력 방법: 해당 함수의 전용 매개변수 구조입니다. |
|
| jsonScript.checkFuncs[*].kwargs.参数名 | any | 단일 함수 전용 값입니다. 예시: 1가져오기 또는 입력 방법: 해당 함수 문서에서 이름/유형/출처를 가져옵니다. |
|
| jsonScript.checkerOpt.rules[*] | json | 알고리즘에 따라 서로 다른 조건 구조를 사용할 수 있습니다. 예시: {"status": "warning", "conditionLogic": "and", "conditions": [{"alias": "Result", "operator": "<", "operands": [10]}]}가져오기 또는 입력 방법: 단일 알림 등급의 조건입니다. |
|
| jsonScript.checkerOpt.rules[*].status | string | 공통 플러그인 허용 집합이며 실제 검사 유형에 따라 사용합니다. 예시: warning가져오기 또는 입력 방법: 이벤트 등급에 따라 fatal/critical/error/warning/info/ok/ALL 중에서 선택합니다. |
|
| jsonScript.checkerOpt.rules[*].conditionLogic | string | 공통 조건에서 필수입니다. 예시: and가져오기 또는 입력 방법: and/or입니다. |
|
| jsonScript.checkerOpt.rules[*].conditions | array | 공통 조건 필수 배열입니다. 예시: [{"alias": "Result", "operator": "<", "operands": [10]}]가져오기 또는 입력 방법: 실제 쿼리 결과와 임계값에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].okConditions | array | 선택 사항이며 openOkConditions와 함께 사용합니다. 임계값 비교 방향은 트리거와 반대여야 하고 경계가 유효해야 합니다. 예시: [{"alias": "Result", "operator": ">=", "operands": [20]}]가져오기 또는 입력 방법: 등급별 복구를 위해 독립적인 경계를 설정합니다. |
|
| jsonScript.checkerOpt.rules[*].matchTimes | integer | 선택 사항이며 openMatchTimes와 함께 사용합니다. 활성화 시 기본값은 1이고 실제 범위는 1..100이며, 초과 시 ErrorContinuousTriggerCfgCount가 발생합니다. 예시: 2가져오기 또는 입력 방법: 비즈니스에서 몇 번 연속 이상이어야 트리거할지 설정합니다. |
|
| jsonScript.checkerOpt.rules[*].conditions[*] | json | 단일 비교 조건입니다. 예시: {"alias": "Result", "operator": "<", "operands": [10]}가져오기 또는 입력 방법: 실제 쿼리 Result와 임계값으로 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].conditions[*].alias | string | 대상 alias와 일치해야 합니다. 예시: Result가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].conditions[*].operator | string | 공통 연산자 =, !=, >, >=, <, <=, between, notBetween, like, notLike, in, notIn, regExp, notRegExp, isTrue, isFalse, likeTrue, likeFalse이며 구체적인 알고리즘에 따라 범위가 좁아질 수 있습니다. 예시: <가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].conditions[*].operands | array | 문자열/숫자 배열이며 실제 결과 단위를 유지합니다. 불리언/객체는 전달하지 않으며, 빈 값 조건은 필터링될 수 있습니다. 예시: [10]가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].conditions[*].operands[*] | JSON | 단일 임계값입니다. 숫자 비교에는 JSON 숫자를, 정규식/집합에는 실제 규칙에 따라 문자열을 제공합니다. 예시: 10가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].okConditions[*] | json | 단일 비교 조건입니다. 예시: {"alias": "Result", "operator": "<", "operands": [10]}가져오기 또는 입력 방법: 실제 쿼리 Result와 임계값으로 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].okConditions[*].alias | string | 대상 alias와 일치해야 합니다. 예시: Result가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].okConditions[*].operator | string | 공통 연산자 =, !=, >, >=, <, <=, between, notBetween, like, notLike, in, notIn, regExp, notRegExp, isTrue, isFalse, likeTrue, likeFalse이며 구체적인 알고리즘에 따라 범위가 좁아질 수 있습니다. 예시: <가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].okConditions[*].operands | array | 문자열/숫자 배열이며 실제 결과 단위를 유지합니다. 불리언/객체는 전달하지 않으며, 빈 값 조건은 필터링될 수 있습니다. 예시: [10]가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.checkerOpt.rules[*].okConditions[*].operands[*] | JSON | 단일 임계값입니다. 숫자 비교에는 JSON 숫자를, 정규식/집합에는 실제 규칙에 따라 문자열을 제공합니다. 예시: 10가져오기 또는 입력 방법: 동일한 쿼리 대상, 데이터 단위 및 비즈니스 경계에 따라 구성합니다. |
|
| jsonScript.channels[*] | string | 배열의 단일 유효 값입니다. 예시: chan_example가져오기 또는 입력 방법: 상위 설명의 채널 또는 계정 식별자를 가져옵니다. |
|
| jsonScript.atAccounts[*] | string | 배열의 단일 유효 값입니다. 예시: acnt_example가져오기 또는 입력 방법: 상위 설명의 채널 또는 계정 식별자를 가져옵니다. |
|
| jsonScript.atNoDataAccounts[*] | string | 배열의 단일 유효 값입니다. 예시: acnt_example가져오기 또는 입력 방법: 상위 설명의 채널 또는 계정 식별자를 가져옵니다. |
|
| jsonScript.checkerOpt.infoEventCondition.operands[*] | JSON | 문자열 또는 숫자입니다. 예시: 60가져오기 또는 입력 방법: 쿼리 Result와 동일한 단위의 비교 값입니다. |
|
| jsonScript.checkerOpt.rules[*].strength | integer | 레거시 유형 전용이며, 기존 mutationsCheck 강도 1/2/3입니다. 새 고급 유형은 해당 checkerOpt 필드를 사용하며 혼용하지 않습니다. 예시: 2가져오기 또는 입력 방법: 기존 레거시 알고리즘을 유지보수할 때 원래 상세에서 읽습니다. |
|
| jsonScript.checkerOpt.rules[*].direction | string | 레거시 유형 전용이며, 기존 mutationsCheck/rangeCheck 방향 up/down/both입니다. 새 고급 유형은 해당 checkerOpt 필드를 사용하며 혼용하지 않습니다. 예시: both가져오기 또는 입력 방법: 기존 레거시 알고리즘을 유지보수할 때 원래 상세에서 읽습니다. |
|
| jsonScript.checkerOpt.rules[*].checkCount | integer | 레거시 유형 전용이며, 기존 변동 감지 검사 횟수(정수)입니다. 새 고급 유형은 해당 checkerOpt 필드를 사용하며 혼용하지 않습니다. 예시: 3가져오기 또는 입력 방법: 기존 레거시 알고리즘을 유지보수할 때 원래 상세에서 읽습니다. |
|
| jsonScript.checkerOpt.rules[*].periodNum | integer | 레거시 유형 전용이며, 기존 변동/구간 주기 수(정수)입니다. 새 고급 유형은 해당 checkerOpt 필드를 사용하며 혼용하지 않습니다. 예시: 3가져오기 또는 입력 방법: 기존 레거시 알고리즘을 유지보수할 때 원래 상세에서 읽습니다. |
|
| extend.isNeedCreateIssue | boolean | 기본값 false이며, 활성화 시 채널/담당자/상태/등급 매핑도 함께 검증합니다. 예시: false가져오기 또는 입력 방법: 이벤트에서 Issue를 자동 생성해야 하면 true로 설정합니다. |
|
| extend.issueLevelUUID | string | 레거시 호환 등급입니다. 유효하지 않으면 빈 값으로 정리될 수 있으며, 성공 응답이 등급 적용을 보장하지 않습니다. 예시: issl_example가져오기 또는 입력 방법: 유효한 Issue 등급 목록에서 uuid를 가져옵니다. |
|
| extend.issueDfStatus | array | 요소는 fatal/critical/error/warning/nodata로 제한됩니다. 예시: ["critical", "error"]가져오기 또는 입력 방법: 어떤 이상 등급이 Issue를 트리거할지 선택합니다. |
|
| extend.issueDfStatus[*] | string | 허용되는 단일 상태입니다. 예시: error가져오기 또는 입력 방법: 실제 알림 등급입니다. |
|
| extend.manager | array | 담당자 목록은 구체적인 대상으로 정규화됩니다. 온콜 담당자는 워크스페이스 시간대 기준 당일 캘린더로 해석되며, 이번 쓰기 이후 교대에 따라 자동으로 변경되지 않습니다. 예시: ["acnt_example"]가져오기 또는 입력 방법: 워크스페이스 멤버/팀/알림 일정에서 담당자 대상을 가져옵니다. |
|
| extend.manager[*] | string | 단일 담당자이며, 먼저 출처가 유효한지 확인합니다. 예시: acnt_example가져오기 또는 입력 방법: 멤버/팀 또는 지원되는 당일 온콜 대상 식별자입니다. |
|
| extend.incidentsTags | array | Issue 연결 태그에 사용되며, 규칙에 따라 태그를 생성/검증할 수 있습니다. 예시: ["production"]가져오기 또는 입력 방법: 모니터 적용 태그 이름에서 가져옵니다. |
|
| extend.incidentsTags[*] | string | UUID가 아닙니다. 예시: production가져오기 또는 입력 방법: 실제 비즈니스 태그 이름입니다. |
|
| extend.faultMappingMode | string | Issue 활성화 시 기본값은 custom이며, existing은 유효한 levelMappingUUID가 필요합니다. 예시: custom가져오기 또는 입력 방법: 사용자 지정 매핑은 custom, 기존 매핑 참조는 existing입니다. |
|
| extend.levelMappingUUID | string | existing 조건에서는 유효한 UUID가 필수이며, custom 분기에서는 이 참조 필드를 제거하지만 기존 사용자 지정 행은 유지합니다. 예시: islm_example가져오기 또는 입력 방법: 현재 워크스페이스에서 사용 가능한 이상 등급 매핑 구성에서 가져옵니다. |
|
| extend.bindIncidentsInfo | array | custom 매핑 행입니다. custom으로 다시 전환하면서 이 키를 생략하면 controller가 기존 행을 유지할 수 있으나, 공개 extend 전체를 그대로 재기입할 때는 여전히 주의해야 합니다. 예시: [{"incidentsLevelUUID": "issl_example", "incidentsDfStatus": ["error"]}]가져오기 또는 입력 방법: 이벤트 등급에 대응하는 Issue 등급으로 구성합니다. |
|
| extend.bindIncidentsInfo[*] | json | 하나의 매핑 객체입니다. 예시: {"incidentsLevelUUID": "issl_example", "incidentsDfStatus": ["error"]}가져오기 또는 입력 방법: 단일 상태에서 등급으로의 매핑입니다. |
|
| extend.bindIncidentsInfo[*].incidentsLevelUUID | string | 유효하지 않은 등급은 비워질 수 있습니다. 예시: issl_example가져오기 또는 입력 방법: 유효한 Issue 등급 목록에서 가져옵니다. |
|
| extend.bindIncidentsInfo[*].incidentsDfStatus | array | 허용 상태 배열입니다. 예시: ["error"]가져오기 또는 입력 방법: fatal/critical/error/warning/nodata에서 선택합니다. |
|
| extend.bindIncidentsInfo[*].incidentsDfStatus[*] | string | 허용되는 단일 값입니다. 예시: error가져오기 또는 입력 방법: 실제 이벤트 등급입니다. |
|
| extend.smartMonitor.source | string | ai/builtin이며, 신규 OpenAPI는 생성 자격 증명 없이 전체 유효 구성을 직접 전달할 수 있습니다. 예시: ai가져오기 또는 입력 방법: 해당 생성 결과/내장 템플릿 메타 정보에서 가져오며, 사이트의 실제 템플릿 ID를 임의로 만들지 않습니다. |
|
| extend.smartMonitor.category | string | 출처 분류입니다. V2 수정 시 변경할 수 없습니다. 예시: custom가져오기 또는 입력 방법: 해당 생성 결과/내장 템플릿 메타 정보에서 가져오며, 사이트의 실제 템플릿 ID를 임의로 만들지 않습니다. |
|
| extend.smartMonitor.prompt | string | AI 프롬프트입니다. 기존 prompt가 변경되면 후보를 다시 생성해야 합니다. 예시: 检测生产主机异常。가져오기 또는 입력 방법: 해당 생성 결과/내장 템플릿 메타 정보에서 가져오며, 사이트의 실제 템플릿 ID를 임의로 만들지 않습니다. |
|
| extend.smartMonitor.templateId | string | builtin 출처 템플릿 식별자입니다. 수정 시 변경할 수 없습니다. 예시: template_example가져오기 또는 입력 방법: 해당 생성 결과/내장 템플릿 메타 정보에서 가져오며, 사이트의 실제 템플릿 ID를 임의로 만들지 않습니다. |
|
| extend.smartMonitor.templateVersion | string | builtin 템플릿 버전입니다. 수정 시 변경할 수 없습니다. 예시: 1가져오기 또는 입력 방법: 해당 생성 결과/내장 템플릿 메타 정보에서 가져오며, 사이트의 실제 템플릿 ID를 임의로 만들지 않습니다. |
|
| extend.smartMonitor | json | V2 전용입니다. 서버가 위조된 실행/버전 상태를 정리하고 engineVersion/configVersion을 기록합니다. 허용된 필드는 유지하며 기존 출처 분류는 변경할 수 없습니다. 예시: {"source": "ai", "category": "custom", "prompt": "检测生产主机异常。"}가져오기 또는 입력 방법: 생성 또는 템플릿 선택 흐름에서 출처 메타 정보를 가져옵니다. |
|
| extend.querylist | array | 선택 사항입니다. 존재하면 유지되고 queryType 자동 주입보다 우선합니다. targets의 실제 DQL을 대체하지 않으며, 오류 응답 구조가 검사 정상 동작을 증명하지 않습니다. 예시: []가져오기 또는 입력 방법: 기존 클라이언트 응답 구성이 있으면 원래 상세에서 전체 배열을 가져옵니다. |
|
| extend.querylist[*] | json | 동적 편집기 객체이며 클라이언트 버전에 따라 저장됩니다. 실제 검사는 targets에만 근거합니다. 예시: {"qtype": "dql", "query": {"q": "M::cpu:(avg(usage_idle)) BY host"}}가져오기 또는 입력 방법: 클라이언트 편집기에서 생성된 단일 쿼리 응답입니다. |
|
| extend.querylist[*].qtype | string | 실행 쿼리를 자동 변환하지 않습니다. 예시: dql가져오기 또는 입력 방법: dql/promql 쿼리 유형 응답입니다. |
|
| extend.querylist[*].query | json | simple/dql 모드 세부 정보를 포함할 수 있으며, targets를 대체할 수 없습니다. 예시: {"q": "M::cpu:(avg(usage_idle)) BY host"}가져오기 또는 입력 방법: 클라이언트가 생성한 쿼리 편집 구조입니다. |
|
| extend.querylist[*].query.q | string | 전체 DQL/PromQL 응답 값입니다. 예시: M::cpu:(avg(usage_idle)) BY host가져오기 또는 입력 방법: 실제 targets 쿼리 텍스트와 일치시킵니다. |
|
| alertPolicyUUIDs | array | 선택 사항입니다. 생성 시 생략하거나 []이면 바인딩하지 않고, 수정 시 생략하면 기존 연결을 유지하며 명시적 []은 비웁니다. 입력 전체 집합의 사용 가능 여부를 검증하며 조용히 필터링하지 않습니다. 정책 비활성화는 현재 알림을 보낼 수 있음을 의미하지 않습니다. null 허용: False 예시: ["altpl_example"]가져오기 또는 입력 방법: 알림 정책 목록에서 이 워크스페이스의 삭제되지 않은 정책 uuid를 가져옵니다. |
|
| configVersion | integer | 이전 버전에서는 생략할 수 있습니다. V2 수정 시 현재 양의 정수 버전이 필수이며, 만료 시 HTTP 409 ft.SmartMonitorVersionConflict가 발생합니다. 생성 시 최종 버전을 사용자 지정하지 않습니다. $minValue: 1 예시: 1가져오기 또는 입력 방법: 현재 V2 상세 content.configVersion에서 가져옵니다. |
|
| dashboardUUID | string | 선택 사항이며, 신규 연결 시 유효성을 검사합니다. 수정 시 생략하거나 빈 문자열이면 기존 대시보드 참조가 제거되며 유지되지 않습니다. null 허용: False 예시: dsbd_example가져오기 또는 입력 방법: 대시보드 목록에서 이 워크스페이스의 유효한 객체 UUID를 가져옵니다. |
|
| extend | json | 선택 사항이며 null은 OpenAPI를 거치며 {}로 정규화됩니다. 공개 생성/수정 시 rules/querylist가 주입됩니다. 명시적 객체는 전체 구성으로 처리되고 깊은 병합은 하지 않습니다. 수정 시 완전히 생략해도 응답 값을 거쳐 정규화되어 기록되므로 기존 extend가 자동으로 완전히 유지된다고 의존할 수 없습니다. 중요한 필드는 다시 채워야 합니다. null 허용: True 예시: {}가져오기 또는 입력 방법: 일반 규칙의 인시던트 연결 및 클라이언트 응답은 아래 중첩 필드에 따라 작성하고, 편집 시 현재 상세에서 가져옵니다. |
|
| generationId | string | 선택적 후보 자격 증명이며 워크스페이스/ID/대상 규칙 및 prompt에 바인딩됩니다. AI V2에서 전달할 경우 유효한 후보와 일치해야 합니다. OpenAPI 신뢰 호환 생성에서는 자격 증명 없이 가능하지만, 기존 prompt를 변경하려면 다시 생성한 후 전달해야 하며 위조할 수 없습니다. 구성 UUID 또는 실행 작업 ID가 아닙니다. 예시: GENERATION-ID가져오기 또는 입력 방법: 지능형 모니터링 생성 응답의 X-Smart-Monitor-Generation-Id에서 가져옵니다. |
|
| jsonScript | json | 비즈니스상 전체 객체를 반드시 제공해야 하며, 상위에서 선택 사항으로 선언되어 있어도 마찬가지입니다. 수정 시 전체 구성을 다시 채웁니다. V2 및 AI 시맨틱 구성은 일반 검사와 다르므로 get 응답 전체를 Body로 사용하지 않습니다. 이 페이지에 선언된 필드만 사용하며, 내부 고정 Cron/다중 워크스페이스 배열 등 선언되지 않은 키를 추가하지 않습니다. null 허용: False 예시: {"type": "simpleCheck", "title": "生产CPU阈值", "name": "生产CPU阈值", "every": "1m", "interval": 300, "groupBy": ["host"], "targets": [{"dql": "M::cpu:(avg(usage_idle)) BY host", "alias": "Result", "qtype": "dql"}], "checkerOpt": {"rules": [{"status": "warning", "conditionLogic": "and", "conditions": [{"alias": "Result", "operator": "<", "operands": [10]}]}]}}가져오기 또는 입력 방법: 먼저 이 페이지에서 지원하는 검사 유형을 선택한 후 전체 검사/템플릿/쿼리/트리거 정의를 작성합니다. |
|
| jsonScript.atAccounts | array | 선택적 배열이며 기본값은 []입니다. channels는 인시던트 연결에 사용되며 직접 알림 대상이 아니고, 서버가 기본 채널을 보완하거나 유효하지 않은 채널을 필터링할 수 있습니다. @외부 이메일은 무료/무료 플랜 버전에서 제한됩니다. 저장은 알림 전송 완료를 의미하지 않습니다. null 허용: False 예시: ["acnt_example"]가져오기 또는 입력 방법: 채널은 채널 목록에서 uuid를 가져오고, @ID는 멤버 목록에서 계정 uuid 또는 지원되는 이메일을 가져옵니다. |
|
| jsonScript.atNoDataAccounts | array | 선택적 배열이며 기본값은 []입니다. channels는 인시던트 연결에 사용되며 직접 알림 대상이 아니고, 서버가 기본 채널을 보완하거나 유효하지 않은 채널을 필터링할 수 있습니다. @외부 이메일은 무료/무료 플랜 버전에서 제한됩니다. 저장은 알림 전송 완료를 의미하지 않습니다. null 허용: False 예시: ["acnt_example"]가져오기 또는 입력 방법: 채널은 채널 목록에서 uuid를 가져오고, @ID는 멤버 목록에서 계정 uuid 또는 지원되는 이메일을 가져옵니다. |
|
| jsonScript.channels | array | 선택적 배열이며 기본값은 []입니다. channels는 인시던트 연결에 사용되며 직접 알림 대상이 아니고, 서버가 기본 채널을 보완하거나 유효하지 않은 채널을 필터링할 수 있습니다. @외부 이메일은 무료/무료 플랜 버전에서 제한됩니다. 저장은 알림 전송 완료를 의미하지 않습니다. null 허용: False 예시: ["chan_example"]가져오기 또는 입력 방법: 채널은 채널 목록에서 uuid를 가져오고, @ID는 멤버 목록에서 계정 uuid 또는 지원되는 이메일을 가져옵니다. |
|
| jsonScript.checkFuncs | array | 선택 사항이며 일반 임계값에는 제공할 필요가 없습니다. seniorCheck는 첫 번째 항목의 funcId/kwargs에 따라 사용하며 모든 함수를 범용 매개변수로 취급하지 않습니다. null 허용: False 예시: []가져오기 또는 입력 방법: 이 호환 사용자 지정 함수 구조를 사용하는 레거시 검사 유형만 유지보수하고, 원래 상세/함수 정의에서 가져옵니다. |
|
| jsonScript.checkerOpt | json | 일반 규칙은 주로 rules를 사용합니다. 고급 유형은 해당 알고리즘에 따라 작성하고, V2는 yamlConfig, AI 시맨틱은 userPrompt 등을 사용합니다. 선언되지 않은 하위 필드는 공개 검증에서 거부되며, 내부 SDK 매개변수 전체를 복사할 수 없습니다. null 허용: False 예시: {"rules": [{"status": "warning", "conditionLogic": "and", "conditions": [{"alias": "Result", "operator": "<", "operands": [10]}]}]}가져오기 또는 입력 방법: jsonScript.type에 따라 다음 트리거/알고리즘/AI 구성을 선택합니다. |
|
| jsonScript.checkerOpt.category | string | AI 시맨틱 전용입니다. AI 시맨틱 분류 메타 정보이며 선택적 문자열입니다. null 허용: False 예시: custom가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.combineExpr | string | 유형 전용 매개변수입니다. 조합 멤버 alias 표현식이며 조합 유형에서는 비어 있으면 안 됩니다. Result로 멤버 alias를 대체하지 않습니다. 빈 문자열 허용: False 예시: A && B가져오기 또는 입력 방법: 현재 검사 유형에 따라 편집기/원래 상세에서 구체적인 알고리즘 의미를 확인합니다. |
|
| jsonScript.checkerOpt.confidenceInterval | integer | 유형 전용 매개변수입니다. 구간 V2 신뢰 구간 1..100이며 실제 알고리즘에 따라 구성합니다. 예시: 90가져오기 또는 입력 방법: 현재 검사 유형에 따라 편집기/원래 상세에서 구체적인 알고리즘 의미를 확인합니다. |
|
| jsonScript.checkerOpt.contextWindowLimit | integer | AI 시맨틱 전용입니다. 양의 정수 Token 컨텍스트 제한이며 ≥1입니다. null 허용: False $minValue: 1 예시: 8192가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.creditSoftBudget | number | AI 시맨틱 전용입니다. 단일 Credit 소프트 예산이며 유한한 숫자 >0입니다. API 실행 타임아웃이 아닙니다. null 허용: False 예시: 10가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.diffMode | string | 유형 전용 매개변수입니다. 고급 변동 value(차이)/percent(백분율)이며 명시적으로 제공해야 합니다. 선택 가능한 값: ['value', 'percent'] 예시: percent가져오기 또는 입력 방법: 현재 검사 유형에 따라 편집기/원래 상세에서 구체적인 알고리즘 의미를 확인합니다. |
|
| jsonScript.checkerOpt.direction | string | 유형 전용 매개변수입니다. 고급 변동/구간 up/down/both이며 명시적으로 제공해야 합니다. 선택 가능한 값: ['up', 'down', 'both'] 예시: both가져오기 또는 입력 방법: 현재 검사 유형에 따라 편집기/원래 상세에서 구체적인 알고리즘 의미를 확인합니다. |
|
| jsonScript.checkerOpt.disableLargeScaleEventProtect | boolean | 선택적 불리언입니다. true이면 대규모 이벤트 보호를 비활성화하고 기본값 false이면 보호를 유지합니다. 예시: false가져오기 또는 입력 방법: 비즈니스에서 해당 알림/이벤트 처리 동작을 확인합니다. |
|
| jsonScript.checkerOpt.enableStreamingAggregation | boolean | 선택적 3상태입니다. 지원되는 유형의 스트리밍 집계 가속만 제어하며, 모니터 활성화/비활성화 또는 DQL 의미 변경과 같지 않습니다. null 허용: True 예시: true가져오기 또는 입력 방법: 독립 스위치가 필요하면 true/false, 워크스페이스 구성을 따르려면 생략 또는 null입니다. |
|
| jsonScript.checkerOpt.eps | float | 유형 전용 매개변수입니다. 이상치(outlier)에 필수이며 값 범위는 0..3.0입니다. 이 알고리즘은 일반 rules 조건 검증을 사용하지 않습니다. 예시: 0.5가져오기 또는 입력 방법: 현재 검사 유형에 따라 편집기/원래 상세에서 구체적인 알고리즘 의미를 확인합니다. |
|
| jsonScript.checkerOpt.ignoreNodata | boolean | 선택적 불리언입니다. 조합 모니터링에서만 true이면 데이터 없음 결과를 무시하며 기본값 false입니다. 예시: false가져오기 또는 입력 방법: 비즈니스에서 해당 알림/이벤트 처리 동작을 확인합니다. |
|
| jsonScript.checkerOpt.infoEvent | boolean | 선택적 불리언입니다. true이면 지속적으로 정상일 때 info를 생성하며 기본값 false입니다. infoEventCondition은 유형에 따라 조건을 제어합니다. 예시: false가져오기 또는 입력 방법: 비즈니스에서 해당 알림/이벤트 처리 동작을 확인합니다. |
|
| jsonScript.checkerOpt.infoEventCondition | json | 선택 사항이며 {}는 무조건 Info를 의미합니다. 일반 임계값/로그/애플리케이션 및 액세스 지표/가용성/프로세스/네트워크/변동/구간 등 지원 유형에만 적용됩니다. 이상치/조합/생존 V2/변경/프로그래밍 가능/지능형/SLO는 지원하지 않으며 전달 시 UnsupportTriggerFields가 발생합니다. 비어 있지 않으면 alias/operator/operands가 완전하고 유효해야 합니다. null 허용: False 예시: {"alias": "Result", "operator": ">=", "operands": [60]}가져오기 또는 입력 방법: 실제 쿼리 결과와 정상 비즈니스 임계값으로 구성합니다. |
|
| jsonScript.checkerOpt.infoEventCondition.alias | string | 비어 있지 않은 Info 조건 내에서 구조에 따라 작성하며, targets의 alias에 대응합니다. 예시: Result가져오기 또는 입력 방법: 실제 쿼리 대상 및 임계값과 일치시킵니다. |
|
| jsonScript.checkerOpt.infoEventCondition.operands | array | 비어 있지 않은 Info 조건 내에서 구조에 따라 작성합니다. 비교 값 배열이며 요소는 문자열/숫자이고 객체는 전달하지 않습니다. 예시: [60]가져오기 또는 입력 방법: 실제 쿼리 대상 및 임계값과 일치시킵니다. |
|
| jsonScript.checkerOpt.infoEventCondition.operator | string | 비어 있지 않은 Info 조건 내에서 구조에 따라 작성합니다. 이 페이지의 일반 조건 연산자 중에서 선택합니다. 예시: >=가져오기 또는 입력 방법: 실제 쿼리 대상 및 임계값과 일치시킵니다. |
|
| jsonScript.checkerOpt.maxChatRounds | integer | AI 시맨틱 전용입니다. 최대 대화 라운드 수이며 정수 ≥1입니다. null 허용: False $minValue: 1 예시: 3가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.maxDQLQueries | integer | AI 시맨틱 전용입니다. 최대 DQL 호출 횟수이며 정수 ≥0입니다. null 허용: False $minValue: 0 예시: 3가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.mentions | array | AI 시맨틱 선택 사항이며 기본값은 []입니다. 각 항목은 type=dql이고 namespace/datasource가 비어 있지 않아야 하며, index는 선택 사항이고 전달 시 비어 있지 않아야 합니다. 정규화된 JSON 직렬화 총 길이는 ≤20000자입니다. 데이터 쿼리 권한을 대체하지 않습니다. null 허용: False 예시: [{"type": "dql", "namespace": "logging", "index": "default", "datasource": "nginx"}]가져오기 또는 입력 방법: 실제 DQL 네임스페이스, 로그 인덱스 및 출처에서 참조 메타 정보를 가져옵니다. |
|
| jsonScript.checkerOpt.mentions[*] | object | type/namespace/datasource는 필수이고 index는 선택 사항입니다. 네 개 필드만 선언합니다. 예시: {"type": "dql", "namespace": "logging", "index": "default", "datasource": "nginx"}가져오기 또는 입력 방법: 각 항목은 하나의 DQL 참조입니다. |
|
| jsonScript.checkerOpt.mentions[*].datasource | string | 조건부 필수 | 참조 항목 내 실제 데이터 소스 이름이며, 예를 들어 로그 source/메저먼트입니다. 네임스페이스에 따라 해석됩니다. 빈 문자열 허용: False 예시: nginx가져오기 또는 입력 방법: 동일한 대상 워크스페이스의 실제 데이터에서 선택합니다. |
| jsonScript.checkerOpt.mentions[*].index | string | 참조 항목 내 로그 참조에 실제 인덱스 이름/식별자를 작성하며, 다른 유형에서는 생략할 수 있습니다. 빈 문자열 허용: False 예시: default가져오기 또는 입력 방법: 동일한 대상 워크스페이스의 실제 데이터에서 선택합니다. |
|
| jsonScript.checkerOpt.mentions[*].namespace | string | 조건부 필수 | 참조 항목 내 실제 DQL 네임스페이스이며 엔터티 type이 아닙니다. 빈 문자열 허용: False 예시: logging가져오기 또는 입력 방법: 동일한 대상 워크스페이스의 실제 데이터에서 선택합니다. |
| jsonScript.checkerOpt.mentions[*].type | string | 조건부 필수 | 참조 항목 내에서 dql로 고정됩니다. 선택 가능한 값: ['dql'] 예시: dql가져오기 또는 입력 방법: 동일한 대상 워크스페이스의 실제 데이터에서 선택합니다. |
| jsonScript.checkerOpt.model | string | AI 시맨틱 전용입니다. AI 시맨틱 선택적 모델 이름이며 사이트에서 지원하는 모델 구성에서 가져와야 하고 문서 예시의 리터럴 값을 사용할 수 없습니다. null 허용: False 예시: example-model가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.openMatchTimes | boolean | 선택적 불리언입니다. true이면 연속 트리거 매칭을 활성화하고 기본값 false입니다. rules[].matchTimes와 함께 사용합니다. 예시: false가져오기 또는 입력 방법: 비즈니스에서 해당 알림/이벤트 처리 동작을 확인합니다. |
|
| jsonScript.checkerOpt.openOkConditions | boolean | 선택적 불리언입니다. true이면 등급별 복구를 활성화하고 기본값 false입니다. okConditions는 트리거와 복구 경계를 충족해야 합니다. 예시: false가져오기 또는 입력 방법: 비즈니스에서 해당 알림/이벤트 처리 동작을 확인합니다. |
|
| jsonScript.checkerOpt.rules | array | 일반 규칙 조건 배열입니다. 각 항목에는 status/conditionLogic/conditions가 있으며 복구에는 okConditions를 사용합니다. 잘못된 멤버/연산 형태는 일반 예외를 발생시켜 최종 500이 될 수 있으며, 무조건 406은 아닙니다. 빈 operands 조건은 스케줄 구성 전에 필터링되므로 '전체'를 표현하는 데 사용하지 않습니다. null 허용: False 예시: [{"status": "warning", "conditionLogic": "and", "conditions": [{"alias": "Result", "operator": "<", "operands": [10]}]}]가져오기 또는 입력 방법: 허용되는 트리거 이벤트 등급과 대상 Result에 따라 구성합니다. |
|
| jsonScript.checkerOpt.script | string | 유형 전용 매개변수입니다. 프로그래밍 가능 검사 스크립트 텍스트이며 해당 유형에서 지원하는 구문을 사용합니다. 이 API는 스크립트 테스트를 한 번 실행하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: return {}가져오기 또는 입력 방법: 현재 검사 유형에 따라 편집기/원래 상세에서 구체적인 알고리즘 의미를 확인합니다. |
|
| jsonScript.checkerOpt.systemPrompt | string | AI 시맨틱 전용입니다. AI 시맨틱 선택 사항이며 전달 시 비어 있지 않아야 하고 Python 문자 ≤20000입니다. 빈 문자열 허용: True null 허용: False 최대 길이: 20000 예시: 结合实际查询结果判断,不臆测缺失数据。가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.threshold | json | 선택적 객체입니다. 제공 시 status/operator/value가 모두 필수로 선언됩니다. status=false이면 전제 조건 판단을 끄고, value는 null을 허용하지만 알고리즘의 실제 의미에 따라 작성해야 합니다. null 허용: False 예시: {"status": false, "operator": ">", "value": 90}가져오기 또는 입력 방법: 고급 변동의 트리거 전제 조건이며 실제 비즈니스 임계값으로 결정합니다. |
|
| jsonScript.checkerOpt.threshold.operator | string | 조건부 필수 | 상위 객체가 존재할 때 필수이며, 전제 비교 연산자입니다. 예: >. 실제 고급 검사 호환 집합에 따릅니다. 예시: >가져오기 또는 입력 방법: 고급 변동 전제 조건 정의에 따라 작성합니다. |
| jsonScript.checkerOpt.threshold.status | boolean | 조건부 필수 | 상위 객체가 존재할 때 필수이며 전제 조건 활성화 여부입니다. 예시: false가져오기 또는 입력 방법: 고급 변동 전제 조건 정의에 따라 작성합니다. |
| jsonScript.checkerOpt.threshold.value | float | 조건부 필수 | 상위 객체가 존재할 때 필수이며 전제 값입니다. status=false이면 null을 허용하고, status=true이면 반드시 숫자여야 하며 그렇지 않으면 IllegalMutationParameters가 발생합니다. 단위는 쿼리 결과와 일치해야 합니다. null 허용: True 예시: 90가져오기 또는 입력 방법: 고급 변동 전제 조건 정의에 따라 작성합니다. |
| jsonScript.checkerOpt.userPrompt | string | AI 시맨틱 전용입니다. AI 시맨틱 조건에서는 비어 있지 않아야 하며 Python 문자 ≤20000입니다. 빈 문자열이 선언상 허용되어도 비즈니스 로직은 공백을 허용하지 않습니다. 빈 문자열 허용: True null 허용: False 최대 길이: 20000 예시: 分析最近5分钟生产服务错误率是否异常。가져오기 또는 입력 방법: 현재 워크스페이스의 AI 시맨틱 모니터링 기능과 비즈니스 예산에 따라 구성하며, 선택 항목을 생략하면 AI 서비스의 기본 정책에 맡깁니다. |
|
| jsonScript.checkerOpt.yamlConfig | string | V2 전용 필수입니다. 비어 있지 않은 UTF8 YAML 텍스트 ≤256KiB이며 JSON 객체나 Markdown 펜스가 아닙니다. 구조는 이 페이지의 YAML 표를 참조하십시오. 앵커/별칭/명시적 tag/중복 키를 금지합니다. 수정 시 기존 DQL, threshold 구성 및 알고리즘 params만 허용되며 규칙 집합/이름/실행 구조는 변경할 수 없습니다. 저장 시 프로토콜/예산을 검증하고 쿼리 데이터 도메인 권한을 파싱하여 확인하지만, DQL을 실행하거나 데이터 존재/출처 권한이 완전히 재검토되었음을 보장하지 않습니다. 예시: "version: 1\nname: production\nevent:\n title: \"{{Scene.problem_title}}\"\n message: \"{{Scene.problem_message}}\"\nrules:\n - id: cpu_idle\n name: CPU idle\n query:\n dql: \"M::cpu:(avg(usage_idle)) BY host\"\n scene_by: [host]\n detect:\n threshold:\n operator: \"<\"\n operands: [10]\n display:\n signal: CPU idle\n"가져오기 또는 입력 방법: 생성 API 또는 내장 템플릿에서 전체 유효 YAML을 가져온 후 허용 범위 내에서 편집합니다. |
|
| jsonScript.customCrontab | string | 선택 사항이며 비어 있지 않으면 every보다 우선합니다. 5개 필드 또는 초를 포함한 6개 필드를 지원하며, 초 단위 스텝 형식은 20 미만일 수 없습니다. 조합 모니터링 및 조합 대상 멤버에는 사용자 지정 빈도 충돌 제한이 있습니다. V2에서는 금지됩니다. 검사 시간대는 현재 워크스페이스/서비스 구성에 따르며 문자열의 시간대 이름으로 필드를 대체하지 않습니다. null 허용: False 예시: 0 */5 * * * *가져오기 또는 입력 방법: 사용자 지정 빈도일 때 Cron 편집기에 전체 표현식을 작성합니다. |
|
| jsonScript.delaySeconds | integer | 선택적 일반 모니터링 데이터 대기 창이며 단위는 초입니다. 0은 대기하지 않음을 의미하고 기본값은 0입니다. 불리언은 정수로 허용되지 않습니다. 지능형/AI는 일반 대기 구성을 사용하지 않으며 이 값으로 지능형 실행 지연을 조정할 수 없습니다. null 허용: False 선택 가능한 값: [0, 60, 120, 180, 300, 600, 900, 1800] 예시: 60가져오기 또는 입력 방법: 데이터 도착 지연에 따라 0/60/120/180/300/600/900/1800을 선택합니다. |
|
| jsonScript.disableCheckEndTime | boolean | 선택적 호환 불리언이며 기본값 false이고 실제 지원 여부는 검사 유형에 따릅니다. null 허용: False 예시: false가져오기 또는 입력 방법: 검사 종료 시간 제한을 해제해야 하면 true로 설정합니다. |
|
| jsonScript.eventChartEnable | boolean | 선택 사항이며 기본값 false입니다. 지원되는 Doris 로그 주 저장소에서만 처리됩니다. 저장 성공이 차트 생성 완료를 의미하지 않습니다. null 허용: False 예시: false가져오기 또는 입력 방법: 이벤트 차트를 지원하는 데이터 저장 기능이 있을 때 선택합니다. |
|
| jsonScript.eventCharts | array | 선택적 차트 구성 배열입니다. 이벤트 차트를 활성화할 때 함께 제공하며, 구체적인 결과는 이벤트 처리 체인에서 생성되고 쓰기 응답에서는 반환되지 않습니다. null 허용: False 예시: [{"dql": "M::cpu:(avg(usage_idle)) BY host"}]가져오기 또는 입력 방법: 실제 데이터에서 이벤트 표시에 사용할 쿼리를 검증합니다. |
|
| jsonScript.eventCharts[*] | object | dql 하위 필드만 선언합니다. 예시: {"dql": "M::cpu:(avg(usage_idle)) BY host"}가져오기 또는 입력 방법: 이미 검증된 단일 차트 쿼리입니다. |
|
| jsonScript.eventCharts[*].dql | string | 선택적 쿼리 텍스트이며 차트 UUID가 아닙니다. 저장 시 차트 쿼리를 실행하지 않습니다. null 허용: False 예시: M::cpu:(avg(usage_idle)) BY host가져오기 또는 입력 방법: 지원되는 데이터 소스에서 실제 지표/필드에 따라 DQL을 작성합니다. |
|
| jsonScript.every | string | 일반 공통 플러그인은 every 또는 customCrontab이 필요합니다. 최대 24h이며 최소 20s를 권장합니다. 유효한 양의 정수 형식을 사용해야 하며 0/음수 또는 d/w를 사용할 수 없습니다. 일부 형식 문제는 500을 반환할 수 있습니다. V2는 10m로 고정되며 서버가 every를 덮어씁니다. AI 시맨틱은 자체 검사 빈도에 따릅니다. null 허용: False 예시: 1m가져오기 또는 입력 방법: 비즈니스 검사 빈도에 따라 양의 정수+s/m/h를 선택합니다. 예: 1m, 5m, 1h. |
|
| jsonScript.groupBy | array | 선택적 차원 이름 배열이며 일반적으로 []는 추가 차원으로 그룹화하지 않음을 의미합니다. 태그 값이 아닙니다. 조합 모니터링 멤버 차원은 호환되어야 합니다. null 허용: False 예시: ["host"]가져오기 또는 입력 방법: 실제 DQL이 반환하는 그룹화 필드에서 선택하며 BY 차원과 일치시킵니다. |
|
| jsonScript.interval | integer | 일반적으로 targets가 있을 때 1..2592000초(30일)가 필요합니다. every 검사 빈도와 다릅니다. 조합 모니터링은 이 공통 검사를 건너뛰며, V2는 YAML query.interval/lookback을 사용합니다. null 허용: False 예시: 300가져오기 또는 입력 방법: 검사에 필요한 시간 범위에 따라 양의 정수 초를 선택하고 실제 데이터 입도와 조정합니다. |
|
| jsonScript.isChangeEvent | boolean | OuterEventChecker 선택 사항이며 기본값 false이고 다른 유형에서는 사용하지 않습니다. null 허용: False 예시: false가져오기 또는 입력 방법: 외부 이벤트가 변경 이벤트이면 true로 설정합니다. |
|
| jsonScript.message | string | event 내용은 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.noDataAction | string | 선택 사항: none/checkAs0/noDataEvent/noDataEventRepeat/fatalEvent/criticalEvent/errorEvent/warningEvent/okEvent/noData/recover. noDataEventRepeat는 적용 가능한 유형에서만 지원되며 양의 정수 noDataInterval이 필요합니다. 생략/빈 호환 값과 양의 지속 시간에는 별도의 레거시 처리가 있으며, 기본 구현에 의존하여 반복 알림을 보장하지 않습니다. null 허용: False 선택 가능한 값: ['none', 'checkAs0', 'noDataEvent', 'noDataEventRepeat', 'fatalEvent', 'criticalEvent', 'errorEvent', 'warningEvent', 'okEvent', 'noData', 'recover'] 예시: noDataEvent가져오기 또는 입력 방법: 데이터 없음의 비즈니스 의미에 따라 이 매개변수의 열거 값에서 선택합니다. |
|
| jsonScript.noDataInterval | integer | 유형에 따라 선택적으로 입력합니다. 데이터 없음 지속 시간(초)입니다. 일반 빈도에서는 정수 검사 주기로 올림 환산되고, 사용자 지정 빈도에서는 초를 직접 사용합니다. repeat 데이터 없음은 반드시 양의 정수여야 합니다. 수정 시 적용 가능한 설정을 완전히 유지하고 단위를 혼용하지 않아야 합니다. null 허용: False 예시: 600가져오기 또는 입력 방법: 비즈니스에서 창/오프셋/지속 시간을 결정하고, 먼저 해당 유형 상세와 실제 이벤트로 확인합니다. |
|
| jsonScript.noDataMessage | string | 데이터 없음 이벤트 정보 템플릿을 출력합니다. 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.noDataNotificationMessage | string | 데이터 단절 이벤트 알림 내용은 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.noDataRecoverMessage | string | 데이터 없음 복구 업로드 이벤트 정보 템플릿을 출력합니다. 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.noDataRecoverTitle | string | 데이터 없음 복구 업로드 이벤트 제목 템플릿을 출력합니다. 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.noDataTitle | string | 데이터 없음 이벤트 제목 템플릿을 출력합니다. 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.notificationMessage | string | 이벤트 알림 내용은 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.openNoDataNotificationMessage | boolean | 선택 사항이며 기본값 false입니다. 닫혀 있으면 해당 이벤트 내용을 사용합니다. 열 때 해당 notificationMessage/noDataNotificationMessage도 함께 제공해야 합니다. null 허용: False 예시: false가져오기 또는 입력 방법: 알림 전용 내용을 별도로 사용해야 하면 true로 설정합니다. |
|
| jsonScript.openNotificationMessage | boolean | 선택 사항이며 기본값 false입니다. 닫혀 있으면 해당 이벤트 내용을 사용합니다. 열 때 해당 notificationMessage/noDataNotificationMessage도 함께 제공해야 합니다. null 허용: False 예시: false가져오기 또는 입력 방법: 알림 전용 내용을 별도로 사용해야 하면 true로 설정합니다. |
|
| jsonScript.periodBefore | integer | 유형에 따라 선택적으로 입력합니다. 고급 변동의 비교 오프셋(초)입니다. 예: 어제 86400. range/range_2와 함께 전체를 작성합니다. 수정 시 적용 가능한 설정을 완전히 유지하고 단위를 혼용하지 않아야 합니다. null 허용: False 예시: 86400가져오기 또는 입력 방법: 비즈니스에서 창/오프셋/지속 시간을 결정하고, 먼저 해당 유형 상세와 실제 이벤트로 확인합니다. |
|
| jsonScript.range | integer | 유형에 따라 선택적으로 입력합니다. 고급 변동의 현재 비교 창이며 양의 정수 초입니다. 수정 시 적용 가능한 설정을 완전히 유지하고 단위를 혼용하지 않아야 합니다. null 허용: False 예시: 3600가져오기 또는 입력 방법: 비즈니스에서 창/오프셋/지속 시간을 결정하고, 먼저 해당 유형 상세와 실제 이벤트로 확인합니다. |
|
| jsonScript.range_2 | integer | 유형에 따라 선택적으로 입력합니다. 고급 변동 비교 창 설정입니다. -1은 전기 대비, 0은 periodBefore 사용, 그 외는 해당 고급 검사 정의의 초 창을 따릅니다. 수정 시 적용 가능한 설정을 완전히 유지하고 단위를 혼용하지 않아야 합니다. null 허용: False 예시: -1가져오기 또는 입력 방법: 비즈니스에서 창/오프셋/지속 시간을 결정하고, 먼저 해당 유형 상세와 실제 이벤트로 확인합니다. |
|
| jsonScript.recoverMessage | string | 복구 이벤트 정보 템플릿을 출력합니다. 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.recoverNeedPeriodCount | integer | 유형에 따라 선택적으로 입력합니다. 일반 빈도에서는 연속 복구 주기 수이고, customCrontab에서는 초 단위 복구 지속 시간을 직접 사용하며 생략 시 0입니다. 수정 시 적용 가능한 설정을 완전히 유지하고 단위를 혼용하지 않아야 합니다. null 허용: False 예시: 1가져오기 또는 입력 방법: 비즈니스에서 창/오프셋/지속 시간을 결정하고, 먼저 해당 유형 상세와 실제 이벤트로 확인합니다. |
|
| jsonScript.recoverTitle | string | 복구 이벤트 제목 템플릿을 출력합니다. 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 유지로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공통 구성은 title/message와 데이터 없음 텍스트를 주요 출처로 사용하며, 기존 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하지만 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 主机 {{host}} 检测结果 {{Result}}가져오기 또는 입력 방법: 실제 검사 차원과 결과 변수에 따라 이벤트/알림 템플릿을 작성하며, 동일 유형에서 이미 검증된 이벤트를 재사용할 수 있습니다. |
|
| jsonScript.subUri | string | OuterEventChecker 신규 생성 시 필수이며 비어 있지 않은 문자열입니다. 공개 수신 URL은 단일 경로 세그먼트이므로 /를 포함할 수 없고(%2F로 인코딩해도 404 발생), 영숫자와 하이픈을 권장합니다. 여러 규칙이 같은 접미사를 사용할 수 있으며 secret이 고유성을 담당합니다. 일반 검사에서는 입력하지 않습니다. null 허용: False 예시: datakit-push가져오기 또는 입력 방법: 현재 외부 이벤트 통합에 사용할 Webhook 접미사를 선택합니다. |
|
| jsonScript.targetWorkspaceUUID | string | 선택 사항이며 기본값은 현재 워크스페이스입니다. simpleCheck, seniorMutationsCheck, seniorRangeCheck, seniorRangeV2Check, outlierCheck의 크로스 워크스페이스 쿼리 소비에 적용됩니다. 쓰기 시 후보 index_list만 생성하고 호출 ID의 데이터 도메인 권한을 검증하므로, 저장 성공이 출처 권한의 완전한 재검토 또는 데이터 조회 가능성을 의미하지 않습니다. 호출 전에 실제 대상 권한을 확인해야 합니다. V2에서는 금지되며 권한이 부여된 워크스페이스 내 YAML 쿼리를 사용합니다. 빈 문자열 허용: False null 허용: False 예시: wksp_source_example가져오기 또는 입력 방법: 유효한 크로스 워크스페이스 권한 부여에서 단일 출처 워크스페이스를 가져옵니다. |
|
| jsonScript.targets | array | 일반 쿼리 대상 배열이며 DQL/PromQL 실제 실행 문은 dql에 둡니다. 일반 공통 플러그인의 alias는 Result 또는 빈 값만 허용하고 별칭 고유성을 검사하며, 단일 대상 Result를 권장합니다. 조합 모니터링은 monitorCheckerId/alias로 멤버를 연결합니다. V2에서는 targets가 금지되며 모두 YAML에 둡니다. null 허용: False 예시: [{"dql": "M::cpu:(avg(usage_idle)) BY host", "alias": "Result", "qtype": "dql"}]가져오기 또는 입력 방법: 먼저 대상 워크스페이스의 동일 데이터 소스에서 쿼리를 검증하고, 필드/인덱스가 실제로 존재해야 합니다. |
|
| jsonScript.title | string | 조건부 필수 | 필수 문자열이며 비어 있지 않은 값을 권장합니다. 최대 256자이며 ASCII/반각 가타카나는 1, 기타 문자는 2로 계산합니다. 비어 있지 않은 값은 규칙 name으로 복사되고 중복 이름 검사에 참여합니다. 일반/자체 호스팅 점검은 중복 이름 그룹을 공유하고 지능형/AI는 각자 그룹을 사용합니다. 템플릿 런타임에 변수가 존재하는지는 실제 이벤트로 검수해야 합니다. 빈 문자열 허용: True null 허용: False 최대 길이: 256 예시: 生产CPU阈值가져오기 또는 입력 방법: 비즈니스에서 규칙/이상 이벤트 제목을 정의하며 검사 결과 템플릿 변수를 사용할 수 있습니다. |
| jsonScript.type | string | 조건부 필수 | 필수 플러그인 식별자입니다. mutationsCheck/rangeCheck/seniorCheck 및 기존 smart* 같은 레거시 호환도 원래 구성에 따라 유지해야 하며 엔터티 type으로 대체하지 않습니다. 구체적인 필드는 해당 유형에만 적용되며 혼합할 수 없습니다. V2와 이전 버전은 상호 전환할 수 없습니다. null 허용: False 예시: simpleCheck가져오기 또는 입력 방법: 검사 방법에 따라 선택합니다. 일반 simpleCheck 임계값, apmCheck/rumCheck/processCheck/cloudDialCheck/networkCheck/objectCheck; 고급 seniorMutationsCheck/seniorRangeCheck/seniorRangeV2Check/outlierCheck; combinedCheck 조합, OuterEventChecker 외부 이벤트, programmableCheck 프로그래밍 가능; 지능형 V2 smartMonitorV2Check, AI 시맨틱 aiMonitor(엔터티 type과 이름은 같지만 필드 계층이 다름). |
| jsonScript.windowDql | string | 선택적 호환 창 쿼리 텍스트이며 이벤트 추가 자료로 그대로 전달됩니다. targets의 실제 검사 쿼리를 대체하지 않으며 생략하면 제공하지 않습니다. null 허용: False 예시: M::cpu:(avg(usage_idle)) BY host가져오기 또는 입력 방법: 이미 검증된 원래 검사 창 표시 쿼리 또는 동일 유형 상세에서 가져옵니다. |
|
| openPermissionSet | boolean | 선택 사항이며 기본값 false입니다. 수정 시 생략하면 false로 복귀합니다. 이 권한은 리소스 작업만 제한하며 API 권한이나 데이터 쿼리 권한을 대체할 수 없습니다. null 허용: False 예시: false가져오기 또는 입력 방법: 지정된 주체에 따라 작업을 제한해야 하면 true로 설정합니다. |
|
| permissionSet | array | 선택 사항이며 기본값 []입니다. 수정 시 생략하면 []로 복귀합니다. 주체는 비Owner 역할, acnt_ 멤버, group_ 팀일 수 있으며 openPermissionSet과 함께 사용합니다. 먼저 유효한 ID를 확인해야 하며, 저장 성공을 각 주체의 실제 액세스 가능성으로 간주하지 않습니다. null 허용: False 예시: ["wsAdmin"]가져오기 또는 입력 방법: 현재 워크스페이스의 역할, 멤버, 팀 관리에서 작업 주체 식별자를 가져옵니다. |
|
| queryType | string | 선택 사항이며 기본값 dql이고 simple/dql만 지원합니다. extend.querylist를 명시하면 우선 사용하고 해당 주입 의미는 무시합니다. simple 파싱 실패 시 dql로 폴백하며 실제 targets 쿼리는 변경하지 않습니다. null 허용: False 예시: dql가져오기 또는 입력 방법: 원래 실행 쿼리는 jsonScript.targets[].dql에 있으며, 이 필드는 클라이언트 편집기 응답 변환만 제어합니다. |
|
| secret | string | 선택 사항이며 외부 이벤트에서 제공하지 않으면 서버가 생성할 수 있습니다. 현재 워크스페이스뿐 아니라 전역(다른 워크스페이스/이력 포함)에서 고유해야 합니다. 수정 시 생략/빈 문자열이면 기존 secret을 유지하고, 비어 있지 않은 값만 교체하며 전역 고유성을 검증합니다. 교체하면 Webhook 주소에 영향을 줍니다. 실제 secret을 로그나 공개 문서에 기록하지 마십시오. null 허용: False 예시: SECRET-PLACEHOLDER가져오기 또는 입력 방법: OuterEventChecker에서만 사용하며 추측할 수 없는 고유한 임의 식별자를 생성합니다. 이후 신뢰할 수 있는 상세에서 Webhook 주소를 보관합니다. |
|
| status | integer | 선택 사항이며 기본값 0입니다. 수정 시 생략하면 활성화로 처리되며 비활성 상태를 유지하지 않습니다. 구성만 변경하려는 비활성 규칙은 status=2를 명시해야 합니다. null 허용: False 선택 가능한 값: [0, 2] 예시: 0가져오기 또는 입력 방법: 0 활성화, 2 비활성화입니다. |
|
| tags | array | 선택적 이름 배열이며 UUID가 아닙니다. 생성 시 생략하거나 []이면 태그가 없고, 수정 시 생략하면 []로 참조를 갱신하여 기존 태그가 지워질 수 있습니다. 태그 범위에 따라 검증하며 monitor 범위와 맞지 않으면 TagScopeMismatch가 발생할 수 있습니다. null 허용: False 예시: ["production"]가져오기 또는 입력 방법: 태그 목록에서 monitor 범위에 적용되는 태그 이름을 가져오고, 새 이름이 필요하면 태그 관리 규칙에 따라 생성합니다. |
|
| tags[*] | string | 단일 이름 문자열이며 UUID가 아닙니다. null 허용: False 예시: production가져오기 또는 입력 방법: 태그 목록에서 monitor/all 범위에 적용되는 단일 비즈니스 태그 이름을 가져옵니다. |
|
| type | string | 생성 시 선택 사항이며 기본값 trigger입니다. jsonScript.type으로 이 엔터티 유형을 대체하지 않습니다. 지능형 V2는 smartMonitor가 필요하며, 기존 지능형은 여전히 OpenAPI 쓰기 호환성을 유지합니다. 수정 시 type을 선언하지 않으면 원래 범주를 따르며 지능형 실행 버전을 임의로 전환할 수 없습니다. null 허용: False 예시: trigger가져오기 또는 입력 방법: 일반 규칙은 trigger, 기존/신규 지능형 모니터링은 smartMonitor, AI 시맨틱 모니터링은 aiMonitor를 선택합니다. |
매개변수 추가 설명¶
V2 yamlConfig 내부 필드(전체 YAML 문자열로 제출):
| YAML 필드 | 유형 | 값, 출처 및 생략 규칙 |
|---|---|---|
version |
integer |
필수이며 1로 고정됩니다. |
name |
string |
필수이며 비어 있지 않고 trim 후 ≤128자입니다. 생성 시 정의한 후 수정할 수 없습니다. |
event.title / event.message |
string |
모두 필수이며 비어 있지 않고 ≤8000자입니다. Scene. 공개 변수만 허용하며 Jinja 제어 블록/주석은 지원하지 않습니다. |
rules |
array |
필수 1..10개이며 최소 하나는 enabled=true여야 합니다. |
rules[].id |
string |
필수이며 고유하고 정규식 [a-z][a-z0-9_]{2,63}입니다. |
rules[].name |
string |
필수이며 비어 있지 않고 trim 후 ≤128자입니다. |
rules[].enabled |
boolean |
선택 사항이며 기본값 true입니다. 현재 수정에서는 구조 활성화/비활성화를 변경할 수 없습니다. |
rules[].query.dql |
string |
필수이며 실제 권한 부여 가능한 DQL이고 UTF8 전체가 여전히 256KiB 총 제한을 받습니다. 수정할 수 있습니다. |
rules[].query.interval |
string |
선택적 양의 정수+s/m/h/d이며 ≤24h입니다. seasonal 기본값은 5m이고 나머지는 기본 1m입니다. |
rules[].query.lookback |
string |
선택 사항이며 auto(기본값) 또는 양의 정수+s/m/h/d입니다. 예산을 초과할 수 없습니다. |
rules[].scene_by |
array<string> |
필수이며 비어 있지 않고 공백 제거 후 고유한 실제 차원 필드입니다. |
rules[].detect |
object |
threshold와 algorithm 중 하나를 선택하며 동시에 가질 수 없고, threshold 분기에는 params가 없습니다. |
rules[].detect.threshold.operator |
string |
필수이며 >, >=, <, <=, ==, !=, between, outside입니다. |
rules[].detect.threshold.operands |
array<number> |
유한 숫자 1개를 비교하며 between/outside는 정확히 2개이고 하한 ≤ 상한입니다. |
rules[].detect.threshold.consecutive |
integer |
선택 사항이며 기본값 1, 1..60입니다. |
rules[].detect.algorithm |
string |
basic.robust_band@1, seasonal.robust_mad@2, seasonal.adaptive_mad@1, peer.robust_mad@1이며 seasonal.robust_mad@1은 기존 구성 호환에만 사용합니다. |
rules[].detect.params |
object 또는 null |
알고리즘별 허용 키를 따르며 알 수 없는 키는 허용하지 않습니다. basic 및 seasonal@2/adaptive는 null을 허용하고 {}로 검증합니다. |
rules[].detect.params.band |
string |
basic 선택 사항이며 mad/quantile입니다. |
rules[].detect.params.direction |
string |
해당 알고리즘이 지원할 때 high/low/both입니다. |
rules[].detect.params.score |
number |
해당 알고리즘 선택 사항이며 유한 숫자 1..20입니다. |
rules[].detect.params.period |
integer 또는 null |
seasonal@2/adaptive 선택 사항이며 null 또는 2..10000입니다. 생략/빈 값이면 1일 샘플 포인트로 추정합니다. 기존 @1은 필수 2..10080입니다. |
rules[].detect.params.consecutive |
integer |
기존 seasonal@1에서만 사용 가능하며 1..60, 기본값 1입니다. |
rules[].detect.params.min_cycles |
integer |
기존 seasonal@1 전용이며 기본값 3, 2..12입니다. |
rules[].detect.params.peer_by |
array<string> |
peer 필수이며 비어 있을 수 있지만 각 항목은 공백 제거 후 고유해야 하고 scene_by의 부분 집합이어야 합니다. |
rules[].no_data |
object 또는 null |
선택 사항이며 기본값 ignore/1입니다. 허용 키는 action, consecutive입니다. |
rules[].no_data.action |
string |
ignore/anomaly, 기본값 ignore입니다. |
rules[].no_data.consecutive |
integer |
기본값 1, 1..60입니다. |
rules[].display.signal |
string |
필수이며 비어 있지 않고 trim 후 ≤128자입니다. |
rules[].display.unit |
string 또는 null |
선택 사항이며 ≤64자입니다. 단위 표시는 원본 쿼리 값을 수정하지 않습니다. |
Scene 변수는 dimension_text, dimension_subject, matched_rule_count, matched_rules_markdown, primary_condition, primary_rule_name, primary_signal, primary_value, problem_message, problem_summary, problem_title뿐입니다. 샘플링 이력 예산은 동시에 ≤10000포인트 및 ≤60일이어야 하며, basic은 일 단위 샘플링으로 최대 61일입니다. 알고리즘 이력/증거/연속 트리거 요구 사항은 모두 예산에 합산됩니다. 명시적 lookback으로 우회할 수 없습니다. 수정 시 DQL, 기존 threshold 구성 및 algorithm.params만 허용되며 다른 실행 구조/규칙 메타 정보는 원래 값을 유지합니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/checker/add' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"queryType":"dql","status":0,"extend":{},"alertPolicyUUIDs":[],"tags":[],"jsonScript":{"type":"simpleCheck","title":"生产CPU阈值","every":"1m","interval":300,"groupBy":["host"],"targets":[{"dql":"M::cpu:(avg(usage_idle)) BY host","alias":"Result","qtype":"dql"}],"checkerOpt":{"rules":[{"status":"warning","conditionLogic":"and","conditions":[{"alias":"Result","operator":"<","operands":[10]}]}]}},"openPermissionSet":false,"permissionSet":[],"type":"trigger"}'
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.id | integer | 현재 레코드 번호이며, 이력 분기에서는 이력 레코드 번호입니다. |
| content.uuid | string | 현재 rul_ UUID입니다. ruleHistory=1로 이력 레코드가 있을 때는 ruleh_ 이력 UUID이며, 이후 수정에도 요청의 현재 UUID를 계속 사용합니다. |
| content.ruleUUID | string | 이력 분기 전용이며 소속 현재 모니터 UUID입니다. |
| content.workspaceUUID | string | 객체가 속한 워크스페이스입니다. |
| content.monitorUUID | string | 연결된 모니터 그룹 UUID입니다. |
| content.type | string | 엔터티 범주이며 일반적으로 trigger/smartMonitor/aiMonitor이고 jsonScript.type의 검사 알고리즘과 다릅니다. |
| content.refKey | string | 호환 비즈니스 연결 키이며 일반적으로 빈 문자열입니다. |
| content.secret | string 또는 null | 외부 이벤트 Webhook 식별자 등 공유 필드이며 일반 API Key로 취급하지 않습니다. 민감한 실제 값을 로그에 기록하지 마십시오. |
| content.jsonScript | object | 저장된 검사 구성이며 jsonScript.type 및 버전에 따라 해석합니다. 읽기는 검사를 실행하지 않습니다. |
| content.crontabInfo | object | 스케줄 구성이며 필드는 단일/다중 워크스페이스 및 알고리즘에 따라 달라지고 {}일 수 있습니다. |
| content.crontabInfo.id | string | 기본 스케줄 구성 ID이며 생략할 수 있습니다. |
| content.crontabInfo.crontab | string 또는 null | 실제 실행 Cron이며 명시적 null 또는 생략(예: Cron 없는 조합 모니터링)일 수 있고 입력 every와 다릅니다. |
| content.crontabInfo.smartRelId | string | 일부 지능형 모니터링의 부속 스케줄 ID이며 생략할 수 있습니다. |
| content.crontabInfo.multiWsCrontabInfo | array<object> |
워크스페이스별 스케줄 자료이며 이력에 존재할 수 있고 생략할 수 있습니다. |
| content.crontabInfo.multiWsCrontabInfo[].ws_uuid | string | 대상 워크스페이스 UUID입니다. |
| content.crontabInfo.multiWsCrontabInfo[].id | string | 해당 워크스페이스 스케줄 ID입니다. |
| content.crontabInfo.multiWsCrontabInfo[].crontab | string 또는 null | 해당 워크스페이스의 실제 Cron이며 명시적 null 또는 생략일 수 있습니다. |
| content.extend | object | 추가 응답/인시던트 연결 구성이며 이력 사용자 지정 필드를 포함할 수 있습니다. 전체를 무분별하게 다시 전송하여 수정해서는 안 됩니다. |
| content.extend.自定义字段 | JSON | 이력 또는 유형별 저장 값입니다. 현재 유형 상세 및 생성 API의 공개 구조를 기준으로 합니다. |
| content.createdWay | string | manual/import/template 또는 이력 빈 값입니다. |
| content.isLocked | integer 또는 boolean | 잠금 상태이며 이력 분기에서는 생략될 수 있습니다. |
| content.openPermissionSet | boolean | 사용자 지정 작업 권한 스위치이며 읽기 성공으로 수정 가능함을 추론할 수 없습니다. |
| content.permissionSet | array<string> |
사용자 지정 작업 주체 UUID입니다. |
| content.permissionSet[] | string | 계정/팀/역할 식별자입니다. |
| content.status | integer | 0 활성화, 2 비활성화이며 삭제되지 않은 조회에는 다른 이력 상태가 포함될 수 있습니다. 최근 실행 결과를 나타내지 않습니다. |
| content.creator | string | 생성 ID입니다. |
| content.updator | string | 수정 ID입니다. |
| content.createAt | integer | 생성 Unix 초입니다. |
| content.updateAt | integer | 수정 Unix 초이며 수정되지 않았으면 -1입니다. |
| content.deleteAt | integer | 삭제 Unix 초이며 삭제되지 않았으면 -1입니다. |
| content.configVersion | integer | V2 현재 구성 버전附加 필드이며 일반 규칙에서는 생략할 수 있습니다. |
| content.jsonScript.targetWorkspaceUUID | string | 대상 워크스페이스, 크로스 워크스페이스 쿼리, 임계값 검사 유형만 지원(2025-08-13 반복에서 추가). 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.type | string | 검사 방법 유형입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.windowDql | string | window dql입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.title | string | 생성되는 event의 제목입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.message | string | event 내용입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.recoverTitle | string | 복구 이벤트 제목 템플릿을 출력합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.recoverMessage | string | 복구 이벤트 정보 템플릿을 출력합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.noDataTitle | string | 데이터 없음 이벤트 제목 템플릿을 출력합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.noDataMessage | string | 데이터 없음 이벤트 정보 템플릿을 출력합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.openNotificationMessage | boolean | 활성화 여부, 이벤트 알림 내용, 기본값 비활성화(이벤트 내용을 알림 내용으로 사용)입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.notificationMessage | string | 이벤트 알림 내용입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.openNoDataNotificationMessage | boolean | 활성화 여부, 데이터 단절 이벤트 알림 내용, 기본값 비활성화(데이터 단절 이벤트 내용을 알림 내용으로 사용)입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.noDataNotificationMessage | string | 데이터 단절 이벤트 알림 내용입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.noDataRecoverTitle | string | 데이터 없음 복구 업로드 이벤트 제목 템플릿을 출력합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.noDataRecoverMessage | string | 데이터 없음 복구 업로드 이벤트 정보 템플릿을 출력합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.every | string | 검사 빈도입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.customCrontab | string | 사용자 지정 검사 빈도입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.delaySeconds | integer | 일반 모니터 데이터 대기 창, 단위 초, 0은 대기하지 않음을 의미합니다. 지능형 모니터링은 이 구성을 지원하지 않습니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.interval | integer | 쿼리 구간, 즉 한 번의 쿼리 시간 범위 차이입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.range | integer | 고급 검사, 변동 검사의 range 매개변수, 단위 s입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.range_2 | integer | 고급 검사, 변동 검사의 range_2 매개변수, 단위 s, 특수 설명(-1은 전기 대비, 0은 periodBefore 필드 사용)입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.periodBefore | integer | 고급 검사, 변동 검사의 (어제/1시간 전) 매개변수, 단위 s입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.recoverNeedPeriodCount | integer | 지정된 이상이 몇 개 검사 주기 후에 복구 이벤트를 생성할지 지정합니다. 검사 빈도가 사용자 지정 customCrontab이면 이 필드는 시간 길이(단위 s)를 나타내고, 그렇지 않으면 몇 개 검사 빈도인지를 나타냅니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.noDataInterval | integer | 얼마 동안 데이터가 없으면 데이터 없음 이벤트를 생성하는지 나타냅니다. noDataEventRepeat일 때는 반드시 양의 정수 초여야 합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.noDataAction | string | 데이터 없음 처리 작업입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkFuncs | array | 검사 함수 정보 목록입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.groupBy | array | 트리거 차원입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.targets | array | 검사 대상입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt | json | 검사 조건 설정입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.enableStreamingAggregation | boolean 또는 null | 모니터 스트리밍 집계 가속입니다. 생략 또는 null이면 워크스페이스를 따르고, true는 독립 활성화, false는 독립 비활성화입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.yamlConfig | string | V2 전체 원본 YAML 텍스트, 최대 256KiB입니다. JSON 객체가 아니고 Markdown 펜스가 없습니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.disableLargeScaleEventProtect | boolean | 대규모 이벤트 보호 비활성화 여부, 기본값 false입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.script | string | 프로그래밍 가능 모니터의 스크립트 내용입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.rules | array | 트리거 조건 목록입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.openOkConditions | boolean | 등급별 복구 활성화, 기본값 비활성화 false입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.openMatchTimes | boolean | 연속 트리거 판단 활성화, 기본값 비활성화 false입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.infoEvent | boolean | 지속적으로 정상일 때 info 이벤트를 생성할지 여부, 기본값 false입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.infoEventCondition | json | 정보 이벤트 생성 조건입니다. 일반 규칙 검사의 임계값, 로그, 애플리케이션/사용자 액세스 지표, 가용성, 프로세스, 네트워크, 변동, 구간 및 레거시 유형 호환을 지원합니다. 이상치, 조합, 생존 V2, 변경, 프로그래밍 가능, 지능형 및 SLO는 지원하지 않습니다. 빈 객체는 무조건 생성을 의미합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.infoEventCondition.alias | string | 판단 대상 별칭입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.infoEventCondition.operator | string | 판단 연산자입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.infoEventCondition.operands | array | 판단 피연산자 목록입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.diffMode | string | 고급 검사 중 변동 검사의 차이 모드, 열거 값 value, percent입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.direction | string | 고급 검사 중 변동 검사, 구간 검사의 트리거 조건 방향입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.eps | float | 거리 매개변수, 값 범위: 0 ~ 3.0입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.threshold | json | 변동 검사의 트리거 전제 조건 설정입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.threshold.status | boolean | 변동 검사, 트리거 전제 조건 활성화 여부입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.threshold.operator | string | 변동 검사, 트리거 전제 조건 연산자입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.threshold.value | float 또는 null | 변동 검사, 트리거 전제 조건 검사 값입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.combineExpr | string | 조합 모니터링, 조합 방식입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.ignoreNodata | boolean | 조합 모니터링, 데이터 없음 결과 무시 여부(true는 무시 필요)입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.confidenceInterval | integer | 구간 검사 V2 신규 매개변수, 신뢰 구간 범위 1-100입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.category | string | AI 모니터링 범주 메타데이터입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.userPrompt | string | AI 사용자 프롬프트; 전달 시 비어 있을 수 없고 최대 20000자입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.systemPrompt | string | AI 시스템 프롬프트; 전달 시 비어 있을 수 없고 최대 20000자입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.mentions | array | DQL 참조 목록; 각 항목은 type=dql, namespace, datasource를 포함해야 하고 index는 선택 사항이며 로그 선택 시 입력합니다. 직렬화 후 최대 20000자입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.mentions[] | object | 배열의 단일 객체이며 하위 필드에 따라 해석합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.mentions[].type | string | 데이터 소스 유형입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.mentions[].namespace | string | DQL 네임스페이스입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.mentions[].index | string | DQL 인덱스; 로그 선택 시 입력합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.mentions[].datasource | string | DQL 데이터 소스입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.model | string | 이번 검사에 사용하는 모델입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.contextWindowLimit | integer | 컨텍스트 창 Token 제한, 0보다 커야 합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.maxChatRounds | integer | 최대 대화 라운드, 1 이상이어야 합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.maxDQLQueries | integer | 최대 DQL 쿼리 횟수, 0 이상이어야 합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.checkerOpt.creditSoftBudget | number | 단일 검사 Credit 소프트 예산, 0보다 커야 합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.channels | array | 채널 UUID 목록입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.atAccounts | array | 정상 검사 시 @된 계정 UUID 목록입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.atNoDataAccounts | array | 데이터 없음 상황에서 @된 계정 UUID 목록입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.subUri | string | OuterEventChecker의 Webhook 주소 접미사; 생성 시 필수이며 고유할 필요는 없습니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.isChangeEvent | boolean | OuterEventChecker를 변경 이벤트로 처리할지 여부, 기본값 false; 기존 규칙에 없으면 false로 처리합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.disableCheckEndTime | boolean | 종료 시간 제한 비활성화 여부입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.eventChartEnable | boolean | 이벤트 차트 활성화 여부, 기본값 비활성화(주 저장소 엔진 logging이 doris일 때만 적용됩니다). 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.eventCharts | array | 이벤트 차트 목록입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.eventCharts[] | object | 배열의 단일 객체이며 하위 필드에 따라 해석합니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.eventCharts[].dql | string | 이벤트 차트의 쿼리 문입니다. 저장된 구성이며 실제 적용 여부는 검사 유형과 결합해 확인해야 합니다. 쓰기는 모니터 생성을 참조하십시오. |
| content.jsonScript.targets[] | object | 단일 DQL/PromQL 쿼리 대상 또는 조합 모니터링 멤버입니다. |
| content.jsonScript.targets[].dql | string | 실제 실행 쿼리이며 qtype이 구문을 결정합니다. |
| content.jsonScript.targets[].qtype | string | 일반적으로 dql/promql이며 이력에서는 queryType으로 표현될 수 있습니다. |
| content.jsonScript.targets[].queryType | string | 이력 쿼리 구문 표시입니다. |
| content.jsonScript.targets[].alias | string | 일반 공통 플러그인은 보통 Result를 요구하며, 조합 모니터링은 멤버 별칭을 따릅니다. |
| content.jsonScript.targets[].monitorCheckerId | string | 조합 모니터링에서만 멤버 UUID를 연결합니다. |
| content.jsonScript.targets[].groupBy | array<string> |
조합 멤버 추가 트리거 차원입니다. |
| content.jsonScript.targets[].groupBy[] | string | 필드 이름입니다. |
| content.jsonScript.targetWorkspaceUUIDs | array<string> |
이력/기타 진입점에서 저장한 대상 워크스페이스 UUID 집합일 수 있습니다. 공개 생성/수정에서는 선언되지 않았으며 전체를 다시 전송하지 않습니다. |
| content.jsonScript.targetWorkspaceUUIDs[] | string | 단일 대상 워크스페이스 UUID입니다. |
| content.jsonScript.targets[].extraOptions | object | get 응답에 저장된 값을 표시합니다. 목록의 크로스 워크스페이스 권한 확인에 파싱 결과가 있으면 원위치에서 보강될 수 있고, 결과가 없어도 이력 값이 유지될 수 있습니다. 클라이언트가 쓸 수 있는 요청 또는 현재의 전체 권한 증명으로 사용하지 않습니다. |
| content.jsonScript.targets[].extraOptions.workspace_uuids | array<string> |
저장되었거나 목록에서 이번에 파싱된 후보 실행 워크스페이스이며 이력 값을 포함할 수 있고, 현재 모두 권한이 부여되었다고 보장하지 않습니다. |
| content.jsonScript.targets[].extraOptions.workspace_uuids[] | string | 저장 또는 후보 워크스페이스 UUID 단일 값이며 현재 권한을 확인해야 합니다. |
| content.jsonScript.targets[].extraOptions.index_list | array<object> |
저장되었거나 목록에서 이번에 파싱된 데이터 도메인/인덱스 후보 범위이며 이력 값일 수 있고, 현재의 전체 권한 보장으로 사용할 수 없습니다. |
| content.jsonScript.targets[].extraOptions.index_list[].workspace_uuid | string | 출처 워크스페이스 UUID입니다. |
| content.jsonScript.targets[].extraOptions.index_list[].namespace | string | 쿼리 네임스페이스입니다. |
| content.jsonScript.targets[].extraOptions.index_list[].index_name | string | 허용된 인덱스 이름이며 로그가 아닌 경우 default일 수 있습니다. |
| content.jsonScript.targets[].extraOptions.index_list[].expr_name | string | 표현식 하위 쿼리 이름이며 생략할 수 있습니다. |
| content.jsonScript.targets[].conditions | object 또는 string | 쿼리 추가 필터이며 저장 구조에 따라 읽고 유형이 통일되었다고 가정하지 않습니다. |
| content.jsonScript.groupBy[] | string | 트리거 차원 필드입니다. |
| content.jsonScript.checkFuncs[] | object | 호환 검사 함수 자료입니다. |
| content.jsonScript.checkFuncs[].funcId | string | 함수 ID입니다. |
| content.jsonScript.checkFuncs[].kwargs | object | 함수별 매개변수이며 모든 알고리즘의 공통 입력이 아닙니다. |
| content.jsonScript.checkFuncs[].kwargs.参数名 | JSON | 해당 함수 문서에 따라 해석합니다. |
| content.jsonScript.channels[] | string | 인시던트 채널 UUID입니다. |
| content.jsonScript.atAccounts[] | string | 알림에서 @된 ID 식별자이며 이력에서는 이메일일 수 있습니다. |
| content.jsonScript.atNoDataAccounts[] | string | 데이터 없음 알림 @ 대상입니다. |
| content.jsonScript.checkerOpt.rules[] | object | 등급별 트리거 및 복구 조건을 설정합니다. |
| content.jsonScript.checkerOpt.rules[].status | string | fatal/critical/error/warning/info/ok/ALL 등이며 검사 유형에 따라 해석합니다. |
| content.jsonScript.checkerOpt.rules[].conditionLogic | string | and/or, 다중 조건 조합입니다. |
| content.jsonScript.checkerOpt.rules[].matchTimes | integer | 연속 매칭 횟수이며 openMatchTimes와 함께 사용해야 합니다. |
| content.jsonScript.checkerOpt.rules[].conditions | array<object> |
트리거 조건입니다. |
| content.jsonScript.checkerOpt.rules[].okConditions | array<object> |
등급별 복구 조건이며 생략할 수 있습니다. |
| content.jsonScript.checkerOpt.rules[].conditions[].alias | string | 대응하는 쿼리 대상 별칭입니다. |
| content.jsonScript.checkerOpt.rules[].conditions[].operator | string | 조건 연산자이며 검사 유형별 지원 집합을 따릅니다. |
| content.jsonScript.checkerOpt.rules[].conditions[].operands | array | 비교 값 배열이며 숫자/문자열 유형을 유지합니다. |
| content.jsonScript.checkerOpt.rules[].conditions[].operands[] | string / number | 단일 비교 값입니다. |
| content.jsonScript.checkerOpt.rules[].okConditions[].alias | string | 대응하는 쿼리 대상 별칭입니다. |
| content.jsonScript.checkerOpt.rules[].okConditions[].operator | string | 조건 연산자이며 검사 유형별 지원 집합을 따릅니다. |
| content.jsonScript.checkerOpt.rules[].okConditions[].operands | array | 비교 값 배열이며 숫자/문자열 유형을 유지합니다. |
| content.jsonScript.checkerOpt.rules[].okConditions[].operands[] | string / number | 단일 비교 값입니다. |
| content.extend.isNeedCreateIssue | boolean | 이상에 따라 Issue를 생성할지 여부입니다. |
| content.extend.issueLevelUUID | string | 이력 Issue 등급 식별자이며 이미 유효하지 않을 수 있습니다. |
| content.extend.issueDfStatus | array<string> |
Issue를 트리거하는 이상 상태입니다. |
| content.extend.issueDfStatus[] | string | fatal/critical/error/warning/nodata. |
| content.extend.manager | array<string> |
이미 해석된 담당자 대상입니다. |
| content.extend.manager[] | string | 멤버/팀 등 대상 식별자입니다. |
| content.extend.incidentsTags | array<string> |
인시던트 연결 태그 이름입니다. |
| content.extend.incidentsTags[] | string | 단일 태그 이름입니다. |
| content.extend.faultMappingMode | string | custom/existing, 현재 인시던트 등급 매핑 방식입니다. |
| content.extend.levelMappingUUID | string | existing일 때의 등급 매핑 UUID입니다. |
| content.extend.bindIncidentsInfo | array<object> |
사용자 지정 등급 매핑 행입니다. |
| content.extend.bindIncidentsInfo[].incidentsLevelUUID | string | 매핑된 Issue 등급 UUID입니다. |
| content.extend.bindIncidentsInfo[].incidentsDfStatus | array<string> |
매핑된 이상 상태 배열입니다. |
| content.extend.bindIncidentsInfo[].incidentsDfStatus[] | string | 단일 이상 상태입니다. |
| content.extend.smartMonitor | object | V2 출처 및 현재 버전 메타 정보입니다. |
| content.extend.smartMonitor.source | string | ai/builtin 출처입니다. |
| content.extend.smartMonitor.engineVersion | integer | V2는 일반적으로 2입니다. |
| content.extend.smartMonitor.configVersion | integer | V2 구성 버전입니다. |
| content.extend.smartMonitor.category | string | 지능형 모니터링 분류입니다. |
| content.extend.smartMonitor.prompt | string | AI 생성 프롬프트입니다. |
| content.extend.smartMonitor.templateId | string | 내장 템플릿 식별자입니다. |
| content.extend.smartMonitor.templateVersion | string | 내장 템플릿 버전입니다. |
| content.extend.smartMonitor.generationRunId | string | 생성 과정 추적 식별자이며 생략할 수 있습니다. |
| content.tagInfo | array<object> |
쓰기 후 태그 연결 요약이며 태그가 없으면 []입니다. |
| content.tagInfo[].id | string | 태그 UUID이며 uuid와 같고 데이터베이스 숫자 id가 아닙니다. |
| content.tagInfo[].uuid | string | 태그 UUID입니다. |
| content.tagInfo[].name | string | 태그 이름입니다. |
| content.tagInfo[].scope | array<string> |
정규화된 태그 범위입니다. |
| content.tagInfo[].scope[] | string | 단일 범위입니다. |
| content.monitorName | string | 현재 그룹 표시 이름이며 조건부로 반환됩니다. |
| content.dashboardUUID | string | 생성/수정 시 명시적이고 유효한 연결이 있을 때 반환되며 생략될 수 있습니다. |
| content.alertPolicyUUIDs | array<string> |
생성 시 비어 있지 않은 연결이 있을 때만 반환되는 정책 UUID이며 수정 응답에서는 자동으로 확장되지 않습니다. |
| content.alertPolicyUUIDs[] | string | 정책 UUID입니다. |
| content.__operation_info | object | 정상 생성 시 추가 작업 요약입니다. |
| content.__operation_info.uuid | string | 이번 규칙 UUID입니다. |
| content.declaration | object | 공통 선언입니다. |
{
"code": 200,
"content": {
"id": null,
"uuid": "rul_checker_example",
"workspaceUUID": "wksp_example",
"monitorUUID": "monitor_example",
"type": "trigger",
"refKey": "",
"secret": "",
"jsonScript": {
"type": "simpleCheck",
"title": "生产CPU阈值",
"name": "生产CPU阈值",
"every": "1m",
"interval": 300,
"groupBy": [
"host"
],
"targets": [
{
"dql": "M::cpu:(avg(usage_idle)) BY host",
"alias": "Result",
"qtype": "dql"
}
],
"checkerOpt": {
"rules": [
{
"status": "warning",
"conditionLogic": "and",
"conditions": [
{
"alias": "Result",
"operator": "<",
"operands": [
10
]
}
]
}
]
}
},
"extend": {},
"crontabInfo": {
"id": "cron_example",
"crontab": "0 * * * * *"
},
"createdWay": "manual",
"isLocked": 0,
"openPermissionSet": false,
"permissionSet": [],
"status": 0,
"creator": "wsak_example",
"updator": "",
"createAt": 1785427200,
"updateAt": -1,
"deleteAt": -1,
"monitorName": null,
"tagInfo": [],
"__operation_info": {
"uuid": "rul_checker_example"
},
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방식 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드 누락 또는 필드 값이 선언된 검증 조건 위반 | 매개변수 파싱 실패 | 매개변수 위치, 필드 이름, 유형 및 값을 확인합니다. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문이 유효하지 않음 | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정합니다. |
| 406 | ft.InvalidParameterValidation | noDataAction=noDataEventRepeat이지만 noDataInterval 누락/양의 정수 아님 | {}의 값이 유효하지 않습니다. 현재 값: {} |
지원되는 검사 유형에 양의 정수 초 지속 창을 명확히 제공합니다. |
| 400 | ft.ErrorContinuousTriggerCfgCount | openMatchTimes=true이고 matchTimes 중 하나라도 1..100 범위를 벗어남 | 연속 트리거 구성 횟수는 {}여야 합니다 | 연속 횟수를 1..100으로 조정하고, 비활성화 시 이 필드를 사용하지 않습니다. |
| 406 | ft.IllegalMutationParameters | 고급 변동 전제 threshold.status=true이지만 value가 숫자가 아님(null 포함) | 트리거 조건 검사 값 검증 실패 | 결과 단위와 일치하는 숫자를 제공하거나 전제 조건을 끕니다. |
| 403 | ft.ForbiddenQuery | 검사 DQL을 파싱할 때 호출 ID에 해당 네임스페이스 쿼리 권한이 없음 | {} 권한이 없습니다 | 현재 API Key/ID에 필요한 데이터 도메인 쿼리 권한을 구성합니다. 모니터 구성 권한만으로는 충분하지 않습니다. |
| 406 | ft.DqlParseError | 대상 쿼리, eval 하위 표현식 또는 V2 YAML 내 DQL이 권한/인덱스 파싱 시 실패함 | dql parser 파싱 실패: {} | 실제 쿼리 구문과 네임스페이스를 수정한 후 재시도합니다. 이는 쿼리가 실행되었음을 의미하지 않습니다. |
| 400 | ft.JsonFormatError | JSON Body 최상위가 객체가 아님(예: 배열/문자열) | 일부 json 파일 형식 오류 | 예시에 따라 JSON 객체를 제출하며 checkers 또는 event 배열을 직접 제출할 수 없습니다. |
| 400 | ft.repeatCheckerSecret | 외부 이벤트 secret이 다른 워크스페이스/이력을 포함한 모든 규칙에서 이미 사용 중임 | 외부 이벤트 모니터 secret이 이미 존재합니다 | 전역 고유한 임의 secret을 사용하고, 수정 시 먼저 자체 원래 secret을 확인합니다. |
| 406 | ft.ParameterCheckFailed | 워크스페이스에서 왼쪽 와일드카드가 허용되지 않고 사전 DQL 분석에서 고비용 쿼리가 발견되었거나 분석이 성공하지 못함 | 쿼리 구성에서 퍼지 매칭은 현재 왼쪽 * 매칭을 지원하지 않습니다 | content의 쿼리 분석에 따라 DQL을 수정하고 왼쪽 * 스캔을 피하며 먼저 권한 출처를 검증합니다. |
| 400 | ft.ParamsValidateError | queryType, 데이터 대기, AI 프롬프트/참조/예산 필드 등 비즈니스 매개변수가 유효하지 않음 | 매개변수 검증 실패: {} | 구체적인 message 필드 경로에 따라 수정하며 AI 프롬프트에 공백이 없도록 합니다. |
| 406 | ft.InvalidParameter | 이벤트 message/noDataMessage가 문자열이 아니거나 이상 등급 매핑 등 비즈니스 필드가 맞지 않음 | 매개변수 {}가 유효하지 않습니다 |
구체적인 필드 및 유효한 출처를 확인합니다. |
| 406 | ft.InvalidParameterV2 | 검사 대상 이벤트 템플릿의 Jinja 구문이 유효하지 않음 | 매개변수 {}의 값 {}이(가) 유효하지 않습니다 |
content.field/line/reason에 따라 수정합니다. 알 수 없는 템플릿 변수가 반드시 유효하다는 의미는 아닙니다. |
| 400 | ft.CheckerRepeatNames | 같은 워크스페이스의 해당 범주 그룹에 삭제되지 않은 동일 이름 규칙이 이미 존재함 | 모니터 이름 중복 | 이름을 변경하거나 기존 UUID를 수정합니다. 일반 모니터링과 자체 호스팅 점검은 이름 그룹을 공유합니다. |
| 400 | ft.InvalidAlertPolicyUUID | 요청 알림 정책 집합에 이 워크스페이스에서 일치하지 않는 비삭제 UUID가 있음 | 유효하지 않은 알림 정책 UUID | 정책 목록에서 전체 유효 UUID를 다시 가져옵니다. |
| 400 | ft.UnsupportExternalEmail | 무료/무료 플랜 버전의 @ 대상에 외부 이메일이 포함됨 | 무료 플랜 워크스페이스에서는 알림 대상으로 외부 이메일을 지원하지 않습니다 | 이 워크스페이스의 유효한 ID로 변경하거나 버전 지원 여부를 확인합니다. |
| 400 | ft.TagScopeMismatch | 바인딩 태그가 monitor 범위에 적용되지 않음 | 태그 범위 불일치 | 태그 목록에서 all/monitor를 선택하거나 확인 후 태그 범위를 수정합니다. |
| 406 | ft.UnsupportRuleType | 검사 플러그인 유형이 지원되지 않음 | 지원되지 않는 규칙 유형: {} |
이 페이지에서 지원하는 유형과 해당 구조를 사용합니다. |
| 406 | ft.UnsupportCheckUnit | 검사 빈도 every 단위가 지원되지 않음 | 검사 빈도 단위가 잘못되었습니다. 지원되는 단위 목록: {} |
양의 정수+s/m/h를 사용합니다. |
| 406 | ft.CheckFrequencyExceedsMaximum | 일반 검사 빈도가 24h를 초과함 | 검사 빈도가 최대값을 초과했습니다 | 빈도를 줄입니다. V2는 고정 10m을 사용합니다. |
| 406 | ft.MissingCheckFreqFixedCrontab | 일반 검사에 every/customCrontab이 없음 | 검사 빈도가 지정되지 않았거나 fixedCrontab이 지정되지 않았습니다 | 유효한 빈도 하나를 명확히 제공합니다. |
| 400 | ft.CrontabCheckError | 사용자 지정 Cron 구문 또는 초 필드가 유효하지 않음 | crontab 검증 실패 | 전체 5/6 필드 표현식을 수정합니다. |
| 400 | ft.CrontabCheckRangeError | 초 단위 스텝 사용자 지정 Cron이 20초 미만임 | 시간은 {}초 이상이어야 합니다 | 최소 20초 스텝 또는 적절한 분 빈도를 사용합니다. |
| 406 | ft.InvalidInterval | 일반적으로 targets가 있을 때 interval이 정수가 아니거나 1..2592000초 범위를 벗어남 | interval이 유효하지 않습니다 | 초 단위로 유효한 창을 제공합니다. |
| 406 | ft.CheckObjectTargetAliasError | 일반 플러그인 대상의 비어 있지 않은 alias가 Result가 아님 | 검사 대상 DQL의 별칭 오류 | Result를 사용하고, 조합 멤버는 조합 프로토콜에 따라 별도로 처리합니다. |
| 406 | ft.CheckObjectNameRepeat | 대상 별칭 중복 | 검사 대상 별칭이 중복됩니다 | 각 대상에 적용 가능하고 고유한 별칭을 사용합니다. |
| 400 | ft.UnsupportTriggerFields | 해당 유형이 Info 이벤트 조건 등 트리거 필드를 지원하지 않음 | 지원되지 않는 트리거 필드: {} | 적용되지 않는 필드를 삭제하고 지원되는 유형에만 구성합니다. |
| 400 | ft.ErrorCombinedCheckers | 조합 멤버에 호환되지 않는 사용자 지정 Cron이 포함됨 | 사용자 지정 빈도의 모니터가 있습니다. 조합 모니터링 모니터는 사용자 지정 빈도를 지원하지 않습니다 | 먼저 멤버 빈도를 조정하거나 조합을 분리합니다. |
| 400 | ft.ErrorCombinedCrontab | 조합에서 참조되는 규칙이 다시 호환되지 않는 사용자 지정 Cron으로 변경됨 | 연결된 조합 모니터링이 있습니다. 조합 모니터링의 모니터는 사용자 지정 빈도를 지원하지 않습니다 | 조합 참조를 확인한 후 호환되는 빈도를 선택합니다. |
| 400 | ft.ErrorFieldCheck | 조합에 combineExpr 등 조건부 필수 필드가 누락됨 | {} 필드 검증 실패 | 조합 표현식과 멤버 정의를 보완합니다. |
| 400 | ft.InvalidIssueDfStatus | Issue 매핑에 허용되지 않는 이상 상태가 포함됨 | 유효하지 않은 이벤트 등급 {} | fatal/critical/error/warning/nodata만 사용합니다. |
| 400 | ft.FiledCreateTrigger | 신규 스케줄이 유효한 id를 반환하지 않음 | 트리거 구성 생성 실패, 다시 시도하십시오 | 규칙/스케줄이 이미 존재하는지 먼저 확인하고 traceId를 보관하여 조사합니다. |
| 400 | ft.OuterFuncFailed | 스케줄 서비스가 비즈니스 실패를 반환함 | 외부 함수 호출 실패 | 구성과 기존 스케줄을 확인한 후 재시도합니다. |
| 400 | ft.SameSetTraggerExists | 스케줄 서비스가 동일한 스케줄이 이미 존재한다고 판단함 | 동일한 구성의 트리거가 이미 존재합니다 | 이미 생성된 규칙을 확인하고 중복 생성하지 않습니다. |
| 500 | ft.InternalServerError | 고급 조건 일반 예외, 잘못된 필드 형태, 다운스트림 연결/타임아웃/잘못된 JSON 등 포착되지 않은 예외, 데이터베이스 또는 제출 후 캐시/작업 디스패치 실패 | 내부 오류 | 먼저 규칙과 상태/연결을 다시 읽으십시오. 일부가 이미 제출되었을 수 있습니다. traceId를 보관하고 실패 단계에 따라 처리합니다. |
| 400 | ft.ErrorRecoveryConditionOperator | 등급별 복구 트리거 조건이 지원되는 >/>=/</<= 단측 비교가 아님 |
복구 조건 연산자는 >,<,>=,'<='만 지원합니다 |
트리거와 복구의 반대 방향 및 유효한 숫자 경계에 따라 okConditions를 수정합니다. |
| 406 | ft.ErrorLessThanOrEqualOperator | 트리거가 >일 때 복구가 ≤를 충족하지 않거나 경계가 유효하지 않음 | 복구 조건 값은 트리거 조건 값보다 작거나 같아야 합니다 | 트리거와 복구의 반대 방향 및 유효한 숫자 경계에 따라 okConditions를 수정합니다. |
| 406 | ft.ErrorGreaterThanOrEqualOperator | 트리거가 <일 때 복구가 ≥를 충족하지 않거나 경계가 유효하지 않음 | 복구 조건 값은 트리거 조건 값보다 크거나 같아야 합니다 | 트리거와 복구의 반대 방향 및 유효한 숫자 경계에 따라 okConditions를 수정합니다. |
| 406 | ft.ErrorLessThanOperator | 트리거가 ≥일 때 복구가 <를 충족하지 않거나 경계가 유효하지 않음 | 복구 조건 값은 트리거 조건 값보다 작아야 합니다 | 트리거와 복구의 반대 방향 및 유효한 숫자 경계에 따라 okConditions를 수정합니다. |
| 406 | ft.ErrorGreaterThanOperator | 트리거가 ≤일 때 복구가 >를 충족하지 않거나 경계가 유효하지 않음 | 복구 조건 값은 트리거 조건 값보다 커야 합니다 | 트리거와 복구의 반대 방향 및 유효한 숫자 경계에 따라 okConditions를 수정합니다. |
| 404 | ft.NotFoundView | 생성 시 지정한 dashboardUUID가 이 워크스페이스에 없거나 유효하지 않음 | 지정된 뷰를 찾을 수 없습니다 | 현재 워크스페이스의 대시보드 목록에서 유효한 UUID를 가져옵니다. |
| 403 | ft.ForbiddenFreeEditionWorkspace | 현재 워크스페이스 버전이 해당 검사 유형/구성을 지원하지 않음 | 무료 플랜 워크스페이스에서는 이 기능을 지원하지 않습니다. 상용 플랜을 개통하여 제한을 해제할 수 있습니다 | 워크스페이스 버전의 지원 여부를 확인합니다. |
| 403 | ft.ForbiddenFreeEditionLimit | 현재 버전의 리소스 수가 제한을 초과함 | 무료 플랜 워크스페이스 {}이(가) 상한({}개)에 도달하여 새로 만들 수 없습니다. 상용 플랜을 개통하여 제한을 해제할 수 있습니다 | 모니터 할당량 및 기존 비삭제 레코드를 확인합니다. |