자동 검색 구성 생성¶
POST /api/v1/issue_auto_discovery/add
개요¶
이벤트 집계 기반의 Issue 자동 검색 구성을 생성합니다.
호출 전 및 사용 단계¶
이 모듈은 기존 인시던트 Issue 자동 검색 구성이며, 인시던트 센터의 교대/자동 집계도, 오류 추적(ErrorTrack) 규칙도 아닙니다. 현재 공개 쓰기 dqlNamespace는 keyevent만 가능하며, rum/tracing 예전 예시는 현재 선언과 부합하지 않습니다. 백그라운드에서 이미 issueUpgrade=true로 마이그레이션된 워크스페이스는 이 v2 자동 검색 작업을 건너뛰므로, 구성 성공만으로 해당 워크스페이스에서 새 Issue가 생성된다고 보장할 수 없습니다.
권한은 trace.issueDiscovery/rum.issueDiscovery/anomaly.issueDiscovery 중 하나를 충족해야 합니다. 규칙 name과 생성되는 Issue의 config.name은 서로 다른 필드입니다. every는 300/600/900/1800/3600만 가능하며, 60은 예전 열거형에 나타나지만 사전 최소값 검사에서 거부됩니다. dimensions에는 명시적으로 비어 있지 않은 필드명을 지정하고, config에는 description, channelUUIDs, extend.text를 명시적으로 지정하십시오. 그렇지 않으면 저장에 성공하더라도 키 누락/유효하지 않은 쿼리로 인해 작업이 실패할 수 있습니다.
규칙 이름은 워크스페이스 내에서 유일하지만 멱등 키가 없습니다. 결과가 불명확하면 먼저 이름과 내용을 조회하고 중복 생성하지 마십시오.
config.extend.manager는 정규화되며, 알 수 없는 계정/대상은 조용히 제외될 수 있습니다. 명시적 null은 선언상 허용되지만 현재 감사/처리에서 바로 .get을 호출해 500이 발생하므로 전달하지 마십시오. dutyPerson을 사용하면 기존 인시던트 알림 일정을 사용하며, 인시던트 센터 교대가 아닙니다. {{변수}}는 그룹 태그/집계 count의 word 키로만 치환되며, 알 수 없는 변수는 그대로 유지되고 임의의 템플릿 코드는 실행되지 않습니다.
구성을 저장해도 쿼리가 즉시 실행되거나 생성 작업이 반환되지 않습니다. Asia/Shanghai 캘린더에 맞춰 주기적으로 정렬되어 이전 every초 구간을 처리하며, 작업 큐/쿼리 소요 시간으로 인해 지연될 수 있습니다. keyevent는 monitor 이벤트에서 집계되며 dimensions에 따라 최대 1000개 그룹을 생성하고, 광범위한 범위의 완전한 커버리지를 보장하지 않습니다. 그룹화 디멘션을 정렬한 JSON으로 중복 식별자를 생성하며 규칙 UUID는 이 식별자에 포함되지 않으므로, 동일 워크스페이스에서 동일 디멘션 값을 가진 여러 규칙이 동일한 기존 Issue에 연결될 수 있습니다. 디멘션/필터를 수정하면 그룹 결과가 달라질 수 있으니, 이를 규칙별로 독립적이며 절대 교차하지 않는 Issue 집합으로 간주하지 마십시오. Open/Pending에는 답글이 추가되고, Resolved는 재오픈되어 회귀하며, Closed는 재사용되지 않습니다. 과거 Working 분기는 실제 구현에 따라 처리되며, 작업 중 완전한 격리를 보장하지 않습니다. 알림은 비동기이므로 HTTP 200이 데이터 쿼리 성공/새 Issue 생성/알림 전달을 의미하지 않습니다.
요청 헤더¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 획득합니다. |
Body 요청 파라미터¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| dimensions[*] | string | 단일 필드명 문자열입니다. 소스 선언은 하위 항목을 제약하지 않습니다. 문자열이 아니면 동기 감사 자료 조합 시 500이 발생합니다. add는 보통 제출 전에 실패하고, modify는 첫 제출 후에 실패할 수 있습니다. 문자열이지만 필드가 존재하지 않으면 백그라운드 쿼리 시 실패하거나 데이터가 없을 수 있습니다. 백틱/전체 쿼리 조각을 필드명으로 사용하지 마십시오. 예시: service획득 또는 입력 방법: 이벤트 필드/태그명이며, 모든 대상 데이터에 해당 필드가 있는지 확인하십시오. |
|
| config.channelUUIDs[*] | string | 단일 활성 채널 UUID입니다. 디멘션 필드/팀 UUID가 아니며, 알 수 없거나 비활성화된 경우 404입니다. 예시: chan_example획득 또는 입력 방법: 현재 워크스페이스 채널 목록의 uuid입니다. |
|
| config.extend.text | string | 명시적 문자열을 권장합니다. 작업이 읽어서 템플릿 치환하며, 누락/비문자열이면 비동기적으로 실패할 수 있습니다. config.description과 각각 별도로 저장되는 텍스트 필드입니다. 예시: 서비스{{service}}에서 {{count}}개 이벤트 발견획득 또는 입력 방법: dimensions 태그 및 집계 count에 따라 Issue 본문 템플릿을 구성합니다. |
|
| config.extend.manager | array | 선택적 담당자 문자열 배열입니다. 유효한 acnt_/현재 워크스페이스 팀/이메일/dutyPerson은 유지되며, 알 수 없는 계정/알 수 없는 값은 조용히 제외될 수 있고 항목별 오류를 보장하지 않습니다. 무료/체험 워크스페이스는 외부 이메일을 지원하지 않으며 400이 발생할 수 있습니다. 담당자가 없으면 미할당 에스컬레이션 절차로 진행될 수 있습니다. 예시: []획득 또는 입력 방법: 워크스페이스 멤버에서 acnt_를, 팀 목록에서 group_을 가져오거나, 멤버/허용된 외부 이메일을 사용합니다. 기존 인시던트의 오늘 온콜 담당자가 필요하면 리터럴 값 dutyPerson을 사용하며, 구성은 알림 일정을 참조하십시오. |
|
| config.extend.manager[*] | string | 유효한 주체, 이메일 또는 dutyPerson 하나입니다. 문자열이 아니면 문자열 startswith 처리 시 500이 발생할 수 있습니다. 예시: acnt_example획득 또는 입력 방법: 워크스페이스 멤버에서 acnt_를, 팀 목록에서 group_을 가져오거나, 멤버/허용된 외부 이메일을 사용합니다. 기존 인시던트의 오늘 온콜 담당자가 필요하면 리터럴 값 dutyPerson을 사용하며, 구성은 알림 일정을 참조하십시오. |
|
| config.extend.conditionsInputFilters | any | 선택적 임의 JSON으로, 과거 Issue/알림 이벤트 이동 시 보충 필터를 되돌려 표시하기 위한 것입니다. 실제 쿼리는 여전히 최상위 conditions를 사용하며, 이 키만 수정해 대체할 수 없습니다. 예시: {}획득 또는 입력 방법: 인시던트 조건 편집기에서 표시용 구조를 제공할 수 있습니다. |
|
| config.extend.variable | json | 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 쿼리 컬럼으로 해당 객체를 덮어쓰며, 일반적인 count는 구간 내 건수입니다. 예시: {"count": 8}획득 또는 입력 방법: 생성 작업 실행 시 집계 변수를 계산합니다. |
|
| config.extend.variable.count | integer | 런타임 발생 횟수이며, 호출자가 입력한 값은 신뢰할 수 있는 고정 값으로 적용되지 않습니다. 예시: 8획득 또는 입력 방법: 백그라운드에서 이 구간의 count(*) 쿼리로 계산합니다. |
|
| config.extend.tags | json | 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 그룹 태그로 덮어쓰며, Issue 중복 제거 및 템플릿 변수에 사용됩니다. 예시: {"service": "payment"}획득 또는 입력 방법: 생성 작업이 그룹 태그로부터 가져옵니다. |
|
| config.extend.tags.필드 | any | 동적 JSON 태그 값이며, 호출자가 직접 입력한 값으로 그룹 생성을 고정할 수 없습니다. 예시: payment획득 또는 입력 방법: dimensions에 대응하는 이벤트 태그 값에서 가져옵니다. |
|
| config.extend.channelUUIDs | array | 런타임에 유효한 구성 채널로 덮어써지며, 이 확장 필드로 config.channelUUIDs를 대체하지 마십시오. 예시: []획득 또는 입력 방법: 작업이 config.channelUUIDs에 따라 현재 유효한 채널을 필터링한 후 기록합니다. |
|
| config.extend.channelUUIDs[*] | string | 런타임에 유효한 채널 식별자 하나입니다. 예시: chan_example획득 또는 입력 방법: 현재 워크스페이스의 유효한 채널 uuid입니다. |
|
| config.extend.사용자 정의 키 | any | 임의 JSON 저장 값이며, 이 페이지에서 공개된 추가 실행 보장은 없습니다. 자격 증명을 넣지 마십시오. 예시: value획득 또는 입력 방법: 호출자 비즈니스 표시용 확장입니다. |
|
| conditions | string | 선택적 문자열로, 필터 표현식만이며 전체 DQL/JSON이 아닙니다. 생성 시 생략하면 비어 있고, 수정 시 생략하면 유지, 빈 값이면 제거됩니다. 현재 저장 시 DQL을 파싱하지 않으므로 구문/필드 유효성을 보장하지 않고, 비동기 작업 실패가 이번 인터페이스 오류로 변환되지 않습니다. 엔터티 컬럼은 48자이며 선언에는 길이 제한이 없으므로 짧은 표현식을 권장하고 관리자가 배포 컬럼 제한을 확인해야 합니다. 빈 문자열 허용: True null 허용: False 예시: `df_status` = 'error'획득 또는 입력 방법: 대상 monitor 이벤트의 실제 필드로 DQL 필터 조건을 구성하며, 먼저 쿼리 도구에서 동일한 시간 범위로 검증할 수 있습니다. |
|
| config | json | Y | 필수 객체이며, 수정 시 매번 전체 교체되고 재귀 병합되지 않습니다. name/level/channelUUIDs/description/extend 5개의 선언된 키만 허용됩니다. 이후 작업의 안정적인 실행을 위해 선택 사항이라도 description, channelUUIDs 배열, extend 객체 및 extend.text 문자열을 명시적으로 제공할 것을 권장합니다. 누락 시 저장은 성공하지만 작업이 실패할 수 있습니다. null 허용: False 예시: {"name": "서비스{{service}} 알림", "description": "이 구간 {{count}}개 이벤트", "channelUUIDs": [], "extend": {"text": "서비스{{service}}에서 {{count}}개 이벤트 발견", "manager": []}}획득 또는 입력 방법: 이 페이지의 템플릿 구성에 따라 Issue 제목, 본문, 채널 및 담당자를 생성합니다. |
| config.channelUUIDs | array | 선택적 채널 UUID 배열이며, 명시된 항목은 현재 활성이어야 합니다. 항상 [] 또는 유효한 배열을 전달할 것을 권장하며, 생략하면 저장은 가능하지만 작업에서 None을 순회하다 실패할 수 있습니다. 작업이 자동으로 기본 채널 연결을 보충하지만, 저장 자체는 []여도 워크스페이스에 최소 하나의 활성 채널이 있어야 합니다. null 허용: False 예시: []획득 또는 입력 방법: 채널 목록에서 현재 워크스페이스의 활성 chan_ UUID를 가져옵니다. |
|
| config.description | string | 선언상 선택적 문자열이지만 이후 작업이 이 키를 직접 읽으므로 항상 명시적으로 제공할 것을 권장합니다(빈 문자열 가능). config 수정 시 전체 교체되므로 하위 키를 생략해도 이전 값이 유지되지 않습니다. null 허용: False 예시: 이 구간 {{count}}개 이벤트획득 또는 입력 방법: 동일한 템플릿 변수로 Issue 설명을 구성합니다. |
|
| config.extend | json | 선택적 객체 또는 null입니다. 실제 생성/수정 감사 자료는 extend.get을 직접 호출하므로 명시적 null은 500을 발생시키며, 생성은 보통 제출 전, 수정의 과거 감사는 제출 후 실패할 수 있습니다. 항상 text를 포함한 객체를 전달할 것을 권장하며, 생략해도 저장 후 extend/text 누락으로 작업이 실패할 수 있습니다. 객체가 나타나면 전체 교체되며 임의의 하위 값은 유효한 구조를 유지해야 합니다. null 허용: True 예시: {"text": "서비스{{service}}에서 {{count}}개 이벤트 발견", "manager": []}획득 또는 입력 방법: Issue 생성의 표시 확장을 참조하되, 이 페이지에서 확인된 소비 필드를 기준으로 하십시오. |
|
| config.level | string | 선택적 등급 UUID 또는 빈 문자열이며, 비어 있지 않으면 현재 유효해야 하고 그렇지 않으면 406입니다. 생략하면 지정 등급이 없습니다. 인시던트 센터 등급 UUID의 범용 대체 필드가 아닙니다. 빈 문자열 허용: True null 허용: False 예시: system_level_0획득 또는 입력 방법: Issue 등급 목록에서 uuid를 가져오며, 백그라운드에서 전역 등급을 활성화한 경우 관리자 구성이 우선합니다. |
|
| config.name | string | Y | 필수 문자열 최대 256자이며, Issue 제목 템플릿으로 규칙 name과 다릅니다. {{service}}/{{count}} 등 word 변수명을 지원하고 알 수 없는 변수는 그대로 유지됩니다. 임의의 Python/Jinja 표현식은 지원하지 않으며, 점/하이픈이 있는 필드는 치환이 보장되지 않습니다. null 허용: False 최대 길이: 256 예시: 서비스{{service}} 알림획득 또는 입력 방법: dimensions 필드 및 집계 변수 count에 따라 제목 템플릿을 구성합니다. |
| description | string | 선택적 문자열이며 빈 값을 허용합니다. 생성 시 생략하면 비어 있고, 수정 시 생략하면 유지, 명시적 빈 값이면 제거됩니다. Issue 본문 템플릿으로 사용되지 않습니다. 빈 문자열 허용: True null 허용: False 예시: 서비스별 프로덕션 알림 집계획득 또는 입력 방법: 호출자가 규칙 용도 설명을 작성합니다. |
|
| dimensions | array | 선택적 배열이며, 나타나면 최소 한 항목입니다. 생성 시 생략하면 []로 저장되지만 작업이 by 문을 구성할 때 유효하지 않을 수 있으므로 항상 비어 있지 않은 실제 필드를 제공할 것을 권장합니다. 수정 시 생략하면 유지되고, []는 사전 검사에서 406이므로 비우는 데 사용할 수 없습니다. 채널 UUID가 아닌 필드명이며, 필드 순서/집합이 그룹 쿼리에 영향을 주고 df_label은 집합 기준으로 집계됩니다. null 허용: False 최소 길이: 1 예시: ["service"]획득 또는 입력 방법: 이벤트의 실제 태그 필드에서 그룹 중복 제거에 사용할 필드명을 선택합니다(예: service, host 또는 df_label). |
|
| dqlNamespace | string | Y | 필수이며, 공개 열거형은 keyevent 하나입니다. rum/tracing이 아니며, 과거 엔터티/예시에서 다른 값을 허용했다고 해서 전달할 수 없습니다. null 허용: False 허용 값: ['keyevent'] 예시: keyevent획득 또는 입력 방법: 현재 공개 범위는 keyevent 이벤트 범위로 고정되어 있습니다. |
| every | integer | Y | 필수 정수이며, 300/600/900/1800/3600만 가능합니다. 과거 열거형에 60이 포함되어 있지만 최소값 300이 동시에 적용되어 60은 공개 라우트에서 406이며, 1분은 선택할 수 없습니다. null 허용: False 허용 값: [60, 300, 600, 900, 1800, 3600] $maxValue: 3600 $minValue: 300 예시: 300획득 또는 입력 방법: 발견 지연과 쿼리량에 따라 주기 초 수를 선택합니다. |
| name | string | Y | 필수 문자열 최대 256자입니다. 선언상 비어 있지 않음을 강제하지 않지만 비어 있지 않게 권장합니다. 동일 워크스페이스에서 삭제되지 않은 규칙 이름은 중복될 수 없습니다. 수정 시에도 필수이며, 규칙 이름이지 생성되는 Issue 제목이 아닙니다. null 허용: False 최대 길이: 256 예시: 프로덕션 이벤트 자동 검색획득 또는 입력 방법: 유지 관리자가 워크스페이스 내에서 유일한 규칙 이름을 작성합니다. |
파라미터 추가 설명¶
현재 공개 범위는 keyevent입니다. 구성 저장, 정기 실행, 알림 전달은 서로 다른 단계이며, 파라미터와 전체 응답/오류 경계는 아래를 참조하십시오.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/issue_auto_discovery/add' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"生产事件自动发现","description":"按服务聚合生产告警","dqlNamespace":"keyevent","every":300,"conditions":"`df_status` = '"'"'error'"'"'","dimensions":["service"],"config":{"name":"服务{{service}}告警","description":"本窗口{{count}}条事件","channelUUIDs":[],"extend":{"text":"服务{{service}}发现{{count}}条事件","manager":[]}}}'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | object | 제출 전 구성 스냅샷이며, 생성/업데이트 주체 요약이 첨부되지 않고 생성된 Issue/실행 결과도 포함되지 않습니다. |
| content.id | integer 또는 null | 데이터베이스 행 ID이며 경로 위치 지정에 사용되지 않습니다. 제출 전 스냅샷에서는 null일 수 있습니다. |
| content.uuid | string | 자동 검색 규칙 UUID, iatdc_ 접두사입니다. |
| content.status | integer | 0 활성화, 2 비활성화, 3 소프트 삭제이며, 조회 시 3은 제외됩니다. |
| content.creator | string | 생성 주체 UUID이며, 현재 공개 진입점은 보통 wsak_입니다. |
| content.updator | string 또는 null | 업데이트 주체이며, 생성 스냅샷에서는 비어 있거나 null일 수 있습니다. |
| content.createAt | integer | Unix 초 단위 생성 시간입니다. |
| content.updateAt | integer 또는 null | Unix 초 단위 업데이트 시간이며, 제출 전 생성 스냅샷에서는 null일 수 있고, 이후 데이터베이스 기본값/업데이트 값은 -1 또는 실제 시간일 수 있습니다. |
| content.deleteAt | integer | Unix 초 단위 삭제 시간이며, 삭제되지 않은 경우 보통 -1입니다. |
| content.workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. |
| content.name | string | 규칙 이름입니다. |
| content.description | string | 규칙 설명이며, Issue 본문 템플릿이 아닙니다. |
| content.dqlNamespace | string | 현재 공개 쓰기는 keyevent이며, 과거 레코드는 다른 네임스페이스일 수 있으나 공개 인터페이스로 다시 쓸 수 있음을 의미하지 않습니다. |
| content.every | integer | 주기 초 수입니다. |
| content.conditions | string | 저장된 DQL 필터 표현식이며, 실행 성공이 검증되었음을 의미하지 않습니다. |
| content.dimensions | array<string> |
그룹 필드명 배열이며, 과거 오류 유형은 허용 오차가 필요합니다. |
| content.dimensions[] | string | 이벤트 필드명 하나입니다. |
| content.config | object | 생성 Issue 정의 템플릿입니다. |
| content.config.name | string | 필수 문자열 최대 256자이며, Issue 제목 템플릿으로 규칙 name과 다릅니다. {{service}}/{{count}} 등 word 변수명을 지원하고 알 수 없는 변수는 그대로 유지됩니다. 임의의 Python/Jinja 표현식은 지원하지 않으며, 점/하이픈이 있는 필드는 치환이 보장되지 않습니다. |
| content.config.level | string | 선택적 등급 UUID 또는 빈 문자열이며, 비어 있지 않으면 현재 유효해야 하고 그렇지 않으면 406입니다. 생략하면 지정 등급이 없습니다. 인시던트 센터 등급 UUID의 범용 대체 필드가 아닙니다. |
| content.config.channelUUIDs | array | 선택적 채널 UUID 배열이며, 명시된 항목은 현재 활성이어야 합니다. 항상 [] 또는 유효한 배열을 전달할 것을 권장하며, 생략하면 저장은 가능하지만 작업에서 None을 순회하다 실패할 수 있습니다. 작업이 자동으로 기본 채널 연결을 보충하지만, 저장 자체는 []여도 워크스페이스에 최소 하나의 활성 채널이 있어야 합니다. |
| content.config.channelUUIDs[] | string | 단일 활성 채널 UUID입니다. 디멘션 필드/팀 UUID가 아니며, 알 수 없거나 비활성화된 경우 404입니다. |
| content.config.description | string | 선언상 선택적 문자열이지만 이후 작업이 이 키를 직접 읽으므로 항상 명시적으로 제공할 것을 권장합니다(빈 문자열 가능). config 수정 시 전체 교체되므로 하위 키를 생략해도 이전 값이 유지되지 않습니다. |
| content.config.extend.text | string | 명시적 문자열을 권장합니다. 작업이 읽어서 템플릿 치환하며, 누락/비문자열이면 비동기적으로 실패할 수 있습니다. config.description과 각각 별도로 저장되는 텍스트 필드입니다. |
| content.config.extend.manager | array | 선택적 담당자 문자열 배열입니다. 유효한 acnt_/현재 워크스페이스 팀/이메일/dutyPerson은 유지되며, 알 수 없는 계정/알 수 없는 값은 조용히 제외될 수 있고 항목별 오류를 보장하지 않습니다. 무료/체험 워크스페이스는 외부 이메일을 지원하지 않으며 400이 발생할 수 있습니다. 담당자가 없으면 미할당 에스컬레이션 절차로 진행될 수 있습니다. |
| content.config.extend.manager[] | string | 유효한 주체, 이메일 또는 dutyPerson 하나입니다. 문자열이 아니면 문자열 startswith 처리 시 500이 발생할 수 있습니다. |
| content.config.extend.conditionsInputFilters | any | 선택적 임의 JSON으로, 과거 Issue/알림 이벤트 이동 시 보충 필터를 되돌려 표시하기 위한 것입니다. 실제 쿼리는 여전히 최상위 conditions를 사용하며, 이 키만 수정해 대체할 수 없습니다. |
| content.config.extend.variable | json | 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 쿼리 컬럼으로 해당 객체를 덮어쓰며, 일반적인 count는 구간 내 건수입니다. |
| content.config.extend.variable.count | integer | 런타임 발생 횟수이며, 호출자가 입력한 값은 신뢰할 수 있는 고정 값으로 적용되지 않습니다. |
| content.config.extend.tags | json | 요청에 입력하지 않는 것을 권장합니다. 작업이 실제 그룹 태그로 덮어쓰며, Issue 중복 제거 및 템플릿 변수에 사용됩니다. |
| content.config.extend.tags.필드 | any | 동적 JSON 태그 값이며, 호출자가 직접 입력한 값으로 그룹 생성을 고정할 수 없습니다. |
| content.config.extend.channelUUIDs | array | 런타임에 유효한 구성 채널로 덮어써지며, 이 확장 필드로 config.channelUUIDs를 대체하지 마십시오. |
| content.config.extend.channelUUIDs[] | string | 런타임에 유효한 채널 식별자 하나입니다. |
| content.config.extend.사용자 정의 키 | any | 임의 JSON 저장 값이며, 이 페이지에서 공개된 추가 실행 보장은 없습니다. 자격 증명을 넣지 마십시오. |
| content.config.extend | object 또는 null | 저장된 확장입니다. 새 요청에서는 객체를 사용해야 하며, null은 동기 감사 또는 이후 작업 예외를 유발합니다. |
| content.declaration | object 또는 null | 현재 워크스페이스의 공통 선언입니다. |
{
"code": 200,
"content": {
"id": null,
"uuid": "iatdc_example",
"status": 0,
"creator": "wsak_example",
"updator": "",
"createAt": 1785427200,
"updateAt": null,
"deleteAt": -1,
"workspaceUUID": "wksp_example",
"name": "生产事件自动发现",
"description": "按服务聚合生产告警",
"dqlNamespace": "keyevent",
"every": 300,
"conditions": "`df_status` = 'error'",
"dimensions": [
"service"
],
"config": {
"name": "服务{{service}}告警",
"description": "本窗口{{count}}条事件",
"channelUUIDs": [],
"extend": {
"text": "服务{{service}}发现{{count}}条事件",
"manager": []
}
},
"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 | 요청 JSON 최상위가 객체가 아님 | 일부 json 파일 형식 오류 | 파라미터 객체를 제출하십시오. |
| 400 | ft.IssueAutoDiscoveryCfgNameExists | 현재 워크스페이스에서 삭제되지 않은 규칙 이름 중복 | 동일한 이름의 규칙 이름이 이미 존재함 | 사용하지 않은 이름을 선택하고, 실패/타임아웃 시 먼저 기존 구성을 조회하십시오. |
| 406 | ft.IssueLevelNotExists | config.level이 비어 있지 않고 현재 적용되는 Issue 등급에 없음 | 등급 구성이 존재하지 않음 | Issue 등급 목록으로 uuid를 확인하고, 표시 이름/인시던트 센터 등급을 혼용하지 마십시오. |
| 404 | ft.NotFoundChannel | 워크스페이스에 활성 채널이 없거나 지정된 channelUUIDs 항목이 활성 채널에 없음 | 지정된 채널을 찾을 수 없음 | 워크스페이스에 활성 채널이 있는지 확인하고 채널 목록에서 UUID를 선택하십시오. []도 워크스페이스의 최소 1개 채널 요구 사항을 우회하지 않습니다. |
| 400 | ft.UnsupportFreeIssueManager | 무료/체험 워크스페이스 담당자가 비멤버 외부 이메일 사용 | 체험판 워크스페이스에서는 인시던트 담당자를 외부 이메일로 지원하지 않습니다 | 현재 워크스페이스 멤버를 사용하거나 관리자가 제품 버전을 확인하도록 하십시오. |
| 500 | ft.InternalServerError | 템플릿/담당자/디멘션 동기 감사 자료 구성, 구성 데이터베이스 쓰기 또는 컨텍스트 제출 등 처리되지 않은 예외 | 내부 오류 | 먼저 이름으로 구성을 읽어 저장되었는지 확인하십시오. 하위 구조/비문자열 디멘션은 보통 저장 전에 실패하며, 결과가 불명확하면 중복 생성하지 말고 traceId를 보관하여 확인하십시오. |