콘텐츠로 이동

생성



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가 이미 생성되었는지 먼저 확인합니다.

문서 평가

이 페이지가 도움이 되었나요?