REST Resource: projects.locations.investigations

리소스: Investigation

Gemini Cloud Assist 문제 해결 조사의 콘텐츠를 보유합니다.

JSON 표현
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "revision": string,
  "revisionIndex": integer,
  "revisionPredecessor": string,
  "annotations": {
    object (InvestigationAnnotations)
  },
  "executionState": enum (InvestigationExecutionState),
  "error": {
    object (Status)
  },
  "operation": string,
  "title": string,
  "observations": {
    string: {
      object (Observation)
    },
    ...
  },
  "observerStatuses": {
    string: {
      object (ObserverStatus)
    },
    ...
  }
}
필드
name

string

식별자. 조사의 이름입니다. 형식: projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}

createTime

string (Timestamp format)

출력 전용입니다. 조사가 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 조사가 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

labels

map (key: string, value: string)

선택사항입니다. 조사에 대한 사용자 정의 라벨입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

revision

string

출력 전용입니다. 조사의 현재 버전의 리소스 이름으로, projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}/revisions/{revision_id} 형식입니다.

revisionIndex

integer

출력 전용입니다. 조사의 현재 버전의 색인입니다.

revisionPredecessor

string

선택사항입니다. 이 버전의 이전 버전인 버전의 이름입니다.

annotations

object (InvestigationAnnotations)

선택사항입니다. 조사에 대한 추가 주석입니다.

executionState

enum (InvestigationExecutionState)

출력 전용입니다. 조사의 실행 상태입니다.

error

object (Status)

출력 전용입니다. 조사 실행이 실패한 경우의 오류입니다. 이 필드는 executionStateINVESTIGATION_EXECUTION_STATE_FAILED인 경우에만 설정됩니다.

operation

string

출력 전용입니다. 조사에서 가장 최근에 실행된 실행 작업의 리소스 이름입니다. 형식은 projects/{projectNumber}/locations/{locationId}/operations/{operation_id}입니다.

title

string

선택사항입니다. 조사에 대한 사람이 읽을 수 있는 표시 제목입니다.

observations

map (key: string, value: object (Observation))

선택사항입니다. 조사 내용을 구성하는 프로젝트 상태에 관한 관찰입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

observerStatuses

map (key: string, value: object (ObserverStatus))

선택사항입니다. 조사를 실행하기 위해 호출된 관찰자의 상태입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

InvestigationAnnotations

조사에 대한 추가 주석입니다.

JSON 표현
{
  "supportCase": string,
  "revisionLastRunInterval": {
    object (Interval)
  },
  "pagePath": string,
  "extrasMap": {
    string: string,
    ...
  }
}
필드
supportCase

string

선택사항입니다. 조사와 연결된 지원 케이스 ID입니다.

revisionLastRunInterval

object (Interval)

출력 전용입니다. 조사가 마지막으로 실행된 간격입니다.

pagePath

string

선택사항입니다. 이 조사가 생성된 웹페이지의 경로입니다.

extrasMap

map (key: string, value: string)

선택사항입니다. 클라이언트에서 지정한 추가 주석입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

간격

타임스탬프 시작 (포함) 및 타임스탬프 종료 (제외)로 인코딩된 시간 간격을 나타냅니다.

시작은 종료보다 작거나 같아야 합니다. 시작이 종료와 같으면 간격이 비어 있습니다 (시간과 일치하지 않음). 시작과 종료가 모두 지정되지 않은 경우 간격은 모든 시간과 일치합니다.

JSON 표현
{
  "startTime": string,
  "endTime": string
}
필드
startTime

string (Timestamp format)

선택사항입니다. 간격의 시작(포함)입니다.

지정된 경우 이 간격과 일치하는 타임스탬프는 시작과 같거나 시작 이후여야 합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

endTime

string (Timestamp format)

선택사항입니다. 시작과 끝 값을 제외한 간격의 끝입니다.

지정된 경우 이 간격과 일치하는 타임스탬프는 종료 시간 이전이어야 합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

InvestigationExecutionState

조사의 실행 상태입니다.

