KRM API logging.gdc.goog/v1

logging.gdc.goog/v1

Enthält API-Schemadefinitionen für die Gruppe „Logging“.

AlertRule

Definiert die Konfiguration der Benachrichtigungsregeln.

Wird angezeigt in: - LoggingRuleSpec

Feld Beschreibung
alert String Der Name der Benachrichtigung. Der Wert muss ein gültiger Labelwert sein.
expr String Der PromQL- oder LogQL-Ausdruck, mit dem die Benachrichtigungsregel ausgewertet wird.
for String Die Dauer in Sekunden, über die die angegebene Bedingung erfüllt sein muss, damit die Benachrichtigung vom Status „Ausstehend“ in den Status „Offen“ wechselt.
labels object (keys:string, values:string) Die Labels, die hinzugefügt oder überschrieben werden sollen. Die erforderlichen Labels in diesem Feld sind severity: [error, critical, warning, info, high, moderate, low], code: <short code for the error> und resource: <component, service,.errorcode: _gdch_project: `
annotations object (keys:string, values:string) Die hinzuzufügenden Anmerkungen.

ApiServerEntry

Wird angezeigt in: - AuditlogInventorySpec

Feld Beschreibung
resourceKind String
auditRelevant boolean
comment String
resourceName String
namespace String
users String-Array
filters Filter-Array

AuditlogInventory

Definiert das Schema für die AuditlogInventory API.

Wird angezeigt in: - AuditlogInventoryList

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String AuditlogInventory
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
spec AuditlogInventorySpec
status AuditlogInventoryStatus

AuditlogInventoryList

Enthält eine Liste von AuditlogInventory.

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String AuditlogInventoryList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
items AuditlogInventory-Array

AuditlogInventorySpec

Wird angezeigt in: - AuditlogInventory

Feld Beschreibung
oc String
apiServer ApiServerEntry-Array
logFiles LogFile-Array
syslogs Syslog-Array

AuditlogInventoryStatus

Wird angezeigt in: - AuditlogInventory

Feld Beschreibung
conditions Bedingungs-Array

Bedingung

„Condition“ definiert eine Bedingung für einen Filter.

Wird angezeigt in: – Filter

Feld Beschreibung
path String
match String

ElasticOutput

Definiert die Elastic-Ausgabekonfiguration.

Wird angezeigt in: - SIEMDestinations

Feld Beschreibung
host String Der Hostname des Elastic-Zieldienstes.
http_credential HTTPCredential Die HTTP-Anmeldedaten für die Elastic-Instanz.
port Ganzzahl TCP-Port der Elastic-Instanz.
tls String
netConnectTimeout Ganzzahl
index String Der Index für die Elastic-Instanz. Wenn nicht angegeben, wird der Protokolltyp (Audit oder Operational) verwendet.

Filter

Ein Filter definiert eine Regel zum Entfernen oder Ersetzen bestimmter Felder aus Audit-Logs. Damit lassen sich vertrauliche Informationen oder Felder filtern, die für das Audit-Log irrelevant sind.

Wird angezeigt in: - ApiServerEntry

Feld Beschreibung
name String
action String
targetPath String
conditions Bedingungs-Array

HTTPCredential

Definiert die HTTP-Anmeldedaten für Elastic SIEM.

Wird angezeigt in: - ElasticOutput

Feld Beschreibung
http_user String HTTP-Nutzer für die Elastic-Instanz
http_passwd String HTTP-Passwort für die Elastic-Instanz

LogFile

„LogFile“ steht für eine Logdateikonfiguration.

Wird angezeigt in: - AuditlogInventorySpec

Feld Beschreibung
name String
path String

LoggingRule

Definiert das Schema für die Logging Rules API.

Wird angezeigt in: - LoggingRuleList

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String LoggingRule
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
spec LoggingRuleSpec
status LoggingRuleStatus

LoggingRuleList

Enthält eine Liste mit Protokollierungsregeln.

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String LoggingRuleList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
items LoggingRule-Array

LoggingRuleSpec

Definiert die Spezifikation oder den erwarteten Status des LoggingRule-Objekts.

Wird angezeigt in: - LoggingRule

Feld Beschreibung
source Quelle Die Protokollquelle, auf der Benachrichtigungen basieren sollen. Zulässige Werte sind operational und audit.
interval String Das Regelauswertungsintervall.
limit Ganzzahl Die Anzahl der Benachrichtigungen begrenzen. Ein Wert von 0 bedeutet kein Limit.
recordRules RecordRule-Array Die Liste der Datensatzregeln.
alertRules AlertRule-Array Die Liste der Benachrichtigungsregeln.

LoggingRuleStatus

Definiert den beobachteten Status des LoggingRule-Objekts.

Wird angezeigt in: - LoggingRule

Feld Beschreibung
conditions Bedingungs-Array Eine Liste der Bedingungen, die im Logging-Benachrichtigungsstack beobachtet wurden.
lokiInstance String Der Name der Loki-Hostinstanz, auf der das LoggingRule-Objekt derzeit installiert ist.

LoggingTarget

Definiert das Schema für die API für Betriebslogziele.

Wird angezeigt in: - LoggingTargetList

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String LoggingTarget
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
spec LoggingTargetSpec
status LoggingTargetStatus

LoggingTargetList

Enthält eine Liste von Logging-Zielen.

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String LoggingTargetList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
items LoggingTarget-Array

LoggingTargetSelectors

Stellt Selektoren bereit, mit denen festgelegt wird, von welchen Pods oder Containern Logs erfasst werden sollen.

Wird angezeigt in: - LoggingTargetSpec

Feld Beschreibung
matchClusters String-Array Die Cluster, aus denen Logs erfasst werden sollen. In der Standardkonfiguration werden Logs aus allen Clustern erfasst. Die Beziehung zwischen verschiedenen Clustern ist eine OR-Beziehung. Der Wert ["admin", "system"] gibt beispielsweise an, dass der Administratorcluster OR als Systemcluster betrachtet werden soll.
matchPodNames String-Array Die Pod-Namenpräfixe, von denen Logs erfasst werden sollen. Die Observability-Plattform ruft alle Pods mit Namen ab, die mit den angegebenen Präfixen beginnen. Die Werte dürfen nur [a-z0-9-] Zeichen enthalten. Die Beziehung zwischen den verschiedenen Listenelementen ist eine OR-Beziehung.
matchContainerNames String-Array Die Containernamepräfixe, aus denen Logs erfasst werden sollen. Die Observability-Plattform ruft alle Container mit Namen ab, die mit den angegebenen Präfixen beginnen. Die Werte dürfen nur [a-z0-9-] Zeichen enthalten. Die Beziehung zwischen den verschiedenen Listenelementen ist eine OR-Beziehung.

LoggingTargetSpec

Definiert die Spezifikation oder den erwarteten Status des LoggingTarget-Objekts.

Wird angezeigt in: - LoggingTarget

Feld Beschreibung
selector LoggingTargetSelectors Das übereinstimmende Muster, das die Pods oder Container angibt, aus denen Logs erfasst werden sollen. Die Beziehung zwischen den verschiedenen Selektoren ist eine AND-Beziehung. Alle Selektoren werden also berücksichtigt.
logAccessLevel LogAccessLevel Die Zugriffsebene für Logeinträge. Der Standardwert für den Anwendungsoperator ist AO.
parser OperationalLogParser Der vordefinierte Parser für Logeinträge.
serviceName String Ein Dienstname, der als Label angewendet werden soll. Bei Nutzerarbeitslasten können Sie dieses Feld für einen Arbeitslastnamen verwenden.
additionalFields object (keys:string, values:string) Die zusätzlichen statischen Felder, die auf Logeinträge angewendet werden sollen. Dieses Feld ist eine Zuordnung von Schlüssel/Wert-Paaren, wobei der Feldname der Schlüssel und der Feldwert der Wert ist.

LoggingTargetStatus

Definiert den beobachteten Status des LoggingTarget-Objekts.

Wird angezeigt in: - LoggingTarget

Feld Beschreibung
conditions Bedingungs-Array Eine Liste der im Logging-Stack beobachteten Bedingungen.

RecordRule

Definiert die Konfiguration der Datensatzregeln.

Wird angezeigt in: - LoggingRuleSpec

Feld Beschreibung
record String Die Zeitreihe, in die die Datensatzregel geschrieben werden soll. Es muss ein gültiger Messwertname sein.
expr String Der PromQL- oder LogQL-Ausdruck, mit dem die Aufzeichnungsregel ausgewertet wird.
labels object (keys:string, values:string) Die Labels, die hinzugefügt oder überschrieben werden sollen.

SIEMDestinations

SIEMDestinations definiert die möglichen SIEM-Zielkonfigurationen. Nutzer müssen Ausgaben in den Feldern splunk oder elastic angeben.

Wird angezeigt in: - SIEMOrgForwarderSpec

Feld Beschreibung
splunkOutputs SplunkOutput-Array Splunk definiert eine Liste von Splunk-Zielkonfigurationen.
elasticOutputs ElasticOutput-Array Elastic definiert eine Liste von Elastic-Zielkonfigurationen.

SIEMOrgForwarder

Definiert das Schema für die SIEMOrgForwarder API. Mit dieser API wird der Typ der Logs definiert, der Audit- oder Betriebslogs sein kann, sowie das externe SIEM-Ziel, an das die Logs gesendet werden.

Wird angezeigt in: - SIEMOrgForwarderList

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String SIEMOrgForwarder
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
spec SIEMOrgForwarderSpec
status SIEMOrgForwarderStatus

SIEMOrgForwarderList

Enthält eine Liste von SIEMOrgForwarder-Objekten.

Feld Beschreibung
apiVersion String logging.gdc.goog/v1
kind String SIEMOrgForwarderList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
items SIEMOrgForwarder-Array

SIEMOrgForwarderSpec

Definiert die Spezifikation oder den erwarteten Status der SIEMOrgForwarder-Ressource.

Wird angezeigt in: - SIEMOrgForwarder

Feld Beschreibung
source LogType Der Typ der Logs, die in ein SIEM-Ziel exportiert werden sollen. Zulässige Werte sind operational und audit.
destinations SIEMDestinations „Destinations“ gibt die SIEM-Ausgabekonfigurationen an. Derzeit verfügbare Ziele sind Splunk und Elastic.
splunkOutputs SplunkOutput-Array TODO (b/427090537): Dieses Feld dient der Abwärtskompatibilität und wird in Version 1.17 entfernt.

SIEMOrgForwarderStatus

Definiert den beobachteten Status der SIEMOrgForwarder-Ressource.

Wird angezeigt in: - SIEMOrgForwarder

Feld Beschreibung
conditions Bedingungs-Array Der beobachtete Status der SIEMOrgForwarder-Ressource.

SplunkOutput

Definiert die Splunk-Ausgabekonfiguration.

Wird verwendet in: - SIEMDestinations - SIEMOrgForwarderSpec

Feld Beschreibung
host String Der Hostname des Ziel-Splunk-Dienstes.
token Token Das Authentifizierungstoken für die HTTP Event Collector-Schnittstelle.
tls String Das Transport Layer Security-Protokoll (TLS). Weitere Informationen finden Sie unter https://docs.fluentbit.io/manual/administration/transport-security.
netConnectTimeout Ganzzahl Die maximale Wartezeit in Sekunden, bis eine TCP-Verbindung hergestellt wird. Dieser Wert umfasst die TLS-Handshake-Zeit.

Syslog

„Syslog“ steht für eine Syslog-Konfiguration.

Wird angezeigt in: - AuditlogInventorySpec

Feld Beschreibung
name String
auditLoggingTargetName String
auditLoggingTargetNamespace String

Token

Definiert die Tokenkonfiguration für den SIEM-Export.

Wird angezeigt in: - SplunkOutput

Feld Beschreibung
name String Der Name des Tokens.
field String Das Feld des Tokens.