You are browsing documentation for an older version. See the latest documentation here.

Kubernetes Events

Kubernetes API allows creating events to notify users about changes in the cluster. Events are treated as informative, best-effort, supplemental data which might be helpful in debugging issues. Some of the built-in events users might be familiar with are CrashLoopBackOff, ImagePullBackOff, FailedScheduling, etc. Every event has a set of fields defined in the Event API object schema. The most relevant of those in the context of Kong Ingress Controller are:

• Reason - a short, machine-friendly string that describes the reason for emitting an event, can be treated as a category (e.g. KongConfigurationTranslationFailed, KongConfigurationApplyFailed, etc.).
• Message - a human-readable description of the event with a detailed explanation of what happened (e.g. invalid methods: cannot set 'methods' when 'protocols' is 'grpc' or 'grpcs').
• Type - a string that describes the type of the event (e.g. Warning, Normal, etc.).
• InvolvedObject - a reference to the object(s) that the event is about (e.g. Ingress, KongPlugin, etc.).

Emitted Events

All the events that are emitted by Kong Ingress Controller are listed in the table below.

Inspecting Events

Although Kong Ingress Controller provides Prometheus metrics to monitor the current state of the configuration translation and application processes (ingress_controller_translation_count, ingress_controller_configuration_push_count, see Prometheus Metrics for details), it’s recommended to use the events to get more information about the root cause of the issue when the metrics indicate that something went wrong.

Events can be inspected using the kubectl get events command. Their reason field might be used to filter a specific kind of events (e.g. KongConfigurationApplyFailed).

The output of the command will look similar to this:

kubectl get events --field-selector='reason=KongConfigurationApplyFailed'
LAST SEEN   TYPE       REASON                                 OBJECT                             MESSAGE
1m          Warning    KongConfigurationApplyFailed           KongPlugin/my-plugin               Plugin schema validation failed: invalid value "foo" for field "config"