Skip to main content
Version: 1.0 (alpha)

Cloud Event List

The following is a list of all of the CloudEvents emitted by wasmCloud hosts in a lattice. The events are published to wasmbus.evt.{lattice-id}.{event-type}, and so will publish to wasmbus.evt.default.> by default.

All of the events in the table below are namespaced by the prefix com.wasmcloud.lattice, so the component_started event has the Cloud Event type of com.wasmcloud.lattice.component_started. These event types do not include the lattice identifier.

All fields indicated in the tables below are included in the data payload of the Cloud Events 1.0 specification JSON encoding.

Unless otherwise noted, the source field of the CloudEvent is the public key of the host from which the event originated.

TypeFieldsDescription
component_start_failedcomponent_ref
error
Indicates a failed attempt to start a component
component_stoppedpublic_key
instance_id
annotations
Indicates a single component instance stopped on a host
component_startedpublic_key
image_ref
api_version
instance_id
annotations(map)
claims(map)
A single component instance started
component_updatedpublic_key
revision
instance_id
a component "live update" operation completed successfully
component_update_failedpublic_key
revision
instance_id
reason
A live update operation failed
components_startedpublic_key
image_ref
annotations
host_id
count
claims(map)
A batch of component instances successfully started. host_id is the same as the envelope's source
components_start_failedpublic_key
image_ref
annotations
host_id
error
A batch of component instances failed to start. host_id is the same as the envelope's source
components_stoppedhost_id
public_key
count
remaining
annotations
A batch of component instances stopped. host_id is the same as the envelope's source
provider_startedpublic_key
image_ref
link_name
contract_id
instance_id
annotations
claims(map)
A capability provider succesfully started
provider_start_failedprovider_ref
link_name
error
A capability provider failed to start
provider_stoppedpublic_key
link_name
contract_id
instance_id
annotations
reason
A capability provider stopped
host_startedlabels
friendly_name
uptime_seconds
version
Announced by a host after completing initialization
host_stoppedlabelsAnnounced by a host just prior to final termination
host_heartbeatcomponents
providers
labels
friendly_name
version
uptime_seconds
uptime_human
Periodically emitted by hosts to advertise inventory and status
health_check_passedpublic_key
contract_id
link_name
A provider health check passed
health_check_failedpublic_key
contract_id
link_name
A provider health check failed
health_check_statuspublic_key
contract_id
link_name
Provider health status unchanged
refmap_setoci_url
public_key
Event advertising a reference mapping being cached
linkdef_setid
component_id
provider_id
link_name
contract_id
values(map)
Event advertising a link definition being cached
linkdef_deletedid
component_id
provider_id
link_name
contract_id
values(map)
Event advertising link definition being deleted from cache

The following events are emitted on a special topic, wasmbus.rpcevt.{lattice-id} to keep the relatively chatty RPC notifications separate from the other events.

TypeFieldsDescription
invocation_failedsource (public_key, contract_id, link_name)
dest (public_key, contract_id, link_name)
operation
bytes (payload len)
An RPC failure notification
invocation_suceededSame as aboveAn RPC success notification