열거형
INVESTIGATION_EXECUTION_STATE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
INVESTIGATION_EXECUTION_STATE_RUNNING 조사가 실행되고 있습니다.
INVESTIGATION_EXECUTION_STATE_MODIFIED 마지막 업데이트 이후 조사가 아직 실행되지 않았습니다.
INVESTIGATION_EXECUTION_STATE_FAILED 조사 실행이 완료되었지만 실행에 실패했습니다.
INVESTIGATION_EXECUTION_STATE_COMPLETED 모든 실행 작업이 완료되었으며 조사가 중단되었습니다.

관찰

관측값은 조사 중인 시스템의 상태에 관한 단일 사실과 관련성 순위를 나타냅니다.

JSON 표현
{
  "id": string,
  "timeIntervals": [
    {
      object (Interval)
    }
  ],
  "title": string,
  "observationType": enum (ObservationType),
  "observerType": enum (ObserverType),
  "text": string,
  "data": {
    object
  },
  "dataUrls": {
    string: string,
    ...
  },
  "knowledgeUrls": {
    string: string,
    ...
  },
  "baseObservations": [
    string
  ],
  "relevantResources": [
    string
  ],
  "recommendation": string,
  "systemRelevanceScore": number,
  "relevanceOverride": enum (UserRelevance),
  "observationCompletionState": enum (ObservationCompletionState),
  "observedNormalOperation": boolean
}
필드
id

string

출력 전용입니다. 이 관측치를 고유하게 식별합니다. 이는 항상 상위 조사에서 이 관측치의 지도 키와 같습니다.

timeIntervals[]

object (Interval)

선택사항입니다. 이 관찰이 발생한 시간입니다.

title

string

선택사항입니다. 관측의 사람이 읽을 수 있는 표시 제목입니다.

observationType

enum (ObservationType)

필수 항목입니다. 관찰 유형입니다.

observerType

enum (ObserverType)

필수 항목입니다. 이 관측을 생성한 관측자의 유형입니다.

text

string

선택사항입니다. 관찰을 설명하는 자연어 또는 마크다운 텍스트입니다.

data

object (Struct format)

선택사항입니다. 관찰의 구조화된 표현입니다. 특정 스키마를 준수할 필요도 없고 준수한다고 보장하지도 않습니다.

dataUrls

map (key: string, value: string)

선택사항입니다. 이 관찰 결과를 뒷받침하는 증거를 가리키는 URL입니다. 사람이 읽을 수 있는 설명에서 URL로 매핑합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

knowledgeUrls

map (key: string, value: string)

선택사항입니다. 이 관찰과 관련된 참조 지식을 가리키는 URL입니다. 사람이 읽을 수 있는 설명에서 URL로 매핑합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

baseObservations[]

string

선택사항입니다. 이 관측값이 기반으로 하는 다른 관측값의 ID입니다. 예를 들어 가설 관찰에는 해당 가설을 뒷받침하는 관찰이 기록됩니다.

relevantResources[]

string

