ObservabilityConfig 커스텀 리소스 정의

사양 스키마

ObservabilityConfigSpec은 ObservabilityConfig의 선택된 상태를 정의합니다.

customMetrics:
  definitions:
  - database: string
    metricGroup: string
    metrics:
    - desc: string
      name: string
      usage: string
    query: string
  resourceLimits:
    maxParallelWorkers: integer
    statementTimeout: string
    workMemory: string
dbClusterRefs:
- string

필드 유형 필수 또는 선택사항	설명
customMetrics
object 필수	맞춤 측정항목 구성을 지정합니다.
customMetrics.definitions
list (object) 필수	맞춤 측정항목 정의 목록입니다.
customMetrics.definitions[].database
string 필수	이 쿼리에 연결할 데이터베이스의 이름입니다.
customMetrics.definitions[].metricGroup
string 필수	관련 측정항목을 그룹화하는 데 사용되는 이름입니다. 최종 측정항목 이름(alloydb_omni_custom_<metricGroup>_<metric_name>)에 사용됩니다.
customMetrics.definitions[].metrics
list (object) 필수	쿼리 결과에서 추출할 측정항목 목록입니다.
customMetrics.definitions[].metrics[].desc
string 필수	측정항목 또는 라벨에 대한 사람이 읽을 수 있는 설명입니다.
customMetrics.definitions[].metrics[].name
string 필수	SQL 쿼리 결과의 열 이름입니다. 이는 Prometheus 측정항목 이름의 일부 또는 라벨 이름으로 사용됩니다.
customMetrics.definitions[].metrics[].usage
string 필수	이 열이 사용되는 방식을 지정합니다. 유효한 값은 'label', 'gauge', 'counter'입니다.
customMetrics.definitions[].query
string 필수	실행할 SQL SELECT 문입니다.
customMetrics.resourceLimits
object 선택사항	ResourceLimits는 맞춤 쿼리 실행을 위한 리소스 한도를 지정합니다.
customMetrics.resourceLimits.maxParallelWorkers
integer 선택사항	쿼리의 최대 병렬 작업자 수를 지정합니다. 이 값을 0으로 설정하면 병렬 쿼리 실행이 사용 중지됩니다.
customMetrics.resourceLimits.statementTimeout
string 선택사항	모든 명령문의 실행에 허용되는 최대 시간을 지정합니다. 예: '2s'
customMetrics.resourceLimits.workMemory
string 선택사항	쿼리 작업에서 사용할 최대 메모리 양을 지정합니다. 예: '4MB'
dbClusterRefs
list (string) 필수	이 ObservabilityConfig의 영향을 받는 DBCluster 인스턴스에 대한 참조 목록입니다.

상태 스키마

ObservabilityConfigStatus는 관찰된 ObservabilityConfig 상태를 정의합니다.

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
observedGeneration: integer
reconciled: boolean

필드 유형 필수 또는 선택사항	설명
conditions[]
object 선택사항	항목의 현재 상태에 대한 사용 가능한 최근 모니터링 결과 목록입니다.
conditions[].lastTransitionTime
string 필수	조건이 특정 상태에서 다른 상태로 전환된 마지막 시간입니다. 이는 기본 조건이 변경된 시점입니다. 이 시간을 알 수 없는 경우에는 API 필드가 변경된 시간을 사용해도 됩니다.
conditions[].message
string 필수	전환을 설명하는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.
conditions[].observedGeneration
integer 선택사항	이 조건의 기준이 되는 .metadata.generation입니다. 예를 들어 .metadata.generation이 12이지만 .status.conditions[x].observedGeneration이 9이면 조건이 오래되어 인스턴스의 현재 상태를 반영하지 않습니다.
conditions[].reason
string 필수	조건의 마지막 전환 이유를 나타내는 프로그래매틱 식별자입니다. 특정 조건 유형의 생산자는 이 필드의 예상 값과 의미, 값이 안정적인 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비워 둘 수 없습니다.
conditions[].status
string 필수	조건 상태 (True, False, Unknown)입니다.
conditions[].type
string 필수	CamelCase 또는 foo.example.com/CamelCase 형식의 조건 유형입니다. 많은 .condition.type 값은 'Available'과 같은 리소스에서 일관되지만 임의의 조건이 유용할 수 있으므로(.node.status.conditions 참고) 충돌을 해결하는 기능이 중요합니다. 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.
criticalIncidents
list (object) 선택사항	활성 상태인 모든 심각한 사고의 플랫 목록입니다.
criticalIncidents[]
object 선택사항	진행 중인 심각한 사고에 관한 정보를 제공합니다.
criticalIncidents[].code
string 필수	오류 코드. 오류 코드는 'DBSE1012'와 같은 DBSE+숫자 문자열입니다.
criticalIncidents[].createTime
string 필수	이 인시던트가 생성된 타임스탬프입니다.
criticalIncidents[].message
string 선택사항	Message는 발생한 사고나 오류를 설명합니다.
criticalIncidents[].messageTemplateParams
object 선택사항	사용자 인터페이스에서 사용자 친화적인 데이터 기반 버전의 메시지를 생성하는 데 필요한 키-값 쌍입니다.
criticalIncidents[].resource
object 필수	사고를 신고한 데이터베이스 서비스 구성요소와 클러스터 관리자 리소스에 관한 정보입니다.
criticalIncidents[].resource.component
string 필수	사고를 신고한 데이터베이스 서비스 하위 시스템의 내부 식별자입니다.
criticalIncidents[].resource.location
object 선택사항	영향을 받는 리소스의 Kubernetes 관련 위치 (예: 클러스터, 네임스페이스, 종류, 이름)입니다.
criticalIncidents[].resource.location.cluster
string 선택사항	영향을 받는 리소스의 클러스터 이름입니다.
criticalIncidents[].resource.location.group
string 선택사항	클러스터 관리자 리소스의 그룹 이름입니다.
criticalIncidents[].resource.location.kind
string 선택사항	리소스 종류를 설명합니다.
criticalIncidents[].resource.location.name
string 선택사항	영향을 받는 리소스의 이름입니다.
criticalIncidents[].resource.location.namespace
string 선택사항	영향을 받는 리소스의 네임스페이스입니다.
criticalIncidents[].resource.location.version
string 선택사항	리소스 버전입니다.
criticalIncidents[].stackTrace
object 선택사항	스택 트레이스의 구조화되지 않은 메시지 목록입니다.
criticalIncidents[].stackTrace.component
string 선택사항	메시지를 로깅한 데이터베이스 서비스 구성요소의 이름입니다.
criticalIncidents[].stackTrace.message
string 선택사항	로깅된 메시지입니다.
criticalIncidents[].transientUntil
string 선택사항	있는 경우 지정된 시간까지는 문제를 일시적인 것으로 간주해야 함을 나타냅니다.
observedGeneration
integer 선택사항	내부: 컨트롤러에서 모니터링된 생성입니다.
reconciled
boolean 선택사항	컨트롤러에서 리소스를 조정했는지 여부입니다.