조회¶
GET /api/v1/checker/{rule_uuid}/get
개요¶
모니터의 전체 설정, 연관 리소스 및 호환 가능한 이력 스냅샷을 조회합니다.
호출 전 준비 및 사용 단계¶
경로에는 해당 type 목록에서 얻은 현재 워크스페이스의 규칙 UUID를 사용해야 합니다. 이 공유 조회 자체는 Rule.type을 제한하지 않으므로 동일한 rul_ 접두사만으로 객체 분류를 추측해서는 안 됩니다. 기본적으로 현재 설정을 조회하며, 호환 Query는 아래 표를 참조하십시오. 기존 ruleHistory에 사용 가능한 이력이 없으면 content={}를 성공적으로 반환하며, 이는 현재 규칙이 존재하지 않는다는 의미가 아닙니다.
이 route는 YAML에 Query 선언이 없지만 실제로 request.args를 그대로 전달하여 ruleHistory/targetWorkspaceUUID/targetRegion을 처리합니다. 여기서는 전체 호출 체인에서 확인된 호환 필드만 나열하며, 이를 근거로 다른 controller 파라미터도 모두 공개 인터페이스에서 사용할 수 있다고 추론해서는 안 됩니다. 워크스페이스 간/사이트 간 조회에는 실제로 유효한 권한이 이미 있어야 합니다. 이 인터페이스는 권한을 생성하지 않으며 원본 규칙을 변경하지 않습니다. 원격에서 권한 만료류 오류로 거부하면 로컬 mirror 권한 만료가 비동기로 표시될 수 있고, 조회로 인해 로컬 권한 상태가 업데이트될 수도 있으므로 원본 권한을 확인한 후 복구해야 합니다. 현재 또는 이력에 저장된 설정을 반환하며, 연관/ID/등급/채널 정보는 현재 리소스 기준으로 보완될 수 있으므로 당시 모든 연관 리소스의 전체 이력 스냅샷은 아닙니다. 조회는 모니터링이나 알림을 실행하지 않습니다. OpenAPI는 Front 전용 df_event_id를 전달하지 않으므로 alreadyFeedback을 반환하지 않습니다. Manage에서 별도로 보완하는 managerInfos도 이 진입점의 고정 필드가 아닙니다.
라우트 파라미터¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| rule_uuid | string | Y | 규칙 UUID이며, 그룹 UUID, 이름, 이력 UUID 또는 숫자 버전이 아닙니다. 예: rul_checker_example조회 또는 입력 방법: 모니터 목록content.data[].uuid에서 조회합니다. |
요청 헤더¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>조회 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 조회합니다. |
Query 요청 파라미터¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| ruleHistory | integer | 선택적 문자열 정수 0/1입니다. 0이 아닌 정수는 이력 분기로 진입하며, 이력 버전 번호가 아닙니다. 이력이 없으면 {}를 성공적으로 반환합니다. 현재 잘못된 정수 형식은 500을 반환합니다. V2의 전체 다중 버전 이력은 지능형 모니터링 이력을 사용하십시오. 예: 0조회 또는 입력 방법: 현재 설정을 조회하려면 0을 사용하거나 생략하고, 마지막 비삭제 이력과 호환하려면 1을 사용합니다. |
|
| targetWorkspaceUUID | string | 선택 사항이며, 생략하면 현재 워크스페이스입니다. 권한이 부여된 소스 워크스페이스의 규칙을 조회해야 할 때 전달하며, rule_uuid는 해당 소스에 속해야 합니다. 이 API Key의 워크스페이스를 변경하는 것이 아니며, 쉼표로 구분된 집합으로 단일 UUID를 대체할 수 없습니다. 예: wksp_source_example조회 또는 입력 방법: 유효한 워크스페이스 간 권한 부여 기록에서 단일 대상 소스 워크스페이스 UUID를 가져옵니다. |
|
| targetRegion | string | 선택 사항이며, targetWorkspaceUUID와 함께만 사용합니다. 생략하면 권한 부여 관계에서 확인합니다. 대상 워크스페이스를 전달하지 않으면 사이트 간 조회가 활성화되지 않습니다. 사이트에 따라 소스 서비스로 전달될 수 있으므로 예시 코드를 실제 사이트로 간주해서는 안 됩니다. 예: example-region조회 또는 입력 방법: 대상 소스 워크스페이스의 실제 사이트 및 유효한 권한 부여 기록에서 확인합니다. |
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/checker/rul_checker_example/get' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
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 | 이력 또는 유형별 저장 값입니다. 현재 유형 상세 및 생성 인터페이스의 공개 구조를 기준으로 합니다. |
| 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 | 생성 주체입니다. |
| content.updator | string | 업데이트 주체입니다. |
| 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 | 생성되는 이벤트의 제목입니다. 이는 저장된 설정이며, 실제 적용 여부는 검사 유형과 함께 확인해야 합니다. 작성은 모니터 생성을 참조하십시오. |
| content.jsonScript.message | string | 이벤트 내용입니다. 이는 저장된 설정이며, 실제 적용 여부는 검사 유형과 함께 확인해야 합니다. 작성은 모니터 생성을 참조하십시오. |
| 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 | 정보 이벤트 생성 조건으로, 일반 규칙 탐지의 임계값, 로그, APM/RUM 메트릭, 가용성, 프로세스, 네트워크, 급변, 구간 및 호환 구형 유형을 지원합니다. 이상치, 조합, 라이브니스 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에서 저장된 값을 반환합니다. list의 워크스페이스 간 권한 확인에서 해석 결과가 있으면 해당 위치에 보완될 수 있고, 결과가 없어도 이력 값을 유지할 수 있습니다. 클라이언트가 작성할 수 있는 요청 또는 현재의 전체 권한 증명으로 간주하지 않습니다. |
| 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.creatorInfo | object 또는 string | 주체 요약이며, 목록에서 정보가 없으면 빈 문자열, 상세에서 정보가 없으면 {}입니다. |
| content.creatorInfo.uuid | string | 주체 UUID이며, 생략될 수 있습니다. |
| content.creatorInfo.status | integer | 계정/주체 상태이며, 생략될 수 있습니다. |
| content.creatorInfo.wsAccountStatus | integer | 멤버 상태이며, 생략될 수 있습니다. |
| content.creatorInfo.name | string | 표시 이름입니다. |
| content.creatorInfo.username | string | 로그인 이름이며, 생략될 수 있습니다. |
| content.creatorInfo.email | string | 이메일 또는 시스템 ID 식별자입니다. |
| content.creatorInfo.mobile | string | 휴대폰 번호이며, 비어 있을 수 있습니다. |
| content.creatorInfo.countryCode | string | 국가/지역 코드이며, 생략될 수 있습니다. |
| content.creatorInfo.iconUrl | string | 아바타이며, 생략될 수 있습니다. |
| content.creatorInfo.acntWsNickname | string | 워크스페이스 닉네임이며, 생략될 수 있습니다. |
| content.updatorInfo | object 또는 string | 주체 요약이며, 목록에서 정보가 없으면 빈 문자열, 상세에서 정보가 없으면 {}입니다. |
| content.updatorInfo.uuid | string | 주체 UUID이며, 생략될 수 있습니다. |
| content.updatorInfo.status | integer | 계정/주체 상태이며, 생략될 수 있습니다. |
| content.updatorInfo.wsAccountStatus | integer | 멤버 상태이며, 생략될 수 있습니다. |
| content.updatorInfo.name | string | 표시 이름입니다. |
| content.updatorInfo.username | string | 로그인 이름이며, 생략될 수 있습니다. |
| content.updatorInfo.email | string | 이메일 또는 시스템 ID 식별자입니다. |
| content.updatorInfo.mobile | string | 휴대폰 번호이며, 비어 있을 수 있습니다. |
| content.updatorInfo.countryCode | string | 국가/지역 코드이며, 생략될 수 있습니다. |
| content.updatorInfo.iconUrl | string | 아바타이며, 생략될 수 있습니다. |
| content.updatorInfo.acntWsNickname | string | 워크스페이스 닉네임이며, 생략될 수 있습니다. |
| content.allow_operation | boolean 또는 null | 현재 호출 주체의 작업 표시 값입니다. 여전히 인터페이스 권한과 비즈니스 검증이 필요하며, 미설정 시 null일 수 있습니다. |
| content.permissionSetInfo | object | permissionSet이 비어 있지 않을 때 식별자→정보 매핑을 제공하며, 일치하는 주체가 없으면 {}일 수 있습니다. |
| content.permissionSetInfo.주체 | object | 계정의 전체 ID 또는 역할/팀 {name,status}입니다. |
| content.permissionSetInfo.주체.uuid | string | 주체 UUID이며, 생략될 수 있습니다. |
| content.permissionSetInfo.주체.status | integer | 계정/주체 상태이며, 생략될 수 있습니다. |
| content.permissionSetInfo.주체.wsAccountStatus | integer | 멤버 상태이며, 생략될 수 있습니다. |
| content.permissionSetInfo.주체.name | string | 표시 이름입니다. |
| content.permissionSetInfo.주체.username | string | 로그인 이름이며, 생략될 수 있습니다. |
| content.permissionSetInfo.주체.email | string | 이메일 또는 시스템 ID 식별자입니다. |
| content.permissionSetInfo.주체.mobile | string | 휴대폰 번호이며, 비어 있을 수 있습니다. |
| content.permissionSetInfo.주체.countryCode | string | 국가/지역 코드이며, 생략될 수 있습니다. |
| content.permissionSetInfo.주체.iconUrl | string | 아바타이며, 생략될 수 있습니다. |
| content.permissionSetInfo.주체.acntWsNickname | string | 워크스페이스 닉네임이며, 생략될 수 있습니다. |
| content.monitorName | string 또는 null | 목록에서는 null일 수 있습니다. 목록의 그룹명 보완은 monitorUUID와 일치함을 보장하지 않으므로 monitorUUID로 그룹을 확인해야 합니다. 상세에서는 그룹이 있을 때만 반환합니다. |
| content.tagInfo | array<object> |
유효한 연관 태그 요약입니다. |
| content.tagInfo[].id | integer | 태그 레코드 번호입니다. |
| content.tagInfo[].uuid | string | 태그 UUID입니다. |
| content.tagInfo[].name | string | 태그명입니다. |
| content.tagInfo[].description | string | 태그 설명입니다. |
| content.tagInfo[].colour | string | 태그 색상입니다. |
| content.tagInfo[].scope | string 또는 array | 범위이며, 이력의 빈 값은 문자열 all로 대체될 수 있고, 그 외에는 배열입니다. |
| content.tagInfo[].scope[] | string | 단일 scope이며, 생략될 수 있습니다. |
| content.alertPolicyInfos | array<object> |
유효한 연관 알림 정책입니다. |
| content.alertPolicyInfos[].uuid | string | 정책 UUID입니다. |
| content.alertPolicyInfos[].name | string | 정책 이름입니다. |
| content.dashboardUUID | string | 유효한 연관 대시보드 UUID이며, 생략될 수 있습니다. |
| content.dashboardName | string | 대시보드 이름이며, 생략될 수 있습니다. |
| content.relCombinedCheckerInfos | array<object> |
이 규칙을 참조하는 조합 모니터링 요약이며, 생략될 수 있습니다. |
| content.relCombinedCheckerInfos[].uuid | string | 조합 모니터링 UUID입니다. |
| content.relCombinedCheckerInfos[].name | string | 조합 이름입니다. |
| content.memberRuleInfos | array<object> |
조합 모니터링 상세에서만 반환되는 유효 멤버 요약이며, 일반 규칙에서는 반환하지 않습니다. |
| content.memberRuleInfos[].uuid | string | 멤버 규칙 UUID입니다. |
| content.memberRuleInfos[].name | string | 멤버 이름입니다. |
| content.incidentsTagInfo | array<object> |
extend.incidentsTags의 이름에 대응하는 유효 태그 전체 엔터티입니다. |
| content.incidentsTagInfo[].id | integer | 태그 레코드 번호입니다. |
| content.incidentsTagInfo[].uuid | string | 태그 UUID입니다. |
| content.incidentsTagInfo[].name | string | 태그명입니다. |
| content.incidentsTagInfo[].description | string | 태그 설명입니다. |
| content.incidentsTagInfo[].colour | string | 태그 색상입니다. |
| content.incidentsTagInfo[].scope | string 또는 array | 범위이며, 이력의 빈 값은 문자열 all로 대체될 수 있고, 그 외에는 배열입니다. |
| content.incidentsTagInfo[].scope[] | string | 단일 scope이며, 생략될 수 있습니다. |
| content.incidentsTagInfo[].workspaceUUID | string | 태그 워크스페이스입니다. |
| content.incidentsTagInfo[].status | integer | 유효 태그 상태 0입니다. |
| content.incidentsTagInfo[].creator | string | 태그 생성 주체입니다. |
| content.incidentsTagInfo[].updator | string | 태그 업데이트 주체입니다. |
| content.incidentsTagInfo[].createAt | integer | 태그 생성 Unix 초입니다. |
| content.incidentsTagInfo[].updateAt | integer | 태그 업데이트 Unix 초입니다. |
| content.incidentsTagInfo[].deleteAt | integer | 태그 삭제 Unix 초입니다. |
| content.levelInfo | array | 호환 반환으로 등급 UUID 문자열과 추가된 등급 표시 객체를 함께 포함합니다. 미설정 시 빈 []이며, 순수 객체 배열로 해석하지 않습니다. |
| content.levelInfo[] | string 또는 object | 문자열은 원래 설정 UUID입니다. 객체는 {} 또는 이력/시스템 등급 정보일 수 있으며, 현재도 선택 가능함을 보장하지 않습니다. |
| content.levelInfo[].id | integer | 등급 레코드 번호이며, 시스템 기본값은 생략될 수 있습니다. |
| content.levelInfo[].uuid | string | 등급 UUID입니다. |
| content.levelInfo[].name | string | 등급명입니다. |
| content.levelInfo[].color | string | 등급 색상입니다. |
| content.levelInfo[].description | string | 등급 설명입니다. |
| content.levelInfo[].workspaceUUID | string | 등급이 속한 워크스페이스이며, 생략될 수 있습니다. |
| content.levelInfo[].extend | object | 등급 확장이며, 기본적으로 생략될 수 있습니다. |
| content.levelInfo[].extend.사용자 정의 키 | JSON | 저장된 등급 확장 값입니다. |
| content.levelInfo[].isManage | boolean | 전역 관리 등급 표시이며, 생략될 수 있습니다. |
| content.levelInfo[].isDefault | boolean | 기본 등급 선택 가능 표시입니다. |
| content.levelInfo[].status | integer | 이력 등급 상태이며, 생략될 수 있습니다. |
| content.levelInfo[].creator | string | 등급 생성 주체이며, 생략될 수 있습니다. |
| content.levelInfo[].updator | string | 등급 업데이트 주체이며, 생략될 수 있습니다. |
| content.levelInfo[].createAt | integer | 등급 생성 Unix 초입니다. |
| content.levelInfo[].updateAt | integer | 등급 업데이트 Unix 초입니다. |
| content.levelInfo[].deleteAt | integer | 등급 삭제 Unix 초입니다. |
| content.channelInfo | object | 채널 UUID를 키로 하는 연관 채널 엔터티 매핑이며, 비어 있으면 {}입니다. 현재 조회에는 이력 상태가 포함될 수 있으므로 유효 채널 목록으로 간주하지 않습니다. |
| content.channelInfo.채널UUID | object | 단일 채널의 전체 엔터티입니다. |
| content.channelInfo.채널UUID.id | integer 또는 null | 데이터베이스 레코드 번호입니다. 생성 시 영속화 전에 응답을 구성하므로 null일 수 있습니다. 리소스 작업에는 uuid를 사용하십시오. |
| content.channelInfo.채널UUID.uuid | string | 채널 UUID이며, 수정, 삭제 또는 구독에 사용합니다. |
| content.channelInfo.채널UUID.workspaceUUID | string | 채널이 속한 워크스페이스입니다. |
| content.channelInfo.채널UUID.name | string | 채널 이름입니다. default는 기본 채널을 의미합니다. |
| content.channelInfo.채널UUID.description | string | 채널 설명입니다. |
| content.channelInfo.채널UUID.notifyTarget | array<string> |
해당 채널에 직접 설정된 알림 대상 UUID입니다. |
| content.channelInfo.채널UUID.notifyTarget[] | string | 단일 알림 대상 UUID입니다. |
| content.channelInfo.채널UUID.notifyUpgradeCfg | object | 에스컬레이션 알림 설정이며, 미설정 시 빈 객체입니다. |
| content.channelInfo.채널UUID.notifyUpgradeCfg.triggerTime | integer | 에스컬레이션 알림을 트리거하는 대기 시간(초)입니다. |
| content.channelInfo.채널UUID.notifyUpgradeCfg.notifyTarget | array<string> |
에스컬레이션 알림 대상 UUID 목록입니다. |
| content.channelInfo.채널UUID.notifyUpgradeCfg.notifyTarget[] | string | 에스컬레이션 알림 대상 UUID입니다. |
| content.channelInfo.채널UUID.status | integer | 레코드 상태이며, 정상은 0입니다. |
| content.channelInfo.채널UUID.creator | string | 생성 호출 주체입니다. |
| content.channelInfo.채널UUID.updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 빈 문자열일 수 있습니다. |
| content.channelInfo.채널UUID.createAt | integer | 생성 시간, Unix 초입니다. |
| content.channelInfo.채널UUID.updateAt | integer | 업데이트 시간, Unix 초이며, 미업데이트 시 -1입니다. |
| content.channelInfo.채널UUID.deleteAt | integer | 삭제 시간, Unix 초이며, 미삭제 시 -1입니다. |
| content.declaration | object | 비어 있지 않은 객체의 공개 선언입니다. 이력이 없고 {}를 반환할 때는 이 필드를 추가하지 않습니다. |
{
"code": 200,
"content": {
"id": 100,
"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,
"creatorInfo": {},
"updatorInfo": {},
"monitorName": "默认分组",
"alertPolicyInfos": [],
"tagInfo": [],
"allow_operation": null,
"relCombinedCheckerInfos": [],
"incidentsTagInfo": [],
"levelInfo": [],
"channelInfo": {},
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
호환 이력에 레코드가 없는 경우:
{
"code": 200,
"content": {},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방식 |
|---|---|---|---|---|
| 404 | ft.NotFoundRuleInspector | 현재/대상 워크스페이스에 해당 비삭제 규칙이 없음 | 지정된 규칙/검사기를 찾을 수 없음 | UUID가 속한 워크스페이스를 확인하십시오. 이력이 없으면 {}를 성공적으로 반환할 수 있습니다. |
| 406 | ft.workspaceUnauthorized | 대상 워크스페이스에 해당 유효 권한이 없음 | 워크스페이스[{}] 권한 없음 | 소스 권한 및 호출 워크스페이스를 확인하십시오. |
| 406 | ft.NotFoundWorkspaceAuthorizationCfg | 사이트 간 사용 가능한 권한 설정 없음 | 워크스페이스 권한 정보를 찾을 수 없음 | 관리자가 소스/대상 사이트 권한을 확인해야 합니다. |
| 406 | ft.UnsupportMultiSiteQuery | 권한 확인이 여러 소스 사이트를 포함 | 다중 사이트 워크스페이스 조회를 지원하지 않음 | 한 번에 하나의 소스 워크스페이스와 사이트를 선택하십시오. |
| 400 | ft.InvalidWorkspace | 대상 워크스페이스가 삭제됨/사용 불가 | 유효하지 않은 워크스페이스: {} | 유효한 소스 워크스페이스를 확인하십시오. |
| 404 | ft.NoInitOtherNodeCfg | 사이트 간 대상 주소가 설정되지 않음 | 다른 노드 설정이 초기화되지 않음 | 관리자가 사이트 서비스 설정 및 권한을 확인해야 합니다. |
| 500 | ft.InternalServerError | 규칙/이력/연관/권한 조회, 포맷팅 또는 일반 하위 5xx 실패; ruleHistory를 정수로 변환할 수 없는 경우에도 실패 | 내부 오류 | 이 페이지의 파라미터 형식을 사용하고 현재 규칙 및 소스를 확인하십시오. 지속적으로 실패하면 traceId를 제공하십시오. |