선택사항입니다. 관찰과 관련된 Google Cloud 리소스입니다. 정규화된 리소스 URI여야 합니다(예: '//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance'

recommendation

string

선택사항입니다. 근본 원인을 해결하거나 문제를 추가로 조사하기 위한 권장 조치를 설명하는 자연어 또는 마크다운 텍스트입니다.

systemRelevanceScore

number

선택사항입니다. 관찰자가 이 관찰이 얼마나 관련성이 있다고 인식하는지입니다. 이는 가설을 생성할 때 관찰의 순위를 지정하는 데 사용됩니다. 시스템은 [-1, 1] 범위의 관측치를 출력합니다. 여기서 -1은 완전히 관련성이 없음을, 0은 중립을, 1은 관련성에 대한 완전한 신뢰를 의미합니다.

relevanceOverride

enum (UserRelevance)

선택사항입니다. 사용자의 관련성 판단입니다.

observationCompletionState

enum (ObservationCompletionState)

선택사항입니다. 관찰이 완전히 형성되어 결론을 도출하는 데 사용할 수 있는지를 나타냅니다.

observedNormalOperation

boolean

선택사항입니다. false이거나 지정되지 않은 경우 이 관찰은 문제 또는 근본 원인에 관한 정보를 제공합니다. true인 경우 이 관찰 결과는 시스템이 정상적으로 작동하는 것으로 관찰되었음을 나타냅니다. 이러한 부정적인 결과는 유용한 진단 결과가 될 수 있으며, 이 필드는 관련성 점수와 상관관계가 없습니다.

ObservationType

관측을 구성하는 데이터의 유형을 나타냅니다. 이는 출처와 무관합니다. 로그는 사용자가 명시적으로 제공하거나, AI를 통해 추출하거나, 런북에서 발견할 수 있습니다.

열거형
OBSERVATION_TYPE_UNSPECIFIED 기본값
OBSERVATION_TYPE_CLOUD_LOG 이 관찰의 텍스트는 로그 항목입니다.
OBSERVATION_TYPE_CLOUD_METRIC 이 관측의 콘텐츠는 측정항목 또는 측정항목 그룹입니다.
OBSERVATION_TYPE_CAIS_CONFIG 구성
OBSERVATION_TYPE_CAIS_CONFIG_DIFF 구성 변경
OBSERVATION_TYPE_CLOUD_ALERT 알림
OBSERVATION_TYPE_CICD_EVENT 지속적 통합 시스템의 이벤트입니다(예: 프로브 실패).
OBSERVATION_TYPE_TEXT_DESCRIPTION 초기 사용자 입력과 같은 자유 텍스트 입력입니다. 마크다운일 수 있습니다.
OBSERVATION_TYPE_HYPOTHESIS 시스템에서 도출한 [잠정] 결론입니다. 이는 후속 수정의 입력이 될 수 있습니다. 이 경우 권장사항은 사용되지만 수정은 사용되지 않습니다.
OBSERVATION_TYPE_STRUCTURED_INPUT 구조화된 입력(예: 양식에 입력된 런북 매개변수)
OBSERVATION_TYPE_COMPOSITE 런북 출력과 같이 두 가지 이상의 증거가 포함된 관찰에 사용됩니다.
OBSERVATION_TYPE_OTHER 다른 유형이 적용되지 않는 경우 런북 출력은 '기타'일 수 있습니다.
OBSERVATION_TYPE_LOG_THEME 로그에서 발견된 테마입니다.
OBSERVATION_TYPE_CONFIG_ANALYSIS LLM에서 분석한 구성을 포함하는 신호 출력입니다.
OBSERVATION_TYPE_OUTAGE PSH의 서비스 중단이 포함된 신호 출력
OBSERVATION_TYPE_KNOWLEDGE 특정 사용자의 문제에 관한 정보를 제공하는 텍스트입니다. 예를 들어 오류 카탈로그 안내/외부 링크, RAG 등이 있습니다.

ObserverType

데이터가 조사에 포함된 방식을 나타냅니다.

열거형
OBSERVER_TYPE_UNSPECIFIED 기본값 사용되지 않습니다.
OBSERVER_TYPE_DIAGNOSTICS 진단에는 런북을 통해 근본 원인이라는 명시적 개념이 있습니다.
OBSERVER_TYPE_SIGNALS 신호는 명시적인 근본 원인이 없는 처리를 위한 것입니다.
OBSERVER_TYPE_DETERMINISTIC_CODE 이는 온프레미스에만 종속된 코드에 해당합니다. 특히 오류 카탈로그 조회를 확인합니다.
OBSERVER_TYPE_AI 전제로 나열된 관찰에만 의존하는 AI 추론에 해당합니다.
OBSERVER_TYPE_USER 설명에 대한 답변을 포함한 사용자 입력 관찰 모든 사용자 지정 관측치는 이 유형으로 강제 변환됩니다.
OBSERVER_TYPE_ALERT 알림의 관찰입니다.

UserRelevance

이는 관찰에 대한 사용자의 표현된 관련성 판단을 나타냅니다.

열거형
USER_RELEVANCE_UNSPECIFIED 사용자가 이 관찰을 관련 또는 관련 없음으로 표시하지 않았습니다.
USER_RELEVANCE_PROMOTED 사용자가 이 관찰을 관련성이 있다고 표시했습니다.
USER_RELEVANCE_REJECTED 사용자가 이 관찰을 관련성이 없는 것으로 표시했습니다.

ObservationCompletionState

관찰이 완전히 형성되고 완료되었는지 여부를 확인합니다.

열거형
OBSERVATION_COMPLETION_STATE_UNSPECIFIED 기본값 COMPLETE로 처리됩니다.
OBSERVATION_COMPLETION_STATE_COMPLETE 이 관측치는 완전히 형성되었습니다.
OBSERVATION_COMPLETION_STATE_INCOMPLETE 이 관찰 기록에 일부 정보가 누락되었거나 다른 관찰자의 추가 처리가 필요합니다. 이러한 유형의 관찰은 향후 조사 실행에서 삭제될 수 있습니다.

ObserverStatus

ObserverStatus는 조사 실행 중 특정 시점의 관찰자 상태를 나타냅니다.

JSON 표현
{
  "observer": string,
  "observerExecutionState": enum (ObserverExecution),
  "observerDisplayName": string,
  "updateTime": string,
  "startTime": string,
  "updateComment": string,
  "observerErrors": [
    {
      object (Status)
    }
  ]
}
필드
observer

string

출력 전용입니다. 이 관찰자를 고유하게 식별합니다. 이는 항상 상위 조사에서 이 관찰자의 지도 키와 같습니다.

observerExecutionState

enum (ObserverExecution)

선택사항입니다. 관찰자의 현재 실행 상태입니다.

observerDisplayName

string

필수 항목입니다. 관찰자의 사람이 읽을 수 있는 표시 이름입니다.

updateTime

string (Timestamp format)

선택사항입니다. 관찰자가 조사를 마지막으로 업데이트한 시간입니다. observerExecutionState가 COMPLETE 또는 FAILED인 경우 관찰자가 관찰을 완료한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

startTime

string (Timestamp format)

선택사항입니다. 관찰자가 관찰을 시작한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateComment

string

선택사항입니다. 관찰자의 상태 업데이트입니다.

observerErrors[]

object (Status)

선택사항입니다. 관찰자가 특정 관찰을 하지 못하도록 차단한 오류입니다.

ObserverExecution

관찰자의 상태입니다.

열거형
OBSERVER_EXECUTION_UNSPECIFIED 관찰자 상태가 지정되지 않았습니다.
OBSERVER_EXECUTION_NOT_STARTED 조사가 아직 시작되지 않았습니다.
OBSERVER_EXECUTION_RUNNING 조사가 실행 중이고 이 관찰자가 실행 가능하거나 실행 중입니다.
OBSERVER_EXECUTION_COMPLETE 관찰자가 내부 오류 없이 완료되었습니다.
OBSERVER_EXECUTION_FAILED 관찰자가 실행을 시도했지만 오류로 인해 실패했습니다. 이는 구성요소에 따라 다르며 관찰이 표시되는 경우 우선순위가 매우 낮은 것으로 UI에 렌더링될 수 있습니다.
OBSERVER_EXECUTION_BLOCKED 관찰자가 입력을 기다리며 차단됩니다.
OBSERVER_EXECUTION_INVESTIGATION_BLOCKED 관찰자가 조사에 차단되거나 심각한 영향을 미치는 오류를 보고합니다(예: CAIS 또는 로깅이 사용 중지됨). UI에 눈에 띄게 렌더링되어야 합니다.
OBSERVER_EXECUTION_INVESTIGATION_DEGRADED 관찰자는 조사를 저하시키는 오류를 보고하며, 원인을 완화한 후 사용자가 에스컬레이션하거나 조사를 다시 실행해야 할 수 있습니다.

메서드

create

특정 프로젝트에 새 조사를 만듭니다.

delete

단일 조사를 삭제합니다.

get

단일 조사의 세부정보를 가져옵니다.

getIamPolicy

리소스의 액세스 제어 정책을 가져옵니다.

list

특정 프로젝트와 위치의 조사를 나열합니다.

patch

단일 조사의 파라미터를 업데이트합니다.

setIamPolicy

지정된 리소스의 액세스 제어 정책을 설정합니다.

testIamPermissions

지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.