סכימת המפרט
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)חובה | Definitions היא רשימה של הגדרות של מדדים מותאמים אישית. |
customMetrics.definitions[].database
| |
stringחובה | Database הוא השם של מסד הנתונים שאליו רוצים להתחבר בשביל השאילתה הזו. |
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חובה | השאילתה היא הצהרת SELECT ב-SQL שצריך להריץ. |
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 היא רשימה של הפניות לשמות של 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
| |
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חובה | הסיבה מכילה מזהה פרוגרמטי שמציין את הסיבה למעבר האחרון של התנאי. יצרנים של סוגי תנאים ספציפיים יכולים להגדיר ערכים ומשמעויות צפויים לשדה הזה, ואם הערכים נחשבים ל-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 היא רשימה של כל האירועים הקריטיים הפעילים. |
criticalIncidents[].code
| |
stringחובה | קוד השגיאה הספציפית הזו. קודי השגיאה הם מחרוזות של DBSE+מספרים, כמו "DBSE1012". |
criticalIncidents[].createTime
| |
stringחובה | חותמת הזמן שבה האירוע הזה נוצר במקור. |
criticalIncidents[].message
| |
stringאופציונלי | ההודעה מתארת את האירוע או השגיאה שהתרחשו. |
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אופציונלי | פנימי: האם המשאב הותאם על ידי הבקר. |