Documentation
This is the documentation for the latest development version of Cartographer. Both code and docs may be unstable and these docs are not guaranteed to be up to date or correct. See the latest version.
Events
Cartographer’s controller emits Kubernetes Events when reconciling owner resources (those belonging to a Workload, Deliverable or Runnable) objects.
Events in owner resources
Cartographer emits events with regard to specific resources belonging to a Workoad, Deliverable or Runnable.
Events may be emitted for the following reasons:
StampedObjectApplied
this event is emitted whenever Cartographer creates or updates an owner resource.StampedObjectRemoved
this event is emitted whenever Cartographer removes a resource.ResourceOutputChanged
this event is emitted whenever Cartographer notices a resource’s output has changed since the last time it was observed.ResourceHealthyStatusChanged
this event is emitted whenever Cartographer notices the healthy status of a resources has changed. For more details see Health Rules
Example events
Here’s an example of events retrieved from a workload using kubectl describe workload <my-workload> -n <ns>
:
... Workload description redacted ...
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal StampedObjectApplied 3m5s Workload Created object [gitrepositories.source.toolkit.fluxcd.io/testing-sc]
Normal StampedObjectApplied 3m3s Workload Created object [runnables.carto.run/testing-sc]
Normal ResourceOutputChanged 3m2s (x2 over 3m3s) Workload [source-provider] found a new output in [gitrepositories.source.toolkit.fluxcd.io/testing-sc]
Normal ResourceHealthyStatusChanged 3m2s (x2 over 3m3s) Workload [source-provider] found healthy status of [gitrepositories.source.toolkit.fluxcd.io/testing-sc] changed to [True]
Normal ResourceOutputChanged 2m51s Workload [source-tester] found a new output in [runnables.carto.run/testing-sc]
Normal ResourceHealthyStatusChanged 2m51s Workload [source-tester] found healthy status of [runnables.carto.run/testing-sc] changed to [True]
Normal StampedObjectApplied 2m51s Workload Created object [images.kpack.io/testing-sc]
Normal StampedObjectApplied 2m24s Workload Created object [apps.kappctrl.k14s.io/testing-sc]
Normal ResourceOutputChanged 2m22s (x2 over 2m24s) Workload [image-builder] found a new output in [images.kpack.io/testing-sc]
Normal ResourceHealthyStatusChanged 2m22s (x2 over 2m24s) Workload [image-builder] found healthy status of [images.kpack.io/testing-sc] changed to [True]
Normal ResourceHealthyStatusChanged 2m22s (x2 over 2m24s) Workload [deployer] found healthy status of [apps.kappctrl.k14s.io/testing-sc] changed to [True]
Here’s another example, showing events on a Runnable
. Note the StampedObjectRemoved
events showing when older
stamped runnable objects are garbage collected.
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal StampedObjectApplied 4m5s Runnable Created object [taskruns.tekton.dev/test-sg4m5]
Normal StampedObjectApplied 3m49s Runnable Created object [taskruns.tekton.dev/test-mx7nw]
Normal ResourceOutputChanged 3m37s Runnable Runnable [test] found a new output in [taskruns.tekton.dev/test-mx7nw]
Normal StampedObjectApplied 119s Runnable Created object [taskruns.tekton.dev/test-hzkq2]
Normal StampedObjectRemoved 113s Runnable Deleted object [taskruns.tekton.dev/test-mx7nw]
Normal ResourceOutputChanged 113s Runnable Runnable [test] found a new output in [taskruns.tekton.dev/test-hzkq2]