가져오기¶
POST /api/v1/checker/import
개요¶
모니터 설정 하나/여러 개 가져오기
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| checkers | array | Y | 규칙 설정 목록 빈 값 허용: False |
| type | string | 지능형 모니터링 가져오기 시 smartMonitor, AI 의미론적 모니터 가져오기 시 aiMonitor, 기본값은 일반 모니터 trigger 빈 값 허용: False 빈 문자열 허용: False 선택 가능한 값: ['smartMonitor', 'trigger', 'aiMonitor'] |
|
| skipRepeatNameCheck | boolean | 중복 이름 검사 건너뛰기 여부. false는 중복 이름 검사를 수행하고, true는 중복 이름 검사를 건너뜁니다 예시: False 빈 값 허용: False |
|
| skipRepeatNameCreate | boolean | true는 동일 이름이면 생성을 건너뛰고, 다른 이름이면 바로 생성하며, false는 모든 가져오기 정보를 생성합니다 예시: False 빈 값 허용: False |
|
| deleteRepeatName | boolean | true는 동일 이름의 모니터를 삭제하고 가져오며, 기본값은 false입니다 예시: False 빈 값 허용: False |
매개변수 추가 설명¶
모니터 템플릿 설정은 【모니터 내보내기 API】를 참조하세요
OuterEventChecker는 가져오기 전에 subUri/isChangeEvent를 일괄 검증합니다. 항목 중 하나라도 실패하면 생성 수는 0이 됩니다. 가져오기 시 기존 secret은 재사용하지 않으며 각 규칙에 대해 새 값을 생성합니다.
관련 매개변수 설명. 응답 결과 content에 repeat_name이 있으면 동일 이름이 존재한다는 뜻입니다. skipRepeatNameCreate 매개변수를 추가하여 건너뛰기 또는 동일 이름 생성을 선택할 수 있습니다.
| 매개변수명 | type | 필수 | 설명 |
|---|---|---|---|
| checker | array | 필수 | 규칙 설정 목록 |
| skipRepeatNameCheck | boolean | 필수 | 중복 이름 검사 건너뛰기 여부. 건너뛰지 않으면(false): 중복 이름 검사에 실패할 경우 동일 이름의 모니터 이름 목록을 반환합니다 |
| skipRepeatNameCreate | boolean | 필수 | 동일 이름 생성 건너뛰기 여부. 건너뛰지 않으면(false): 동일 이름의 모니터를 생성합니다 |
| deleteRepeatName | boolean | 선택 | 동일 이름의 모니터를 삭제하고 가져올지 여부. 기본값은 false입니다 |
요청 예시¶
curl 'https://openapi.guance.com/api/v1/checker/import' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"checkers":[{"extend":{"funcName":"","isNeedCreateIssue":false,"issueLevelUUID":"","needRecoverIssue":false,"querylist":[{"datasource":"dataflux","qtype":"dql","query":{"alias":"","code":"Result","dataSource":"ssh","field":"ssh_check","fieldFunc":"count","fieldType":"float","funcList":[],"groupBy":["host"],"groupByTime":"","namespace":"metric","q":"M::`ssh`:(count(`ssh_check`)) BY `host`","type":"simple"},"uuid":"aada629a-672e-46f9-9503-8fd61065c382"}],"rules":[{"conditionLogic":"and","conditions":[{"alias":"Result","operands":["90"],"operator":">="}],"status":"critical"},{"conditionLogic":"and","conditions":[{"alias":"Result","operands":["0"],"operator":">="}],"status":"error"}]},"is_disable":false,"jsonScript":{"atAccounts":[],"atNoDataAccounts":[],"channels":[],"checkerOpt":{"infoEvent":false,"rules":[{"conditionLogic":"and","conditions":[{"alias":"Result","operands":["90"],"operator":">="}],"status":"critical"},{"conditionLogic":"and","conditions":[{"alias":"Result","operands":["0"],"operator":">="}],"status":"error"}]},"disableCheckEndTime":false,"every":"1m","groupBy":["host"],"interval":300,"message":"message1","noDataMessage":"","noDataTitle":"","recoverNeedPeriodCount":2,"targets":[{"alias":"Result","dql":"M::`ssh`:(count(`ssh_check`)) BY `host`","qtype":"dql"}],"title":"Host {{ host }} SSH error","type":"simpleCheck"},"monitorName":"default","secret":"","tagInfo":[],"type":"trigger"}]}' \
--compressed
응답¶
{
"code": 200,
"content": {
"declaration": {
"business": "",
"organization": "663dbba102482200070bbb02"
},
"rule": [
{
"createAt": 1756285080,
"createdWay": "import",
"creator": "wsak_22e2b98bd92b48ba9d92dcbd4e526f8e",
"crontabInfo": {
"crontab": "0 */1 * * * *",
"id": "cron-LoiyL3IGSZaV"
},
"deleteAt": -1,
"extend": {
"funcName": "",
"isNeedCreateIssue": false,
"issueLevelUUID": "",
"needRecoverIssue": false,
"querylist": [
{
"datasource": "dataflux",
"qtype": "dql",
"query": {
"alias": "",
"code": "Result",
"dataSource": "ssh",
"field": "ssh_check",
"fieldFunc": "count",
"fieldType": "float",
"funcList": [],
"groupBy": [
"host"
],
"groupByTime": "",
"namespace": "metric",
"q": "M::`ssh`:(count(`ssh_check`)) BY `host`",
"type": "simple"
},
"uuid": "aada629a-672e-46f9-9503-8fd61065c382"
}
],
"rules": [
{
"conditionLogic": "and",
"conditions": [
{
"alias": "Result",
"operands": [
"90"
],
"operator": ">="
}
],
"status": "critical"
},
{
"conditionLogic": "and",
"conditions": [
{
"alias": "Result",
"operands": [
"0"
],
"operator": ">="
}
],
"status": "error"
}
]
},
"id": null,
"isLocked": false,
"jsonScript": {
"atAccounts": [],
"atNoDataAccounts": [],
"checkerOpt": {
"infoEvent": false,
"rules": [
{
"conditionLogic": "and",
"conditions": [
{
"alias": "Result",
"operands": [
"90"
],
"operator": ">="
}
],
"status": "critical"
},
{
"conditionLogic": "and",
"conditions": [
{
"alias": "Result",
"operands": [
"0"
],
"operator": ">="
}
],
"status": "error"
}
]
},
"disableCheckEndTime": false,
"every": "1m",
"groupBy": [
"host"
],
"interval": 300,
"message": "message1",
"name": "Host {{ host }} SSH error",
"noDataMessage": "",
"noDataTitle": "",
"recoverNeedPeriodCount": 2,
"targets": [
{
"alias": "Result",
"dql": "M::`ssh`:(count(`ssh_check`)) BY `host`",
"qtype": "dql"
}
],
"title": "Host {{ host }} SSH error",
"type": "simpleCheck"
},
"monitorUUID": "monitor_7dbd71a127f945c0a968f1e4582dd9c9",
"openPermissionSet": false,
"permissionSet": [],
"refKey": "",
"secret": null,
"status": 0,
"tagInfo": [],
"type": "trigger",
"updateAt": -1,
"updator": "",
"uuid": "rul_8e1a91ee842b4101ba23684f62b76fc0",
"workspaceUUID": "wksp_84c4a0044edc4f878ea88e4517659bda"
}
]
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-5C22D448-A71E-469A-B054-10C5EBD4089E"
}