הגדרה מותאמת אישית של משאב 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) חובה	רשימה של הפניות למופעי DBCluster שמושפעים מה-ObservabilityConfig הזה.

סכימת סטטוס

‫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 חובה	קוד השגיאה. קודי השגיאה הם מחרוזות מספריות עם הקידומת DBSE, כמו DBSE1012.
criticalIncidents[].createTime
string חובה	חותמת הזמן שבה נוצר האירוע.
criticalIncidents[].message
string אופציונלי	ההודעה מתארת את האירוע או השגיאה שהתרחשו.
criticalIncidents[].messageTemplateParams
object אופציונלי	צמד מפתח/ערך שנדרש ליצירת גרסה של ההודעה שמבוססת על נתונים ונוחה למשתמש בממשק המשתמש.
criticalIncidents[].resource
object חובה	מידע על רכיב שירות מסד הנתונים שדיווח על האירוע, וגם מידע על משאב Cluster Manager.
criticalIncidents[].resource.component
string חובה	מזהה פנימי של מערכת המשנה של שירות מסד הנתונים שדיווחה על התקרית.
criticalIncidents[].resource.location
object אופציונלי	המיקום הספציפי ל-Kubernetes (למשל אשכול, מרחב שמות, סוג ושם) של המשאב שהושפע.
criticalIncidents[].resource.location.cluster
string אופציונלי	השם של האשכול של המשאב המושפע.
criticalIncidents[].resource.location.group
string אופציונלי	שם הקבוצה של משאב Cluster Manager.
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 אופציונלי	אם המשאב הותאם על ידי הבקר.