생성¶
POST /api/v1/issue/add
개요¶
Issue를 생성하고 레벨, 담당자, 소스, 채널 및 선택적 첨부 파일을 설정한 뒤 후속 알림을 제출합니다.
호출 전 및 사용 단계¶
먼저 유효 레벨 목록을 조회하여 사용 가능한 레벨을 선택합니다. 최소 요청에는 name, level, description, extend={}가 포함됩니다. 초기 statusType은 10 Open으로 고정되며, 생성 API는 statusType을 받지 않습니다. 모든 Issue는 기본 채널로 전송됩니다. channelUUIDs와 extend.channels로 같은 워크스페이스의 채널을 추가할 수 있습니다. 담당자를 지정하지 않으면 기존 설정에 따라 담당자 없는 에스컬레이션 알림 흐름으로 진행될 수 있습니다. 소스가 일반 수동 이슈이거나 viewer인 경우 초기화 시스템 응답 작업이 제출될 수 있으며, 해당 작업은 Obsy의 change 작업 기록을 생성합니다. 이 API에서 AI 분석 결과를 보장하지 않으며, 이후 응답 목록에서 확인할 수 있습니다. API 성공이 알림 전달을 의미하지는 않습니다. 알림은 비동기로 실행되며, 수신자는 채널 구독, 알림 대상, 알림 정책, 담당자 및 이번 @ 멤버에 따라 결정됩니다. 콘솔에서 알림 설정과 실제 전달 여부를 확인하세요. 쓰기와 후속 알림, 첨부 파일 처리는 단계별로 실행됩니다. 실패하거나 타임아웃된 경우 먼저 리소스가 생성 또는 갱신되었는지 조회한 후 재시도 여부를 결정하여 중복 기록과 알림을 방지하세요.
요청 헤더¶
| 파라미터명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Body 요청 파라미터¶
| 파라미터명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| attachmentUuids[*] | json | 단일 업로드된 첨부 파일 UUID입니다. 예시: att_example획득 또는 입력 방법: 첨부 파일 업로드의 content.attachmentUuid를 사용합니다. |
|
| extend.text | json | 선택적 순수 텍스트로, 서버 측 길이 검사에 사용되며 최대 3000자입니다. 예시: 프로덕션 API 지연 원인 파악.획득 또는 입력 방법: 설명에서 순수 텍스트를 추출하여 3000자 이내로 유지합니다. 생략하면 빈 텍스트로 검사합니다. |
|
| extend.channels | array | 채널 참조 배열입니다. 기존에 바인딩된 채널에 추가 병합되며, []는 기존 바인딩을 지우지 않습니다. 예시: [{"type": "#", "uuid": "chan_example", "name": "프로덕션 이상"}]획득 또는 입력 방법: 채널 목록에서 실제 채널 UUID를 가져와 설명에서 참조한 # 채널을 지정합니다. 생략하면 추가하지 않습니다. |
|
| extend.channels[*] | json | 채널 참조 객체입니다. 예시: {"type": "#", "uuid": "chan_example", "name": "프로덕션 이상"}획득 또는 입력 방법: 각 항목에 같은 워크스페이스의 실제 채널 하나를 선택합니다. |
|
| extend.channels[*].uuid | json | 채널 UUID입니다. 예시: chan_example획득 또는 입력 방법: 채널 목록의 content[].uuid에서 가져옵니다. |
|
| extend.channels[*].name | json | 클라이언트 표시 이름입니다. 예시: 프로덕션 이상획득 또는 입력 방법: 채널 목록에서 해당 name을 가져와 표시에 사용하며, 생략할 수 있습니다. |
|
| extend.channels[*].type | json | 채널 참조 표시자입니다. 예시: #획득 또는 입력 방법: 채널 참조는 고정적으로 #을 사용하며, 서버가 결과를 읽을 때 이 표시자를 보완합니다. |
|
| extend.channels[*].exists | json | 선택적 표시 플래그로, 서버의 리소스 검증을 대체하지 않습니다. 예시: true획득 또는 입력 방법: 유효성 증빙으로 전달할 필요가 없으며, 조회 응답에서 현재 리소스 존재 여부에 따라 다시 계산됩니다. |
|
| extend.members | array | 이번 @ 멤버 참조로, 일회성 알림 이메일을 수집하는 데 사용됩니다. 담당자 배열이 아닙니다. 예시: [{"type": "@", "uuid": "acnt_example", "name": "온콜 엔지니어"}]획득 또는 입력 방법: 대상 워크스페이스의 멤버 관리에서 계정 UUID를 가져옵니다. 생략하면 이번 @ 멤버를 추가하지 않습니다. |
|
| extend.members[*] | json | 멤버 참조 객체입니다. 예시: {"type": "@", "uuid": "acnt_example", "name": "온콜 엔지니어"}획득 또는 입력 방법: @가 필요한 각 계정마다 객체를 작성합니다. |
|
| extend.members[*].uuid | json | 멤버 계정 UUID입니다. 예시: acnt_example획득 또는 입력 방법: 대상 워크스페이스의 멤버 관리에서 acnt_ 계정 UUID를 가져옵니다. |
|
| extend.members[*].name | json | 클라이언트 표시 이름입니다. 예시: 온콜 엔지니어획득 또는 입력 방법: 멤버 표시 이름을 사용하며, 생략할 수 있습니다. |
|
| extend.members[*].type | json | 멤버 참조 표시자입니다. 예시: @획득 또는 입력 방법: 멤버 참조는 @를 사용합니다. |
|
| extend.members[*].exists | json | 선택적 표시 플래그입니다. 예시: true획득 또는 입력 방법: 유효성 증빙으로 전달할 필요가 없으며, 조회 시 다시 계산됩니다. |
|
| extend.extra | json | 외부 표시 정보로, API의 실제 인증/작성자 신원을 대체하지 않습니다. 예시: {}획득 또는 입력 방법: 서드파티 통합에서 외부 작업자를 표시해야 할 때 입력합니다. 없으면 생략하거나 {}를 사용합니다. |
|
| extend.extra.creator | json | 생성자 표시 객체입니다. 예시: {"name": "외부 티켓 생성자", "email": "xxx@guance.com"}획득 또는 입력 방법: 통합 시스템의 생성자 정보를 사용합니다. 수정 시 기존 creator는 일반적으로 서버가 유지합니다. |
|
| extend.extra.creator.name | json | 표시 이름이며, 생략할 수 있습니다. 예시: 외부 티켓 생성자획득 또는 입력 방법: 외부 시스템의 표시 이름을 사용합니다. |
|
| extend.extra.creator.email | json | 표시 이메일이며, 생략할 수 있습니다. 예시: xxx@guance.com획득 또는 입력 방법: 외부 시스템의 이메일을 사용하며, 예시는 가상 주소입니다. |
|
| extend.extra.updator | json | 업데이터 표시 객체입니다. 예시: {"name": "외부 티켓 업데이터", "email": "xxx@guance.com"}획득 또는 입력 방법: 수정 시 통합 시스템의 이번 작업자 정보를 사용합니다. |
|
| extend.extra.updator.name | json | 표시 이름이며, 생략할 수 있습니다. 예시: 외부 티켓 업데이터획득 또는 입력 방법: 외부 시스템의 표시 이름을 사용합니다. |
|
| extend.extra.updator.email | json | 표시 이메일이며, 생략할 수 있습니다. 예시: xxx@guance.com획득 또는 입력 방법: 외부 시스템의 이메일을 사용합니다. |
|
| extend.manager | array | 담당자 식별자 배열입니다. 담당자가 없으면 []를 전달하거나 생략합니다. 수정 시에는 전체 대상 배열을 전달합니다. 유효하지 않은 계정/팀/알림 대상은 필터링될 수 있습니다. dutyPerson은 워크스페이스 시간대 기준 당일 온콜 캘린더로 구체적인 대상으로 해석되며, 당일 HH:MM 시간대를 기준으로 판단하지 않습니다. 이번 저장 이후에는 이후 교대에 따라 자동으로 변경되지 않습니다. 예시: ["acnt_example"]획득 또는 입력 방법: 대상 워크스페이스의 멤버 관리에서 acnt_ 계정 UUID, 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상 UUID는 알림 대상 목록에서 가져옵니다. 실제 이메일 또는 dutyPerson을 입력할 수도 있습니다. |
|
| extend.manager[*] | json | 계정 UUID, 팀 UUID, 알림 대상 UUID, 이메일 또는 dutyPerson입니다. 예시: acnt_example획득 또는 입력 방법: 대상 워크스페이스의 멤버 관리에서 acnt_ 계정 UUID, 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상 UUID는 알림 대상 목록에서 가져옵니다. 실제 이메일 또는 dutyPerson을 입력할 수도 있습니다. |
|
| extend.linkList | array | 참조 링크 배열로, 클라이언트 필요에 따라 저장됩니다. 예시: [{"name": "처리 매뉴얼", "link": "https://example.com/runbook"}]획득 또는 입력 방법: 비즈니스 담당자가 접근 가능한 참조 링크를 제공합니다. 생략하면 추가하지 않습니다. |
|
| extend.linkList[*] | json | 링크 객체입니다. 예시: {"name": "처리 매뉴얼", "link": "https://example.com/runbook"}획득 또는 입력 방법: 각 항목은 하나의 참조 링크를 나타냅니다. |
|
| extend.linkList[*].name | json | 링크 이름입니다. 예시: 처리 매뉴얼획득 또는 입력 방법: 링크 표시 이름을 입력합니다. |
|
| extend.linkList[*].link | json | 링크 주소입니다. 예시: https://example.com/runbook획득 또는 입력 방법: 접근 가능한 전체 URL을 입력합니다. 예시 도메인은 교체해야 합니다. |
|
| extend.sourceLink | json | 선택적 소스 링크입니다. viewer 단일 데이터 분석 시 doc_time을 기준으로 레코드를 포함하는 조회 구간을 결정할 수 있습니다. 예시: https://example.com/source?doc_time=1785430800000획득 또는 입력 방법: 콘솔 소스 페이지에서 전체 링크를 가져옵니다. viewer 소스의 doc_time은 Unix 밀리초를 사용합니다. |
|
| extend.extra.managerInfos | json | 이메일 담당자 표시 정보 매핑이며, 생략할 수 있습니다. 예시: {"xxx@guance.com": {"name": "외부 온콜 담당자"}}획득 또는 입력 방법: extend.manager의 이메일을 키로 하여 외부 담당자의 표시 정보를 입력합니다. |
|
| extend.extra.managerInfos.邮箱.name | json | 단일 이메일 담당자의 표시 이름입니다. 예시: 외부 온콜 담당자획득 또는 입력 방법: 이메일 키는 담당자 배열의 이메일과 일치해야 하며, 이름은 외부 비즈니스 시스템에서 가져옵니다. |
|
| channelUUIDs[*] | json | 단일 채널 UUID입니다. 예시: chan_example획득 또는 입력 방법: 채널 목록의 content[].uuid에서 가져옵니다. |
|
| attachmentUuids | array | 첨부 파일 UUID 배열입니다. 생성 시 첨부 파일을 바인딩하며, []로 기존 첨부 파일을 삭제할 수 없습니다. null 허용: True 예시: []획득 또는 입력 방법: 먼저 첨부 파일 업로드를 호출하고 content.attachmentUuid를 저장합니다. 해당 워크스페이스에서 실제로 업로드되어 사용 가능한 첨부 파일만 사용할 수 있습니다. 생략하거나 []이면 첨부 파일을 추가하지 않습니다. |
|
| channelUUIDs | array | 생성 시 전송할 채널 배열입니다. 항상 기본 채널을 포함하며, 유효하지 않은 채널은 무시됩니다. null 허용: True 예시: ["chan_example"]획득 또는 입력 방법: 채널 목록에서 같은 워크스페이스의 유효한 채널 UUID를 가져옵니다. 생략하거나 []이면 기본 채널 및 extend에서 참조한 채널만 유지됩니다. |
|
| description | string | Y | Issue 설명으로 생성 시 필수입니다. extend.text의 순수 텍스트 길이 검사와 구분됩니다. null 허용: False 예시: 프로덕션 API 지연 원인을 파악하고 처리 과정을 기록합니다.획득 또는 입력 방법: 현상, 범위, 처리 목표를 작성합니다. 상세 진단 자료는 첨부 파일로 업로드할 수 있습니다. |
| extend | json | Y | 필수 확장 객체로, 내용이 없으면 {}를 전달하고 null을 전달하지 마세요. null 허용: True 예시: {}획득 또는 입력 방법: 확장 내용이 없으면 {}를 전달합니다. 수정 전에 먼저 원래 값을 읽고, 전체 객체에서 변경할 필드를 조정합니다. |
| level | string | Y | 현재 유효한 레벨 UUID로 생성 시 필수이며, 빈 문자열을 전달할 수 있습니다. 레벨 표시 이름으로 UUID를 추측하지 마세요. 빈 문자열 허용: True null 허용: False 예시: system_level_1획득 또는 입력 방법: 먼저 유효 레벨 목록을 호출하여 실제 반환된 uuid를 사용합니다. 레벨을 지정하지 않으면 빈 문자열을 전달합니다. |
| name | string | Y | Issue 제목이며 최대 256자입니다. null 허용: False 최대 길이: 256 예시: checkout-api 지연 이상획득 또는 입력 방법: 문제 현상에 따라 명확한 제목을 작성합니다. |
| resource | string | 소스 모듈/표시 이름이며, 생략하면 빈 문자열입니다. 빈 문자열 허용: True null 허용: False 예시: TRACING획득 또는 입력 방법: 실제 소스 페이지에서 모듈 값 또는 소스 이름을 가져옵니다. 탐색기에서는 주로 LOG, TRACING, EVENTS, RUM을 사용합니다. 일반 수동 Issue에서는 생략합니다. |
|
| resourceType | string | 소스 유형으로, event, dashboard, viewer를 선택할 수 있습니다. 생성 후 이 모듈의 수정 API에서는 소스 변경을 제공하지 않습니다. null 허용: False 선택 가능한 값: ['event', 'dashboard', 'viewer'] 예시: viewer획득 또는 입력 방법: 실제로 이벤트, 대시보드 또는 탐색기에서 발생한 경우에만 event/dashboard/viewer를 선택합니다. 일반 수동 Issue에서는 생략합니다. |
|
| resourceUUID | string | 대응하는 소스 식별자이며, 생략하면 빈 문자열입니다. viewer 값을 일괄적으로 dashboard UUID로 간주하지 마세요. 빈 문자열 허용: True null 허용: False 예시: DOC-EXAMPLE획득 또는 입력 방법: 이벤트 소스는 이벤트 __docid, 대시보드는 dashboard UUID, viewer 단일 데이터는 __docid를 입력하며, 전체 탐색기는 빈 문자열을 전달할 수 있습니다. |
파라미터 추가 설명¶
첨부 파일은 먼저 첨부 파일 업로드를 호출한 뒤 attachmentUuid를 attachmentUuids에 입력합니다. 존재하지 않거나 사용할 수 없는 첨부 파일은 내부 오류를 유발할 수 있으므로 확인 후 바인딩하세요. extend.channels/members의 exists는 표시 필드이며 권한 부여 근거가 아닙니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/issue/add' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"checkout-api 지연 이상","level":"system_level_1","description":"프로덕션 API 지연 원인을 파악하고 처리 과정을 기록합니다.","extend":{}}'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| content.id | integer 또는 null | 레코드 번호입니다. Issue/응답 생성 응답이 영속화 전에 구성되는 경우 null일 수 있으며, 리소스 작업에는 uuid를 사용하세요. |
| content.uuid | string | 리소스 UUID입니다. |
| content.workspaceUUID | string | 소속 워크스페이스 UUID입니다. |
| content.status | integer | 레코드 상태입니다. 0은 정상, 3은 삭제됨입니다. Issue 비즈니스 상태인 statusType과 구분합니다. |
| content.creator | string | 생성 호출 신원으로, API Key 식별자, 계정 또는 시스템 신원일 수 있습니다. |
| content.updator | string | 최근 갱신 신원이며, 설정되지 않은 경우 빈 문자열입니다. |
| content.createAt | integer | 생성 시간, Unix 초입니다. |
| content.updateAt | integer | 최근 갱신 시간, Unix 초입니다. 갱신되지 않은 경우 -1일 수 있습니다. |
| content.deleteAt | integer | 삭제 시간, Unix 초입니다. 삭제되지 않은 경우 -1입니다. |
| content.name | string | Issue 제목입니다. |
| content.level | string | 레벨 UUID이며, 빈 문자열은 미지정을 의미합니다. 레벨 이름이 아닙니다. |
| content.statusType | integer | 상태: 10 Open, 15 Working, 20 Resolved, 25 Closed, 30 Pending. |
| content.statusTypeUpdateRecord | array<string> |
상태 변경 이력으로, 각 항목은 Unix초&&상태 이름 형식입니다. |
| content.statusTypeUpdateRecord[] | string | 단일 상태 변경 기록입니다. |
| content.description | string | Issue 설명입니다. |
| content.resourceType | string | 소스 유형으로 event, dashboard, viewer 등이며, 자동 생성인 경우 checker, keyeventAutoDiscovery 등일 수 있습니다. |
| content.resourceUUID | string | 연결된 소스 식별자이며, 구체적인 의미는 소스 유형에 따라 달라집니다. |
| content.resource | string | 소스 모듈 또는 이름이며, 예: LOG, TRACING, EVENTS, RUM. |
| content.repeatType | string | 자동 발견 문제의 반복 유형으로 new, repeat, regression일 수 있으며, 수동 생성 시 비어 있을 수 있습니다. |
| content.subIdentify | string | 소스에서 정의한 연결 하위 식별자이며, 수동 생성 시 일반적으로 비어 있습니다. |
| content.resolveAt | integer | 최근 Resolved 또는 Closed로 설정된 시간(Unix 초)입니다. 복구된 적이 없으면 -1입니다. 다시 열어도 이 이력 시간은 자동으로 지워지지 않습니다. |
| content.eventCount | integer | 기록된 연결 이벤트 수입니다. |
| content.eventCountUpdateAt | integer | 연결 이벤트 수 최근 갱신 시간(Unix 초)이며, 아직 기록되지 않은 경우 -1입니다. |
| content.triggerRecord | object | 이전 버전 호환 필드이며, 더 이상 알림 트리거 제어 파라미터로 사용되지 않습니다. |
| content.extend | object | 확장 내용입니다. 요청 시 객체 {}를 전달하고 null을 전달하지 마세요. 멤버, 채널, 담당자 등의 구조는 파라미터 표를 참고하세요. |
| content.extend.text | string | 길이 검사에 사용되는 순수 텍스트이며 최대 3000자입니다. |
| content.extend.channels | array<object> |
설명에서 참조한 채널로 uuid, name, type, exists를 포함합니다. 반환 시 exists는 현재 리소스 존재 여부에 따라 갱신됩니다. |
| content.extend.channels[].uuid | string | 채널 UUID입니다. |
| content.extend.channels[].name | string 또는 null | 표시 이름입니다. |
| content.extend.channels[].type | string | 채널 참조 표시자 #입니다. |
| content.extend.channels[].exists | boolean | 반환 시 해당 채널의 존재 여부입니다. |
| content.extend.members | array<object> |
설명에서 @한 멤버 참조로 uuid, name, type, exists를 포함합니다. |
| content.extend.members[].uuid | string | 멤버 계정 UUID입니다. |
| content.extend.members[].name | string 또는 null | 표시 이름입니다. |
| content.extend.members[].type | string | 멤버 참조 표시자 @입니다. |
| content.extend.members[].exists | boolean | 반환 시 해당 계정의 존재 여부입니다. |
| content.extend.manager | array<string> |
담당자 식별자 배열로 Issue에서만 사용됩니다. 멤버/팀/알림 대상/이메일 등은 유효성에 따라 정규화됩니다. |
| content.extend.manager[] | string | 단일 담당자 식별자입니다. |
| content.extend.linkList | array<object> |
비즈니스 참조 링크입니다. |
| content.extend.linkList[].name | string | 링크 표시 이름입니다. |
| content.extend.linkList[].link | string | 비즈니스 URL입니다. |
| content.extend.sourceLink | string | 소스 페이지 링크이며, 존재하는 경우 클라이언트가 입력합니다. |
| content.extend.extra | object | 서드파티 연동 표시 정보로, API의 실제 인증 신원을 변경하지 않습니다. |
| content.extend.extra.creator | object | 서드파티 생성자 표시 정보로 name, email을 포함할 수 있습니다. |
| content.extend.extra.creator.name | string | 생성자 표시 이름입니다. |
| content.extend.extra.creator.email | string | 생성자 표시 이메일입니다. |
| content.extend.extra.updator | object | 서드파티 업데이터 표시 정보로 name, email을 포함할 수 있습니다. |
| content.extend.extra.updator.name | string | 업데이터 표시 이름입니다. |
| content.extend.extra.updator.email | string | 업데이터 표시 이메일입니다. |
| content.extend.extra.managerInfos | object | 담당자 이메일을 키로 하는 표시 정보 매핑이며 Issue에서만 사용됩니다. |
| content.extend.extra.managerInfos.邮箱.name | string | 해당 이메일 담당자의 표시 이름입니다. |
| content.extend.其他字段 | JSON | 클라이언트가 저장한 기타 확장 정보입니다. 모두 비즈니스 동작을 트리거한다는 의미는 아닙니다. |
| content.declaration | object 또는 null | 워크스페이스 공통 선언이며, content의 이 계층에만 추가됩니다. |
{
"code": 200,
"content": {
"id": null,
"uuid": "issue_example",
"workspaceUUID": "wksp_example",
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785430800,
"updateAt": 1785430800,
"deleteAt": -1,
"name": "checkout-api 지연 이상",
"level": "system_level_1",
"statusType": 10,
"statusTypeUpdateRecord": [],
"description": "프로덕션 API 지연 원인을 파악하고 처리 과정을 기록합니다.",
"resourceType": "",
"resourceUUID": "",
"resource": "",
"repeatType": "",
"subIdentify": "",
"extend": {},
"resolveAt": -1,
"eventCount": 0,
"eventCountUpdateAt": -1,
"triggerRecord": {},
"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 파일 형식 오류 | JSON 객체를 제출합니다. |
| 406 | ft.IssueLevelNotExists | level이 현재 워크스페이스의 유효 레벨 집합에 속하지 않음 | 레벨 설정이 존재하지 않음 | 먼저 유효 레벨 목록을 조회하여 반환된 uuid를 사용합니다. 레벨을 설정하지 않으려면 파라미터 설명에 따라 빈 문자열을 전달할 수 있습니다. |
| 406 | ft.ExceedMaxLengthLimit | extend.text의 길이가 3000자를 초과함 | 텍스트 최대 길이 제한 초과 | 순수 텍스트 필드를 줄이고, 대용량 진단 자료는 첨부 파일로 업로드합니다. |
| 400 | ft.UnsupportFreeIssueManager | 제한된 워크스페이스 버전에서 해당 워크스페이스 멤버가 아닌 외부 이메일을 담당자로 사용함 | 무료 플랜 워크스페이스에서는 인시던트 담당자를 외부 이메일로 지정할 수 없습니다 | 워크스페이스 멤버를 선택하거나 해당 버전이 외부 이메일 담당자를 지원하는지 확인합니다. |
| 404 | ft.NotFoundChannel | 현재 워크스페이스에 사용 가능한 기본 채널이 없음 | 지정된 채널을 찾을 수 없음 | 콘솔에서 채널 설정을 확인하고 기본 채널을 복구한 후 재시도합니다. |
| 500 | ft.InternalServerError | 레벨 또는 설정 저장, 감사 또는 기타 내부 처리 실패 | 내부 오류 | 먼저 현재 레벨 또는 설정을 읽어 결과를 확인한 후 재시도 여부를 결정합니다. 지속적으로 실패하면 traceId를 제공하세요. |
| 503 | ft.QueryServiceUnavailable | viewer 단일 소스 조회 시 업스트림 조회 서비스가 503을 반환함 | 조회 서비스가 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도하세요 | content.retryable이 true이면 백오프 후 재시도합니다. Issue가 이미 생성되었는지 먼저 조회하여 중복을 방지하세요. |
| 406 | ft.KodoRequestDeadlineExceeded | viewer 소스의 데이터 조회 타임아웃 | 데이터 조회 시간이 초과되었습니다. 원인은 다음과 같을 수 있습니다: 데이터 양이 너무 많음, 네트워크 지연, 서버 부하 과다. 다음과 같은 방법으로 문제를 해결할 수 있습니다: 1. 필터 조건을 추가하거나 시간 범위를 좁힌 후 다시 조회합니다. 2. 잠시 기다린 후 다시 조회를 시도합니다. |
소스 레코드와 sourceLink의 doc_time을 확인한 후 재시도합니다. 지속적으로 실패하면 traceId를 제공하세요. |
| 406 | ft.KodoTooManyRows | viewer 소스의 데이터 조회량 초과 | 조회 데이터 양이 최대 한도를 초과했습니다. 필터 조건을 추가하거나 시간 범위를 줄인 후 다시 조회하세요. | 단일 소스의 resourceUUID와 doc_time을 확인하여 불필요한 데이터 매칭을 줄입니다. |
| 429 | ft.KodoServerOverloaded | viewer 소스 데이터 조회 서비스 과부하 | 현재 요청이 너무 많습니다. 잠시 후 다시 시도하세요. | 백오프 후 재시도하되, Issue가 이미 생성되었는지 먼저 확인합니다. |