ObservabilityConfig v1.9.0 커스텀 리소스 정의

문서 버전을 선택합니다. 18.4.0

• 현재 (18.4.0)
• 18.4.0
• 17.10.0
• 16.14.0
• 15.18.0

사양 스키마

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는 맞춤 측정항목 구성을 지정합니다.
customMetrics.definitions
list (object) 필수	정의는 커스텀 측정항목 정의 목록입니다.
customMetrics.definitions[].database
string 필수	데이터베이스는 이 쿼리를 위해 연결할 데이터베이스의 이름입니다.
customMetrics.definitions[].metricGroup
string 필수	MetricGroup은 관련 측정항목을 그룹화하는 이름입니다. 최종 측정항목 이름에 사용됩니다(alloydb_omni_custom_<metricGroup>_<metric_name>).
customMetrics.definitions[].metrics
list (object) 필수	측정항목은 쿼리 결과에서 추출할 측정항목 목록입니다.
customMetrics.definitions[].metrics[].desc
string 필수	Desc는 측정항목 또는 라벨에 대한 인간이 읽을 수 있는 설명입니다.
customMetrics.definitions[].metrics[].name
string 필수	Name은 SQL 쿼리 결과의 열 이름입니다. 이는 Prometheus 측정항목 이름의 일부 또는 라벨 이름으로 사용됩니다.
customMetrics.definitions[].metrics[].usage
string 필수	용도는 이 열이 사용되는 방식을 지정합니다. 유효한 값은 'label', 'gauge', 'counter'입니다.
customMetrics.definitions[].query
string 필수	쿼리는 실행할 SQL SELECT 문입니다.
customMetrics.resourceLimits
object 선택사항	ResourceLimits는 맞춤 쿼리 실행을 위한 리소스 한도를 지정합니다.
customMetrics.resourceLimits.maxParallelWorkers
integer 선택사항	MaxParallelWorkers는 쿼리의 최대 동시 작업자 수를 지정합니다. 0으로 설정하면 병렬 쿼리 실행이 사용 중지됩니다.
customMetrics.resourceLimits.statementTimeout
string 선택사항	StatementTimeout은 문이 실행되는 데 허용되는 최대 시간을 지정합니다. 예: '2s'
customMetrics.resourceLimits.workMemory
string 선택사항	WorkMemory는 쿼리 작업에서 사용할 최대 메모리 양을 지정합니다. 예: '4MB'
dbClusterRefs
list (string) 필수	DBClusterRefs는 이 ObservabilityConfig가 적용되는 DBCluster 이름에 대한 참조 목록입니다. 참조된 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
list (object) 선택사항	조건은 항목의 현재 상태에 대한 최근 관찰 결과를 나타냅니다.
conditions[].lastTransitionTime
string 필수	lastTransitionTime은 이 조건이 특정 상태에서 다른 상태로 전환된 마지막 시간입니다. 이는 기본 조건이 변경된 시점입니다. 이 시간을 알 수 없는 경우에는 API 필드가 변경된 시간을 사용해도 됩니다.
conditions[].message
string 필수	message는 전환에 대한 세부정보를 나타내는 인간이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.
conditions[].observedGeneration
integer 선택사항	observedGeneration은 조건이 설정된 기준인 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 12이지만 .status.conditions[x].observedGeneration이 9이면 인스턴스의 현재 상태와 관련하여 조건이 최신이 아닙니다.
conditions[].reason
string 필수	reason에는 조건의 마지막 전환 이유를 나타내는 프로그래매틱 식별자가 포함됩니다. 특정 조건 유형의 생산자는 이 필드의 예상 값과 의미, 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비워둘 수 없습니다.
conditions[].status
string 필수	조건 상태(True, False, 알 수 없음 중 하나)입니다.
conditions[].type
string 필수	CamelCase 또는 foo.example.com/CamelCase 형식의 조건 유형입니다. 여러 .condition.type 값은 Available과 같은 리소스에서 일관되지만 임의의 조건이 유용할 수 있으므로(.node.status.conditions 참고) 충돌을 해결하는 기능이 중요합니다. 일치하는 정규식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.
criticalIncidents
list (object) 선택사항	CriticalIncidents는 활성 상태인 모든 심각한 사고의 단순 목록입니다.
criticalIncidents[].code
string 필수	이 특정 오류의 오류 코드입니다. 오류 코드는 'DBSE1012'와 같은 DBSE+숫자 문자열입니다.
criticalIncidents[].createTime
string 필수	이 사고가 출처에서 생성된 타임스탬프입니다.
criticalIncidents[].message
string 선택사항	Message는 발생한 사고/오류를 설명합니다.
criticalIncidents[].messageTemplateParams
object 선택사항	사용자 인터페이스에서 사용자 친화적인 데이터 기반 버전의 메시지를 생성하는 데 필요한 키-값 쌍을 포함합니다.
criticalIncidents[].resource
object 필수	사고를 신고한 데이터베이스 서비스 구성요소와 K8s 리소스에 대한 정보를 포함합니다.
criticalIncidents[].resource.component
string 필수	사고를 신고한 데이터베이스 서비스 하위 시스템의 내부 식별자입니다.
criticalIncidents[].resource.location
object 선택사항	위치입니다.
criticalIncidents[].resource.location.cluster
string 선택사항	영향을 받는 Kubernetes 리소스의 클러스터 이름입니다.
criticalIncidents[].resource.location.group
string 선택사항	Kubernetes 리소스의 그룹 이름입니다.
criticalIncidents[].resource.location.kind
string 선택사항	Kubernetes 리소스의 종류입니다.
criticalIncidents[].resource.location.name
string 선택사항	영향을 받는 Kubernetes 리소스의 이름입니다.
criticalIncidents[].resource.location.namespace
string 선택사항	영향을 받은 Kubernetes 리소스의 네임스페이스입니다.
criticalIncidents[].resource.location.version
string 선택사항	Kubernetes 리소스의 버전입니다.
criticalIncidents[].stackTrace
list (object) 선택사항	스택 트레이스의 구조화되지 않은 메시지 목록입니다.
criticalIncidents[].stackTrace[].component
string 선택사항	메시지를 로깅한 데이터베이스 서비스 구성요소의 이름입니다.
criticalIncidents[].stackTrace[].message
string 선택사항	로깅된 메시지입니다.
criticalIncidents[].transientUntil
string 선택사항	있는 경우 지정된 시간까지는 문제를 일시적인 것으로 간주해야 함을 나타냅니다.
observedGeneration
integer 선택사항	내부: 컨트롤러에서 모니터링된 생성입니다.
reconciled
boolean 선택사항	내부: 컨트롤러에서 리소스를 조정했는지 여부입니다.