KRM API logging.gdc.goog/v1

logging.gdc.goog/v1

מכיל הגדרות של סכמת API לקבוצת הרישום.

AlertRule

הגדרת כללי ההתראות.

מופיע ב: - LoggingRuleSpec

שדה תיאור
alert string שם ההתראה. הערך שלו חייב להיות ערך תווית תקין.
expr string ביטוי PromQL או LogQL להערכת כלל ההתראה.
for string משך הזמן בשניות שבו התנאי שצוין צריך להתקיים כדי שההתראה תעבור מהסטטוס 'בהמתנה' לסטטוס 'פתוח'.
‫labels object (keys:string, values:string) התוויות שרוצים להוסיף או להחליף. תוויות החובה בשדה הזה הן severity: [error, critical, warning, info, high, moderate, low],‏ code: <short code for the error> ו-resource: <component, service,errorcode: _gdch_project: `
‫annotations object (keys:string, values:string) ההערות להוספה.

ApiServerEntry

מופיע ב: - AuditlogInventorySpec

שדה תיאור
resourceKind string
auditRelevant boolean
comment string
resourceName string
namespace string
users מערך מחרוזות
‫filters מערך Filter

AuditlogInventory

הגדרת הסכימה של AuditlogInventory API.

מופיע ב: - AuditlogInventoryList

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string AuditlogInventory
metadata ObjectMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
spec AuditlogInventorySpec
‫status AuditlogInventoryStatus

AuditlogInventoryList

מכיל רשימה של AuditlogInventory.

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string AuditlogInventoryList
metadata ListMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
‫items מערך AuditlogInventory

AuditlogInventorySpec

מופיע ב: - AuditlogInventory

שדה תיאור
oc string
‫apiServer ApiServerEntry array
logFiles מערך LogFile
‫syslogs Syslog array

AuditlogInventoryStatus

מופיע ב: - AuditlogInventory

שדה תיאור
conditions מערך Condition

תנאי

התנאי מגדיר תנאי לסינון.

מופיע ב: - מסנן

שדה תיאור
path string
match string

ElasticOutput

הגדרת תצורת הפלט של Elastic.

מופיע ב: - SIEMDestinations

שדה תיאור
host string שם המארח של שירות היעד של Elastic.
http_credential HTTPCredential פרטי הכניסה של HTTP למופע Elastic.
port מספר שלם יציאת TCP של מופע Elastic.
tls string
netConnectTimeout מספר שלם
index string האינדקס של מופע Elastic. אם לא מציינים סוג, המערכת משתמשת בסוג היומן (ביקורת או תפעולי).

מסנן

מסנן מגדיר כלל להסרה או להחלפה של שדות ספציפיים מיומני ביקורת. אפשר להשתמש בו כדי לסנן מידע רגיש או כל שדה שלא רלוונטי ליומן הביקורת.

מופיע ב: - ApiServerEntry

שדה תיאור
name string
action string
targetPath string
conditions מערך Condition

HTTPCredential

ההגדרה הזו מגדירה את פרטי הכניסה ל-HTTP עבור Elastic SIEM.

מופיע ב: - ElasticOutput

שדה תיאור
http_user string משתמש HTTP למופע Elastic
http_passwd string סיסמת HTTP למופע Elastic

LogFile

‫LogFile מייצג הגדרה של קובץ יומן.

מופיע ב: - AuditlogInventorySpec

שדה תיאור
name string
path string

LoggingRule

הגדרת הסכימה של Logging Rules API.

Appears in: - LoggingRuleList

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string LoggingRule
metadata ObjectMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
spec LoggingRuleSpec
status LoggingRuleStatus

LoggingRuleList

מכילה רשימה של כללי רישום ביומן.

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string LoggingRuleList
metadata ListMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
items מערך LoggingRule

LoggingRuleSpec

מגדיר את המפרט או את המצב הצפוי של אובייקט LoggingRule.

מופיע ב: - LoggingRule

שדה תיאור
source מקור מקור היומן שעליו יתבססו ההתראות. הערכים הקבילים הם operational ו-audit.
interval string המרווח בין הערכות הכללים.
limit מספר שלם מספר ההתראות המקסימלי. הערך 0 מציין שאין מגבלה.
recordRules מערך RecordRule רשימת כללי הרשומה.
alertRules מערך AlertRule רשימת כללי ההתראות.

LoggingRuleStatus

המאפיין מגדיר את המצב הנצפה של אובייקט LoggingRule.

מופיע ב: - LoggingRule

שדה תיאור
conditions מערך Condition רשימה של תנאים שנצפו בחבילת ההתראות של Logging.
lokiInstance string השם של מופע המארח של Loki שבו האובייקט LoggingRule מותקן כרגע.

LoggingTarget

הגדרת הסכימה של API של יעדי רישום פעולות.

מופיע ב: - LoggingTargetList

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string LoggingTarget
metadata ObjectMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
spec LoggingTargetSpec
status LoggingTargetStatus

LoggingTargetList

מכיל רשימה של יעדי רישום ביומן.

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string LoggingTargetList
metadata ListMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
‫items LoggingTarget array

LoggingTargetSelectors

מספק סלקטורים שקובעים מאיזה פודים או קונטיינרים לאסוף יומנים.

מופיע ב: - LoggingTargetSpec

שדה תיאור
matchClusters מערך מחרוזות האשכולות שמהם רוצים לאסוף יומנים. הגדרת ברירת המחדל היא איסוף יומנים מכל האשכולות. הקשר בין אשכולות שונים הוא קשר OR. לדוגמה, הערך ["admin", "system"] מציין שצריך להתייחס לאשכול האדמין OR כאשכול המערכת.
matchPodNames מערך מחרוזות התחיליות של שמות הפודים שמהם רוצים לאסוף יומנים. פלטפורמת ה-Observability סורקת את כל הפודים ששמותיהם מתחילים בקידומות שצוינו. הערכים חייבים להכיל רק [a-z0-9-] תווים. הקשר בין רכיבים שונים ברשימה הוא קשר מסוג OR.
matchContainerNames מערך מחרוזות הקידומות של שמות המאגרים שמהם ייאספו היומנים. פלטפורמת ה-Observability סורקת את כל מאגרי התגים עם שמות שמתחילים בקידומות שצוינו. הערכים חייבים להכיל רק [a-z0-9-] תווים. הקשר בין רכיבים שונים ברשימה הוא קשר מסוג OR.

LoggingTargetSpec

מגדיר את המפרט או את המצב הצפוי של אובייקט LoggingTarget.

מופיע ב: - LoggingTarget

שדה תיאור
selector LoggingTargetSelectors התבנית התואמת שמזהה את ה-pods או הקונטיינרים שמהם ייאספו היומנים. הקשר בין סלקטורים שונים הוא קשר מסוג AND, ולכן כל הסלקטורים נלקחים בחשבון.
logAccessLevel LogAccessLevel רמת הגישה לרשומות ביומן. ערך ברירת המחדל הוא AO עבור Application Operator.
parser OperationalLogParser הכלי המוגדר מראש לניתוח רשומות ביומן.
serviceName string שם השירות שרוצים להוסיף כתווית. בעומסי עבודה של משתמשים, אפשר להשתמש בשדה הזה כשם של עומס עבודה.
‫additionalFields object (keys:string, values:string) השדות הסטטיים הנוספים שיוחלו על רשומות ביומן. השדה הזה הוא מיפוי של צמדי מפתח/ערך, שבהם שם השדה הוא המפתח וערך השדה הוא הערך.

LoggingTargetStatus

המאפיין מגדיר את המצב הנצפה של אובייקט LoggingTarget.

מופיע ב: - LoggingTarget

שדה תיאור
conditions מערך Condition רשימה של תנאים שנצפו במערכת רישום היומנים.

RecordRule

הגדרת כללי הרשומה.

מופיע ב: - LoggingRuleSpec

שדה תיאור
record string סדרת הזמן שבה רוצים לכתוב את כלל הרשומה. השם חייב להיות שם תקין של מדד.
expr string ביטוי PromQL או LogQL להערכת כלל הרשומה.
‫labels object (keys:string, values:string) התוויות שרוצים להוסיף או להחליף.

SIEMDestinations

‫SIEMDestinations מגדיר את אפשרויות ההגדרה של יעד SIEM. המשתמשים צריכים לציין פלט בשדות splunk או elastic.

מופיע ב: - SIEMOrgForwarderSpec

שדה תיאור
‫splunkOutputs SplunkOutput array ‫Splunk מגדיר רשימה של הגדרות יעד של Splunk.
elasticOutputs מערך ElasticOutput ‫Elastic מגדירה רשימה של הגדרות יעד של Elastic.

SIEMOrgForwarder

הגדרת הסכימה של SIEMOrgForwarder API. ב-API הזה מוגדר סוג היומנים, שיכול להיות יומן ביקורת או יומן תפעולי, ויעד ה-SIEM החיצוני שאליו יישלחו היומנים.

מופיע ב: - SIEMOrgForwarderList

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string SIEMOrgForwarder
metadata ObjectMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
spec SIEMOrgForwarderSpec
status SIEMOrgForwarderStatus

SIEMOrgForwarderList

מכיל רשימה של SIEMOrgForwarder אובייקטים.

שדה תיאור
apiVersion string logging.gdc.goog/v1
kind string SIEMOrgForwarderList
metadata ListMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
‫items SIEMOrgForwarder array

SIEMOrgForwarderSpec

הגדרה של המפרט או הסטטוס הצפוי של משאב SIEMOrgForwarder.

מופיע ב: - SIEMOrgForwarder

שדה תיאור
source LogType סוג היומנים לייצוא ליעד SIEM. הערכים הקבילים הם operational ו-audit.
destinations SIEMDestinations ההגדרה Destinations מציינת את הגדרות הפלט של SIEM. היעדים הזמינים כרגע הם Splunk ו-Elastic
‫splunkOutputs SplunkOutput array TODO (b/427090537): This field is to support the backward compatibility To be removed in 1.17

SIEMOrgForwarderStatus

המאפיין מגדיר את המצב הנצפה של משאב SIEMOrgForwarder.

מופיע ב: - SIEMOrgForwarder

שדה תיאור
conditions מערך Condition המצב שנצפה של משאב SIEMOrgForwarder.

SplunkOutput

הגדרת הפלט של Splunk.

מופיע ב: - SIEMDestinations - SIEMOrgForwarderSpec

שדה תיאור
host string שם המארח של שירות היעד של Splunk.
token טוקן אסימון האימות לממשק HTTP Event Collector.
tls string הפרוטוקול Transport Layer Security (TLS). מידע נוסף זמין בכתובת https://docs.fluentbit.io/manual/administration/transport-security.
netConnectTimeout מספר שלם הזמן המקסימלי בשניות להמתנה עד ליצירת חיבור TCP. הערך הזה כולל את זמן הלחיצה של TLS.

Syslog

‫Syslog מייצג הגדרת syslog.

מופיע ב: - AuditlogInventorySpec

שדה תיאור
name string
auditLoggingTargetName string
auditLoggingTargetNamespace string

אסימון

מגדירה את הגדרות האסימון לייצוא ל-SIEM.

מופיע ב: - SplunkOutput

שדה תיאור
name string שם האסימון.
field string השדה של הטוקן.