콘텐츠로 이동

생성



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 현재 버전의 리소스 수가 제한을 초과함 무료 플랜 워크스페이스 {}이(가) 상한({}개)에 도달하여 새로 만들 수 없습니다. 상용 플랜을 개통하여 제한을 해제할 수 있습니다 모니터 할당량 및 기존 비삭제 레코드를 확인합니다.

문서 평가

이 페이지가 도움이 되었나요?