내보내기¶
POST /api/v1/checker/export
개요¶
모니터와 해당 모니터의 직접 구성 멤버를 마이그레이션 가능한 템플릿 JSON으로 내보냅니다.
호출 전 및 사용 단계¶
통합 JSON content.checkers 배열을 반환하며, 압축 파일/파일 다운로드 또는 비동기 작업이 아닙니다. 현재 워크스페이스에서 삭제되지 않은 일치 객체만 읽으며, 모두 일치하지 않아도 성공적으로 빈 배열을 반환할 수 있습니다. 빈 입력도 성공적으로 빈 배열을 반환합니다. 공유 쿼리는 Rule 카테고리로 한정하지 않고 모니터 목록 UUID만 사용합니다. 복합 모니터를 내보내면 직접 참조된 멤버가 추가로 포함되며 signId로 복합 참조를 재작성합니다. 임의의 여러 계층 의존성을 재귀적으로 보완하는 것은 보장하지 않습니다.
내보내기는 이름을 기준으로 그룹/알림 정책/대시보드 및 태그를 연결합니다. 해당 리소스의 전체 구성이나 사용자 지정 작업 권한은 내보내지 않으며, 모든 이력을 보존하지도 않습니다. OuterEventChecker는 secret을 제거하며, 가져온 후 새 Webhook가 생성됩니다. isNeedCreateIssue가 활성화되지 않은 경우 템플릿은 채널/레벨/담당자/태그 등 Issue 관련 필드를 비우고, 일부 이전 데이터 없음 주기 프로토콜을 변환합니다. 마이그레이션 전에 원본 상세를 백업하고 대상 데이터 소스, 권한 및 알림 대상을 확인하세요.
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명. 예시: <DF-API-KEY>조회 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 조회합니다. |
Body 요청 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| checkers[*] | string | 다른 Rule 리소스 유형을 혼합하지 않으며, 메서드 자체에서 type을 추가로 제한하지 않습니다. 예시: rul_checker_example조회 또는 입력 방법: 현재 워크스페이스의 단일 모니터 UUID입니다. |
|
| checkers | array | Y | 필수 UUID 배열이며, 빈 배열이면 성공 시 content.checkers=[]입니다. 삭제되지 않은 일치 항목만 내보냅니다. null 허용: False 예시: ["rul_checker_example"]조회 또는 입력 방법: 모니터 목록에서 엔터티 type별로 현재 워크스페이스 UUID를 항목별로 선택합니다. |
파라미터 추가 설명¶
관련 인터페이스: 하나 이상의 모니터 가져오기
모니터 가져오기 인터페이스의 checkers 파라미터는 모니터 내보내기 성공 응답의 content.checkers 내용입니다.
OuterEventChecker 내보내기는 subUri/isChangeEvent를 유지하며, 재사용 가능한 secret은 내보내지 않습니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/checker/export' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"checkers":["rul_checker_example"]}'
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.checkers | array<object> |
내보낸 템플릿 배열입니다. |
| content.checkers[].type | string | trigger/smartMonitor/aiMonitor이며, 이번 import의 최상위 type과 일치해야 실제로 가져옵니다. replace는 기존 객체의 정규화된 카테고리와 일치해야 합니다. |
| content.checkers[].signId | string | 원본 UUID의 다이제스트로 내보내며 인증 자격 증명이 아닙니다. 가져오기 시 UUID 사전 할당 및 복합 멤버 참조 재작성에 사용되며, 동일 배치 내에서 고유해야 하고 파일 간에 임의로 재사용해서는 안 됩니다. replace는 이를 통해 대상 UUID를 변경하지 않습니다. |
| content.checkers[].jsonScript | json | 전체 정의입니다. 의미 및 선택 필드는 이 페이지에서 설명한 것과 같습니다. 가져오기는 일반 add Body가 아니며, 전체 중첩 선언 검증을 거치지 않으므로 잘못된 형태는 500을 반환할 수 있습니다. V2의 전체 yamlConfig는 유효해야 하며, 가져오기 전에 모든 후보를 동기적으로 검증할 수 있습니다. |
| content.checkers[].extend | json | 누락/이전 템플릿은 {}를 권장하며 null을 제공하지 않습니다. 가져오기는 전체 정의에 따라 저장합니다. replace에서 누락 시 {}가 기존 확장을 덮어쓰며, 보존하지 않습니다. 각 중첩 의미는 아래 표를 참조하세요. |
| content.checkers[].is_disable | boolean | 선택 사항이며 기본값은 활성화입니다. 템플릿 프로토콜의 밑줄 표기 is_disable을 유지하며 isDisable이 아닙니다. replace에서 생략하면 기존 비활성 규칙이 활성화됩니다. |
| content.checkers[].tagInfo | array | 선택 사항이며 기본값은 []입니다. name 기준으로 태그를 생성하거나 재사용하며, 최상위 tags는 템플릿 가져오기에서 동일한 역할을 하지 않습니다. replace에서 생략하면 기존 태그 연결이 지워집니다. |
| content.checkers[].tagInfo[] | json | name만 필요하며, 원본 태그 UUID를 대상 워크스페이스 식별자로 사용하지 않습니다. |
| content.checkers[].tagInfo[].name | string | 내보낸 태그 이름이며, 마이그레이션 전에 대상 워크스페이스에서 범위를 확인하세요. |
| content.checkers[].secret | string | 가져오기는 원본 secret을 상속하지 않습니다. OuterEventChecker 내보내기에서는 이 필드가 제거되며, 가져오면 새 secret이 생성되므로 마이그레이션 후 Webhook를 다시 조회해야 합니다. replace에서 생략하거나 빈 문자열이면 원래 secret을 유지하며, 비어 있지 않은 값으로 교체할 때는 전역 고유해야 합니다. |
| content.checkers[].monitorName | string | 선택 사항이며 기본값은 default이고, 빈 값도 default로 처리합니다. 존재하지 않으면 새 그룹을 생성할 수 있습니다. monitorUUID가 아닙니다. replace에서 생략하면 default로 전환되며 기존 그룹을 유지하지 않습니다. |
| content.checkers[].alertPolicyNames | array | 선택 사항이며 기본값은 []입니다. 존재하지 않는 이름은 정책 정의를 생성하며, 알림 대상/규칙이 원본 정책과 함께 마이그레이션된다고 가정할 수 없습니다. replace에서 생략하면 기존 정책 참조가 지워집니다. |
| content.checkers[].alertPolicyNames[] | string | UUID가 아닙니다. 가져온 후 실제 알림 대상 구성을 확인하세요. |
| content.checkers[].dashboardName | string | 선택 사항이며, name으로 기존 node 대시보드만 조회하고 대시보드를 자동으로 가져오지 않습니다. 일치하지 않으면 연결을 만들지 않습니다. replace에서 생략하거나 일치하지 않으면 기존 대시보드 참조가 제거됩니다. |
| content.checkers[].jsonScript.atAccounts | array | 선택적 배열이며 기본값은 []입니다. channels는 인시던트 연결에 사용되며 직접 알림 대상이 아닙니다. 서버에서 기본 채널을 보완하거나 유효하지 않은 채널을 필터링할 수 있습니다. @외부 이메일은 무료/체험 버전에서 제한됩니다. 저장은 알림 발송을 의미하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.atNoDataAccounts | array | 선택적 배열이며 기본값은 []입니다. channels는 인시던트 연결에 사용되며 직접 알림 대상이 아닙니다. 서버에서 기본 채널을 보완하거나 유효하지 않은 채널을 필터링할 수 있습니다. @외부 이메일은 무료/체험 버전에서 제한됩니다. 저장은 알림 발송을 의미하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.channels | array | 선택적 배열이며 기본값은 []입니다. channels는 인시던트 연결에 사용되며 직접 알림 대상이 아닙니다. 서버에서 기본 채널을 보완하거나 유효하지 않은 채널을 필터링할 수 있습니다. @외부 이메일은 무료/체험 버전에서 제한됩니다. 저장은 알림 발송을 의미하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkFuncs | array | 선택 사항이며 일반 임계값에는 제공할 필요가 없습니다. seniorCheck는 첫 번째 항목의 funcId/kwargs에 따라 사용하며, 모든 함수를 범용 파라미터로 취급하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt | json | 일반 규칙은 주로 rules를 사용합니다. 고급 유형은 해당 알고리즘에 맞게 작성하며, V2는 yamlConfig를, AI 시맨틱은 userPrompt 등을 사용합니다. 선언되지 않은 하위 필드는 공개 검증에서 거부되며, 내부 SDK 파라미터 전체를 복사할 수 없습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.category | string | AI 시맨틱 전용입니다. AI 시맨틱 분류 메타 정보이며 선택적 문자열입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.combineExpr | string | 유형 전용 파라미터입니다. 복합 멤버 alias 표현식이며, 복합 유형에서는 필수이고 비어 있으면 안 됩니다. Result로 멤버 별칭을 대체하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.confidenceInterval | integer | 유형 전용 파라미터입니다. 구간 V2 신뢰 구간 1..100이며 실제 알고리즘 구성에 따릅니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.contextWindowLimit | integer | AI 시맨틱 전용입니다. 양의 정수 Token 컨텍스트 제한이며 ≥1입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.creditSoftBudget | number | AI 시맨틱 전용입니다. 단일 Credit 소프트 예산이며 유한 숫자 >0입니다. 인터페이스 실행 타임아웃이 아닙니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.diffMode | string | 유형 전용 파라미터입니다. 고급 급변 value 차이/percent 백분율이며 명시적으로 제공해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.direction | string | 유형 전용 파라미터입니다. 고급 급변/구간 up/down/both이며 명시적으로 제공해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.disableLargeScaleEventProtect | boolean | 선택적 불리언입니다. true이면 대규모 이벤트 보호를 비활성화하고, 기본값 false이면 보호를 유지합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.enableStreamingAggregation | boolean 또는 null | 선택적 3상태 값입니다. 지원되는 유형의 스트리밍 집계 가속만 제어하며, 모니터 시작/중지와 같지 않고 DQL 의미를 변경하지도 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.eps | float | 유형 전용 파라미터입니다. 이상치 검사에 필수이며 값 범위는 0..3.0입니다. 이 알고리즘은 일반 rules 조건 검증을 사용하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.ignoreNodata | boolean | 선택적 불리언입니다. 복합 모니터에서만 true이면 데이터 없음을 무시하며 기본값은 false입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.infoEvent | boolean | 선택적 불리언입니다. true이면 지속적으로 정상일 때 info를 생성하며 기본값은 false입니다. infoEventCondition은 유형에 따라 조건을 제어합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.infoEventCondition | json | 선택 사항이며 {}는 무조건 Info를 의미합니다. 일반 임계값/로그/애플리케이션 및 액세스 메트릭/가용성/프로세스/네트워크/급변/구간 등 지원 유형에만 적용됩니다. 이상치/복합/라이브니스 V2/변경/프로그래밍 가능/지능형/SLO는 지원하지 않으며, 전달하면 UnsupportTriggerFields가 발생합니다. 비어 있지 않으면 alias/operator/operands가 완전하고 유효해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.infoEventCondition.alias | string | 비어 있지 않은 Info 조건 내에서 구조에 맞게 작성하며, targets 별칭에 대응합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.infoEventCondition.operands | array | 비어 있지 않은 Info 조건 내에서 구조에 맞게 작성하며, 비교 값 배열입니다. 요소는 문자열/숫자이고 객체를 전달하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.infoEventCondition.operator | string | 비어 있지 않은 Info 조건 내에서 구조에 맞게 작성하며, 이 페이지의 일반 조건 연산자 중에서 선택합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.maxChatRounds | integer | AI 시맨틱 전용입니다. 최대 대화 라운드 수이며 정수 ≥1입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.maxDQLQueries | integer | AI 시맨틱 전용입니다. 최대 DQL 호출 횟수이며 정수 ≥0입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.mentions | array | AI 시맨틱 선택 사항이며 기본값은 []입니다. 각 항목은 type=dql, 비어 있지 않은 namespace/datasource가 필요하고 index는 선택 사항이며 전달 시 비어 있지 않아야 합니다. 정규화된 JSON 직렬화 총 길이는 ≤20000자입니다. 데이터 쿼리 권한을 대체하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.mentions[] | object | type/namespace/datasource는 필수이고 index는 선택 사항입니다. 네 개 필드만 선언합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.mentions[].datasource | string | 참조 항목 내 실제 데이터 소스 이름입니다(예: 로그 source/메저먼트). 네임스페이스에 따라 해석됩니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.mentions[].index | string | 참조 항목 내 로그 참조에 실제 인덱스 이름/식별자를 입력하며, 다른 유형에서는 생략할 수 있습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.mentions[].namespace | string | 참조 항목 내 실제 DQL 네임스페이스이며 엔터티 type이 아닙니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.mentions[].type | string | 참조 항목 내 고정 값 dql입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.model | string | AI 시맨틱 전용입니다. AI 시맨틱 선택적 모델 이름이며, 사이트에서 지원하는 모델 구성에서 가져와야 하고 문서 예시의 리터럴 값을 사용할 수 없습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.openMatchTimes | boolean | 선택적 불리언입니다. true이면 연속 트리거 일치를 활성화하고 기본값은 false입니다. rules[].matchTimes와 함께 사용합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.openOkConditions | boolean | 선택적 불리언입니다. true이면 단계별 복구를 활성화하고 기본값은 false입니다. okConditions는 트리거 및 복구 경계를 충족해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.rules | array | 일반 규칙 조건 배열입니다. 각 항목에는 status/conditionLogic/conditions가 있으며 복구에는 okConditions를 사용합니다. 잘못된 멤버/연산 형태는 일반 예외를 발생시켜 최종적으로 500이 될 수 있으며, 일괄적으로 406은 아닙니다. operands가 빈 조건은 스케줄 생성 전에 필터링되므로 이를 '전체'를 표현하는 데 사용하지 마세요. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.script | string | 유형 전용 파라미터입니다. 프로그래밍 가능 검사 스크립트 텍스트이며 해당 유형이 지원하는 구문을 사용합니다. 이 인터페이스는 스크립트 테스트를 한 번 실행하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.systemPrompt | string | AI 시맨틱 전용입니다. AI 시맨틱 선택 사항이며 전달 시 비어 있지 않아야 하고 Python 문자 수 ≤20000입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.threshold | json | 선택적 객체이며 제공 시 status/operator/value 모두 필수로 선언됩니다. status=false이면 전제 조건 판단을 끄고, value는 null을 허용하지만 알고리즘의 실제 의미에 맞게 작성해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.threshold.operator | string | 상위 객체가 존재할 때 필수입니다. 전제 비교 연산자(예: >)이며 실제 고급 검사 호환 집합에 따릅니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.threshold.status | boolean | 상위 객체가 존재할 때 필수입니다. 전제 조건 활성화 여부입니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.threshold.value | float 또는 null | 상위 객체가 존재할 때 필수입니다. 전제 수치이며 status=false이면 null을 허용하고, status=true이면 반드시 숫자여야 하며 그렇지 않으면 IllegalMutationParameters가 발생합니다. 단위는 쿼리 결과와 일치해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.userPrompt | string | AI 시맨틱 전용입니다. AI 시맨틱 조건에 필수이며 비어 있으면 안 되고 Python 문자 수 ≤20000입니다. 빈 문자열을 선언할 수 있지만 비즈니스에서는 공백을 허용하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.checkerOpt.yamlConfig | string | V2에만 필수이며, 비어 있지 않은 UTF8 YAML 텍스트 ≤256KiB입니다. JSON 객체나 Markdown 펜스가 아닙니다. 구조는 이 페이지의 YAML 표를 참조하세요. 앵커/별칭/명시적 tag/중복 키는 금지됩니다. 수정은 기존 DQL, threshold 구성 및 알고리즘 params만 허용하며 규칙 집합/이름/실행 구조는 변경할 수 없습니다. 저장 시 프로토콜/예산을 검증하고 검사 쿼리 데이터 영역 권한을 파싱하며, DQL을 실행하거나 데이터 존재/소스 권한이 완전히 검토되었음을 보장하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.customCrontab | string | 선택 사항이며 비어 있지 않으면 every보다 우선합니다. 5개 필드 또는 초를 포함한 6개 필드를 지원하며, 초 단위 스텝 형식은 20보다 작을 수 없습니다. 복합 모니터 및 복합 멤버에는 사용자 지정 주기 충돌 제한이 있으며 V2에서는 금지됩니다. 검사 시간대는 현재 워크스페이스/서비스 구성에 따르며, 문자열의 시간대 이름으로 필드를 대체하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.delaySeconds | integer | 선택적 일반 모니터 데이터 대기 창이며 단위는 초이고 0이면 대기하지 않으며 기본값은 0입니다. 불리언은 정수로 사용하지 않습니다. 지능형/AI는 일반 대기 구성을 사용하지 않으며 이를 통해 지능형 실행 지연을 조정할 수 없습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.disableCheckEndTime | boolean | 선택적 호환 불리언이며 기본값은 false이고 실제 지원 여부는 검사 유형에 따릅니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.eventChartEnable | boolean | 선택 사항이며 기본값은 false입니다. 지원되는 Doris 로그 주 저장소에서만 처리됩니다. 저장 성공이 차트 생성 완료를 의미하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.eventCharts | array | 선택적 차트 구성 배열이며, 이벤트 차트를 활성화할 때 함께 제공합니다. 구체적인 결과는 이벤트 처리 체인에서 생성되며 쓰기 응답에는 반환되지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.eventCharts[] | object | 선언에는 dql 하위 필드만 있습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.eventCharts[].dql | string | 선택적 쿼리 텍스트이며 차트 UUID가 아닙니다. 저장해도 차트 쿼리를 실행하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.every | string | 일반 공용 플러그인은 every 또는 customCrontab이 필요합니다. 최대 24h이며 최소 20s를 권장합니다. 유효한 양의 정수 형식을 사용해야 하며 0/음수 또는 d/w를 사용할 수 없습니다. 일부 형식 문제는 500을 발생시킬 수 있습니다. V2는 10m로 고정되며 서버가 every를 덮어씁니다. AI 시맨틱은 자체 검사 주기를 따릅니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.groupBy | array | 선택적 차원 이름 배열이며, 일반적으로 []는 추가 차원으로 그룹화하지 않음을 의미합니다. 태그 값이 아닙니다. 복합 모니터 멤버 차원은 호환되어야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.interval | integer | 일반적으로 targets가 있을 때 1..2592000초(30일)가 필요합니다. every 검사 주기와 다릅니다. 복합 모니터는 이 일반 검사를 건너뛰며 V2는 YAML query.interval/lookback을 사용합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.isChangeEvent | boolean | OuterEventChecker에서 선택 사항이며 기본값은 false이고 다른 유형에서는 사용하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.message | string | event 내용이며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.noDataAction | string | 선택 사항: none/checkAs0/noDataEvent/noDataEventRepeat/fatalEvent/criticalEvent/errorEvent/warningEvent/okEvent/noData/recover. noDataEventRepeat는 적용 가능한 유형에서만 지원되며 양의 정수 noDataInterval이 필요합니다. 생략/빈 호환 값과 양의 지속 시간에는 별도의 이전 처리 방식이 있으며, 기본 구현의 반복 알림에 의존하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.noDataInterval | integer | 유형에 따라 선택적으로 입력합니다. 데이터 없음 지속 시간(초)입니다. 일반 주기는 전체 검사 주기로 올림 환산되고, 사용자 지정 주기는 초를 직접 사용합니다. repeat 데이터 없음은 반드시 양의 정수여야 합니다. 수정 시 적용 가능한 설정을 완전히 보존하고 단위를 혼합하지 않아야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.noDataMessage | string | 데이터 없음 이벤트 정보 템플릿을 출력하며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.noDataNotificationMessage | string | 데이터 단절 이벤트 알림 내용이며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.noDataRecoverMessage | string | 데이터 없음 복구 업로드 이벤트 정보 템플릿을 출력하며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.noDataRecoverTitle | string | 데이터 없음 복구 업로드 이벤트 제목 템플릿을 출력하며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.noDataTitle | string | 데이터 없음 이벤트 제목 템플릿을 출력하며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.notificationMessage | string | 이벤트 알림 내용이며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.openNoDataNotificationMessage | boolean | 선택 사항이며 기본값은 false입니다. 닫으면 해당 이벤트 내용을 사용합니다. 열면 해당 notificationMessage/noDataNotificationMessage도 함께 제공해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.openNotificationMessage | boolean | 선택 사항이며 기본값은 false입니다. 닫으면 해당 이벤트 내용을 사용합니다. 열면 해당 notificationMessage/noDataNotificationMessage도 함께 제공해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.periodBefore | integer | 유형에 따라 선택적으로 입력합니다. 고급 급변의 비교 오프셋(초)이며 예: 어제 86400입니다. range/range_2와 함께 완전히 입력해야 합니다. 수정 시 적용 가능한 설정을 완전히 보존하고 단위를 혼합하지 않아야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.range | integer | 유형에 따라 선택적으로 입력합니다. 고급 급변의 현재 비교 창이며 양의 정수(초)입니다. 수정 시 적용 가능한 설정을 완전히 보존하고 단위를 혼합하지 않아야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.range_2 | integer | 유형에 따라 선택적으로 입력합니다. 고급 급변 비교 창 설정이며, -1은 직전 기간 대비, 0은 periodBefore 기준, 그 외는 해당 고급 검사 정의의 초 단위 창을 사용합니다. 수정 시 적용 가능한 설정을 완전히 보존하고 단위를 혼합하지 않아야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.recoverMessage | string | 복구 이벤트 정보 템플릿을 출력하며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.recoverNeedPeriodCount | integer | 유형에 따라 선택적으로 입력합니다. 일반 주기에서는 연속 복구 주기 수이고, customCrontab에서는 초 단위 복구 시간을 직접 사용하며 생략 시 0입니다. 수정 시 적용 가능한 설정을 완전히 보존하고 단위를 혼합하지 않아야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.recoverTitle | string | 복구 이벤트 제목 템플릿을 출력하며 해당 검사 유형에 따라 선택적으로 입력합니다. 수정 시 생략을 보존으로 간주할 수 없으며 전체 구성을 다시 채워야 합니다. 선택 사항이며 생략하면 독립 텍스트를 제공하지 않습니다. 현재 공용 구성은 title/message와 데이터 없음 텍스트를 주요 소스로 사용하며, 이전 recover 전용 필드가 모든 검사 유형을 개별적으로 커버한다고 보장하지 않습니다. message 및 지원되는 유형의 noDataMessage는 먼저 Jinja 구문 분석을 수행하며, 알 수 없는 변수의 런타임 값은 검증하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.subUri | string | OuterEventChecker에서 새로 추가된 필수 비어 있지 않은 문자열입니다. 공개 수신 URL은 단일 경로 세그먼트이며 /를 포함할 수 없습니다(인코딩된 %2F도 404가 됨). 영문/숫자/하이픈을 권장합니다. 여러 규칙이 동일한 접미사를 사용할 수 있으며 secret이 고유성을 담당합니다. 일반 검사에는 입력하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.targetWorkspaceUUID | string | 선택 사항이며 기본값은 현재 워크스페이스입니다. simpleCheck, seniorMutationsCheck, seniorRangeCheck, seniorRangeV2Check, outlierCheck의 교차 워크스페이스 쿼리 소비에 적용됩니다. 저장 시 후보 index_list만 생성하고 호출 주체의 데이터 영역 권한을 검증하며, 저장 성공이 소스 권한이 완전히 검토되었거나 데이터를 조회할 수 있음을 의미하지 않습니다. 호출 전에 실제 대상 권한을 확인해야 합니다. V2에서는 금지되며 권한이 부여된 워크스페이스의 YAML 쿼리를 사용합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.targets | array | 일반 쿼리 대상 배열이며 DQL/PromQL 실제 실행 문은 dql에 넣습니다. 일반 공용 플러그인 alias는 Result 또는 빈 값만 허용하고 별칭 고유성을 검사하며 단일 대상 Result를 권장합니다. 복합 모니터는 monitorCheckerId/alias로 멤버를 연결합니다. V2에서는 targets가 금지되며 모두 YAML에 넣습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.title | string | 필수 문자열이며 비어 있지 않은 값을 권장합니다. 최대 256은 ASCII/반각 가타카나 1, 기타 문자 2로 계산합니다. 비어 있지 않은 값은 규칙 name으로 복사되고 중복 이름 검사에 참여합니다. 일반/자체 점검은 중복 이름 그룹을 공유하고 지능형/AI는 각각 그룹화됩니다. 템플릿 런타임에 변수가 존재하는지는 실제 이벤트로 검수해야 합니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.type | string | 필수 플러그인 식별자입니다. mutationsCheck/rangeCheck/seniorCheck 및 이전 smart* 등 이전 호환 유형도 원래 구성에 따라 유지해야 하며 엔터티 type으로 대체하지 않습니다. 구체 필드는 해당 유형에만 적용되며 혼합할 수 없습니다. V2와 이전 버전은 상호 전환할 수 없습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.windowDql | string | 선택적 호환 창 쿼리 텍스트이며 이벤트 추가 자료로 전달되고 targets의 실제 검사 쿼리를 대체하지 않습니다. 생략 시 제공하지 않습니다. 이는 저장된 구성이며 실제 적용 여부는 검사 유형에 따라 판단해야 합니다. 기록 방법은 모니터 생성을 참조하세요. |
| content.checkers[].jsonScript.targets[] | object | 단일 DQL/PromQL 쿼리 대상 또는 복합 모니터 멤버입니다. |
| content.checkers[].jsonScript.targets[].dql | string | 실제 실행 쿼리이며 qtype이 구문을 결정합니다. |
| content.checkers[].jsonScript.targets[].qtype | string | 일반적으로 dql/promql이며, 이전에는 queryType으로 표현될 수 있습니다. |
| content.checkers[].jsonScript.targets[].queryType | string | 이전 쿼리 구문 표시입니다. |
| content.checkers[].jsonScript.targets[].alias | string | 일반 공용 플러그인은 보통 Result를 요구하며, 복합 모니터는 멤버 별칭을 따릅니다. |
| content.checkers[].jsonScript.targets[].monitorCheckerId | string | 복합 모니터에서만 멤버 UUID를 연결합니다. |
| content.checkers[].jsonScript.targets[].groupBy | array<string> |
복합 멤버 추가 트리거 차원입니다. |
| content.checkers[].jsonScript.targets[].groupBy[] | string | 필드 이름입니다. |
| content.checkers[].jsonScript.targetWorkspaceUUIDs | array<string> |
템플릿이 지원하는 다중 소스 입력 저장 집합이며, 비어 있지 않으면 단수 필드보다 우선합니다. 실제 생성된 실행 공간은 crontabInfo.multiWsCrontabInfo를 기준으로 하며, 권한 부여 실패로 축소될 수 있습니다. |
| content.checkers[].jsonScript.targetWorkspaceUUIDs[] | string | 단일 대상 워크스페이스 UUID입니다. |
| content.checkers[].jsonScript.targets[].extraOptions | object | 저장 또는 실행 시 구성된 쿼리 옵션입니다. 현재 권한 부여의 완전한 보장이 아니며, 목록 응답을 새로운 쿼리 권한으로 간주하지 않습니다. |
| content.checkers[].jsonScript.targets[].extraOptions.workspace_uuids | array<string> |
저장되었거나 목록에서 이번에 파싱된 후보 실행 공간이며 이전 값이 포함될 수 있습니다. 현재 모두 권한이 부여되었다고 보장하지 않습니다. |
| content.checkers[].jsonScript.targets[].extraOptions.workspace_uuids[] | string | 저장되었거나 후보인 단일 워크스페이스 UUID이며 현재 권한을 확인해야 합니다. |
| content.checkers[].jsonScript.targets[].extraOptions.index_list | array<object> |
저장되었거나 목록에서 이번에 파싱된 데이터 영역/인덱스 후보 범위이며 이전 값일 수 있고 현재의 완전한 권한 보장으로 사용할 수 없습니다. |
| content.checkers[].jsonScript.targets[].extraOptions.index_list[].workspace_uuid | string | 소스 워크스페이스 UUID입니다. |
| content.checkers[].jsonScript.targets[].extraOptions.index_list[].namespace | string | 쿼리 네임스페이스입니다. |
| content.checkers[].jsonScript.targets[].extraOptions.index_list[].index_name | string | 허용된 인덱스 이름이며 로그가 아니면 default일 수 있습니다. |
| content.checkers[].jsonScript.targets[].extraOptions.index_list[].expr_name | string | 표현식 하위 쿼리 이름이며 생략할 수 있습니다. |
| content.checkers[].jsonScript.targets[].conditions | object 또는 string | 쿼리 추가 필터이며 저장 구조에 따라 읽고 유형이 통일되어 있다고 가정하지 않습니다. |
| content.checkers[].jsonScript.groupBy[] | string | 트리거 차원 필드입니다. |
| content.checkers[].jsonScript.checkFuncs[] | object | 호환 검사 함수 자료입니다. |
| content.checkers[].jsonScript.checkFuncs[].funcId | string | 함수 ID입니다. |
| content.checkers[].jsonScript.checkFuncs[].kwargs | object | 함수별 파라미터이며 모든 알고리즘의 공통 입력이 아닙니다. |
| content.checkers[].jsonScript.checkFuncs[].kwargs.파라미터 이름 | JSON | 해당 함수 문서에 따라 해석합니다. |
| content.checkers[].jsonScript.channels[] | string | 인시던트 채널 UUID입니다. |
| content.checkers[].jsonScript.atAccounts[] | string | 알림에서 @된 ID 식별자이며, 이전에는 이메일일 수 있습니다. |
| content.checkers[].jsonScript.atNoDataAccounts[] | string | 데이터 없음 알림 @ 대상입니다. |
| content.checkers[].jsonScript.checkerOpt.rules[] | object | 레벨별로 트리거 및 복구 조건을 설정합니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].status | string | fatal/critical/error/warning/info/ok/ALL 등은 검사 유형에 따라 해석됩니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].conditionLogic | string | and/or, 다중 조건 조합입니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].matchTimes | integer | 연속 일치 횟수이며 openMatchTimes와 함께 사용해야 합니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].conditions | array<object> |
트리거 조건입니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].okConditions | array<object> |
단계별 복구 조건이며 생략할 수 있습니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].conditions[].alias | string | 해당 쿼리 대상 별칭입니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].conditions[].operator | string | 조건 연산자이며 검사 유형별 지원 집합에 따릅니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].conditions[].operands | array | 비교 값 배열이며 숫자/문자열 유형을 유지합니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].conditions[].operands[] | string / number | 단일 비교 값입니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].okConditions[].alias | string | 해당 쿼리 대상 별칭입니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].okConditions[].operator | string | 조건 연산자이며 검사 유형별 지원 집합에 따릅니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].okConditions[].operands | array | 비교 값 배열이며 숫자/문자열 유형을 유지합니다. |
| content.checkers[].jsonScript.checkerOpt.rules[].okConditions[].operands[] | string / number | 단일 비교 값입니다. |
| content.checkers[].jsonScript.name | string | 호환 이름이며, 비어 있지 않은 title이 있으면 복사/덮어쓰고 title이 없으면 가져오기 이름 대체 값으로 사용합니다. |
| content.checkers[].jsonScript.fixedCrontab | string | 유지되는 호환 고정 Cron입니다. 실제 실행은 crontabInfo를 기준으로 하며 every/customCrontab과 충돌하지 않도록 하세요. |
| content.checkers[].extend.isNeedCreateIssue | boolean | 이상에 따라 Issue를 생성할지 여부입니다. |
| content.checkers[].extend.issueLevelUUID | string | 이전 Issue 레벨 식별자이며 유효하지 않을 수 있습니다. |
| content.checkers[].extend.issueDfStatus | array<string> |
Issue를 트리거하는 이상 상태입니다. |
| content.checkers[].extend.issueDfStatus[] | string | fatal/critical/error/warning/nodata. |
| content.checkers[].extend.manager | array<string> |
이미 확인된 담당자 대상입니다. |
| content.checkers[].extend.manager[] | string | 멤버/팀 등 대상 식별자입니다. |
| content.checkers[].extend.incidentsTags | array<string> |
인시던트 관련 태그 이름입니다. |
| content.checkers[].extend.incidentsTags[] | string | 단일 태그 이름입니다. |
| content.checkers[].extend.faultMappingMode | string | custom/existing, 현재 장애 레벨 매핑 방식입니다. |
| content.checkers[].extend.levelMappingUUID | string | existing일 때 레벨 매핑 UUID입니다. |
| content.checkers[].extend.bindIncidentsInfo | array<object> |
사용자 지정 레벨 매핑 행입니다. |
| content.checkers[].extend.bindIncidentsInfo[].incidentsLevelUUID | string | 매핑된 Issue 레벨 UUID입니다. |
| content.checkers[].extend.bindIncidentsInfo[].incidentsDfStatus | array<string> |
매핑된 이상 상태 배열입니다. |
| content.checkers[].extend.bindIncidentsInfo[].incidentsDfStatus[] | string | 단일 이상 상태입니다. |
| content.checkers[].extend.smartMonitor | object | V2 소스 및 현재 버전 메타 정보입니다. |
| content.checkers[].extend.smartMonitor.source | string | ai/builtin 소스입니다. |
| content.checkers[].extend.smartMonitor.engineVersion | integer | V2는 일반적으로 2입니다. |
| content.checkers[].extend.smartMonitor.configVersion | integer | V2 구성 버전입니다. |
| content.checkers[].extend.smartMonitor.category | string | 지능형 모니터링 분류입니다. |
| content.checkers[].extend.smartMonitor.prompt | string | AI 생성 프롬프트입니다. |
| content.checkers[].extend.smartMonitor.templateId | string | 내장 템플릿 식별자입니다. |
| content.checkers[].extend.smartMonitor.templateVersion | string | 내장 템플릿 버전입니다. |
| content.checkers[].extend.smartMonitor.generationRunId | string | 생성 과정 추적 식별자이며 생략할 수 있습니다. |
| content.declaration | object | 공용 선언이며 가져오기는 checkers만 사용합니다. |
{
"code": 200,
"content": {
"checkers": [
{
"type": "trigger",
"signId": "sign_example",
"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
]
}
]
}
]
}
},
"extend": {},
"is_disable": false,
"tagInfo": [
{
"name": "production"
}
],
"secret": "",
"monitorName": "default",
"alertPolicyNames": [
"프로덕션 알림"
]
}
],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공용 요청 오류는 공용 오류 정의를 참조하세요.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드 누락 또는 필드 값이 선언된 검증 조건 위반 | 파라미터 파싱 실패 | 파라미터 위치, 필드 이름, 유형 및 값을 확인하세요. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문이 유효하지 않음 | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정하세요. |
| 400 | ft.JsonFormatError | Body 최상위가 JSON 객체가 아님 | 일부 json 파일 형식 오류 | 예시에 따라 checkers 배열을 포함한 객체를 제출하세요. |
| 500 | ft.InternalServerError | JSON 저장/복합 참조/이전 주기 데이터 또는 관련 자료 읽기 및 포맷팅 실패 | 내부 오류 | 먼저 단일 UUID로 내보내기 범위를 좁히고 원본 구성을 확인하세요. 계속 실패하면 traceId를 제공하세요. |