리소스: Investigation
Gemini Cloud Assist 문제 해결 조사의 콘텐츠를 보유합니다.
JSON 표현 |
---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "revision": string, "revisionIndex": integer, "revisionPredecessor": string, "annotations": { object ( |
필드 | |
---|---|
name |
식별자. 조사의 이름입니다. 형식: projects/{projectNumber}/locations/{locationId}/investigations/{investigationId} |
createTime |
출력 전용입니다. 조사가 생성된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
updateTime |
출력 전용입니다. 조사가 마지막으로 업데이트된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
labels |
선택사항입니다. 조사에 대한 사용자 정의 라벨입니다.
|
revision |
출력 전용입니다. 조사의 현재 버전의 리소스 이름으로, projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}/revisions/{revision_id} 형식입니다. |
revisionIndex |
출력 전용입니다. 조사의 현재 버전의 색인입니다. |
revisionPredecessor |
선택사항입니다. 이 버전의 이전 버전인 버전의 이름입니다. |
annotations |
선택사항입니다. 조사에 대한 추가 주석입니다. |
executionState |
출력 전용입니다. 조사의 실행 상태입니다. |
error |
출력 전용입니다. 조사 실행이 실패한 경우의 오류입니다. 이 필드는 |
operation |
출력 전용입니다. 조사에서 가장 최근에 실행된 실행 작업의 리소스 이름입니다. 형식은 projects/{projectNumber}/locations/{locationId}/operations/{operation_id}입니다. |
title |
선택사항입니다. 조사에 대한 사람이 읽을 수 있는 표시 제목입니다. |
observations |
선택사항입니다. 조사 내용을 구성하는 프로젝트 상태에 관한 관찰입니다.
|
observerStatuses |
선택사항입니다. 조사를 실행하기 위해 호출된 관찰자의 상태입니다.
|
InvestigationAnnotations
조사에 대한 추가 주석입니다.
JSON 표현 |
---|
{
"supportCase": string,
"revisionLastRunInterval": {
object ( |
필드 | |
---|---|
supportCase |
선택사항입니다. 조사와 연결된 지원 케이스 ID입니다. |
revisionLastRunInterval |
출력 전용입니다. 조사가 마지막으로 실행된 간격입니다. |
pagePath |
선택사항입니다. 이 조사가 생성된 웹페이지의 경로입니다. |
extrasMap |
선택사항입니다. 클라이언트에서 지정한 추가 주석입니다.
|
간격
타임스탬프 시작 (포함) 및 타임스탬프 종료 (제외)로 인코딩된 시간 간격을 나타냅니다.
시작은 종료보다 작거나 같아야 합니다. 시작이 종료와 같으면 간격이 비어 있습니다 (시간과 일치하지 않음). 시작과 종료가 모두 지정되지 않은 경우 간격은 모든 시간과 일치합니다.
JSON 표현 |
---|
{ "startTime": string, "endTime": string } |
필드 | |
---|---|
startTime |
선택사항입니다. 간격의 시작(포함)입니다. 지정된 경우 이 간격과 일치하는 타임스탬프는 시작과 같거나 시작 이후여야 합니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
endTime |
선택사항입니다. 시작과 끝 값을 제외한 간격의 끝입니다. 지정된 경우 이 간격과 일치하는 타임스탬프는 종료 시간 이전이어야 합니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
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 ( |
필드 | |
---|---|
id |
출력 전용입니다. 이 관측치를 고유하게 식별합니다. 이는 항상 상위 조사에서 이 관측치의 지도 키와 같습니다. |
timeIntervals[] |
선택사항입니다. 이 관찰이 발생한 시간입니다. |
title |
선택사항입니다. 관측의 사람이 읽을 수 있는 표시 제목입니다. |
observationType |
필수 항목입니다. 관찰 유형입니다. |
observerType |
필수 항목입니다. 이 관측을 생성한 관측자의 유형입니다. |
text |
선택사항입니다. 관찰을 설명하는 자연어 또는 마크다운 텍스트입니다. |
data |
선택사항입니다. 관찰의 구조화된 표현입니다. 특정 스키마를 준수할 필요도 없고 준수한다고 보장하지도 않습니다. |
dataUrls |
선택사항입니다. 이 관찰 결과를 뒷받침하는 증거를 가리키는 URL입니다. 사람이 읽을 수 있는 설명에서 URL로 매핑합니다.
|
knowledgeUrls |
선택사항입니다. 이 관찰과 관련된 참조 지식을 가리키는 URL입니다. 사람이 읽을 수 있는 설명에서 URL로 매핑합니다.
|
baseObservations[] |
선택사항입니다. 이 관측값이 기반으로 하는 다른 관측값의 ID입니다. 예를 들어 가설 관찰에는 해당 가설을 뒷받침하는 관찰이 기록됩니다. |
relevantResources[] |
선택사항입니다. 관찰과 관련된 Google Cloud 리소스입니다. 정규화된 리소스 URI여야 합니다(예: '//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance' |
recommendation |
선택사항입니다. 근본 원인을 해결하거나 문제를 추가로 조사하기 위한 권장 조치를 설명하는 자연어 또는 마크다운 텍스트입니다. |
systemRelevanceScore |
선택사항입니다. 관찰자가 이 관찰이 얼마나 관련성이 있다고 인식하는지입니다. 이는 가설을 생성할 때 관찰의 순위를 지정하는 데 사용됩니다. 시스템은 [-1, 1] 범위의 관측치를 출력합니다. 여기서 -1은 완전히 관련성이 없음을, 0은 중립을, 1은 관련성에 대한 완전한 신뢰를 의미합니다. |
relevanceOverride |
선택사항입니다. 사용자의 관련성 판단입니다. |
observationCompletionState |
선택사항입니다. 관찰이 완전히 형성되어 결론을 도출하는 데 사용할 수 있는지를 나타냅니다. |
observedNormalOperation |
선택사항입니다. 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_RELATED_RESOURCES |
조사와 관련이 있다고 생각되는 리소스입니다. |
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 ( |
필드 | |
---|---|
observer |
출력 전용입니다. 이 관찰자를 고유하게 식별합니다. 이는 항상 상위 조사에서 이 관찰자의 지도 키와 같습니다. |
observerExecutionState |
선택사항입니다. 관찰자의 현재 실행 상태입니다. |
observerDisplayName |
필수 항목입니다. 관찰자의 사람이 읽을 수 있는 표시 이름입니다. |
updateTime |
선택사항입니다. 관찰자가 조사를 마지막으로 업데이트한 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
startTime |
선택사항입니다. 관찰자가 관찰을 시작한 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
updateComment |
선택사항입니다. 관찰자의 상태 업데이트입니다. |
observerErrors[] |
선택사항입니다. 관찰자가 특정 관찰을 하지 못하도록 차단한 오류입니다. |
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 |
관찰자는 조사를 저하시키는 오류를 보고하며, 원인을 완화한 후 사용자가 에스컬레이션하거나 조사를 다시 실행해야 할 수 있습니다. |
메서드 |
|
---|---|
|
특정 프로젝트에 새 조사를 만듭니다. |
|
단일 조사를 삭제합니다. |
|
단일 조사의 세부정보를 가져옵니다. |
|
리소스의 액세스 제어 정책을 가져옵니다. |
|
특정 프로젝트와 위치의 조사를 나열합니다. |
|
단일 조사의 파라미터를 업데이트합니다. |
|
지정된 리소스의 액세스 제어 정책을 설정합니다. |
|
지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다. |