Event

Event is a report of an event somewhere in the cluster. Events have a limited retention time and triggers and messages may evolve with time. Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason. Events should be treated as informative, best-effort, supplemental data.

Schema URL

https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/core.api.k8s.io/Event_v1.json

▶ Usage examples

VS Code / yaml-language-server

# yaml-language-server: $schema=https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/core.api.k8s.io/Event_v1.json

kubeconform

kubeconform -schema-location 'https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/{{ .Group }}/{{ .ResourceKind }}_{{ .ResourceAPIVersion }}.json' manifest.yaml

Resource Structure

actionstring

What action was taken/failed regarding to the Regarding object.

apiVersionstring

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

countinteger

The number of times this event has occurred.

eventTimeobject

Time when this Event was first observed.

firstTimestampobject

The time at which the event was first recorded. (Time of server receipt is in TypeMeta.)

involvedObjectobjectRequired

The object that this event is about.

kindstring

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

lastTimestampobject

The time at which the most recent occurrence of this event was recorded.

messagestring

A human-readable description of the status of this operation.

metadataobjectRequired

Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

reasonstring

This should be a short, machine understandable string that gives the reason for the transition into the object's current status.

relatedobject

Optional secondary object for more complex actions.

reportingComponentstring

Name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`.

reportingInstancestring

ID of the controller instance, e.g. `kubelet-xyzf`.

seriesobject

Data about the Event series this event represents or nil if it's a singleton Event.

sourceobject

The component reporting this event. Should be a short machine understandable string.

typestring

Type of this event (Normal, Warning), new types could be added in the future