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.

Lattice Events

Type	Description
component_scaled	A component has been scaled up or down.
component_scale_failed	A component failed to scale up or down.
linkdef_set	A link definition has been set.
linkdef_deleted	A link definition has been deleted.
provider_started	A provider has been started.
provider_start_failed	A provider failed to start.
provider_stopped	A provider has been stopped.
health_check_passed	A health check has passed.
health_check_failed	A health check has failed.
health_check_status	A health check status has been reported.
config_set	A configuration has been set.
config_deleted	A configuration has been deleted.
labels_changed	The labels on a host have changed.
host_heartbeat	A host has sent a heartbeat.
host_started	A host has started.
host_stopped	A host has stopped.

component_scaled

The component_scaled event is emitted when a component is scaled up or down.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.component_scaled for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host on which the component is running.
data.component_id	string	The ID of the component.
data.image_ref	string	The image reference of the component.
data.max_instances	number	The maximum number of instances of the component.
data.annotations	object	Object of key/value pairs describing the annotations for the component.
data.public_key	string (optional)	The public key of the host.
data.claims	object (optional)	The claims on the component (if it has been signed).
data.claims.call_alias	string (optional)	The call alias of the component.
data.claims.issuer	string (optional)	The issuer of the component.
data.claims.tags	string[] (optional)	Tags assigned during signing
data.claims.name	string (optional)	The name of the component.
data.claims.version	string (optional)	The version of the component.
data.claims.revision	string (optional)	The revision of the component.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.component_scaled",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "image_ref": "wasmcloud.azurecr.io/blobby:0.1.0",
    "max_instances": 5,
    "component_id": "blobby-blobby",
    "annotations": {
      "key": "value"
    },
    "claims": {
      "call_alias": null,
      "issuer": "ACOJJN6WUP4ODD75XEBKKTCCUJJCY5ZKQ56XVKYK4BEJWGVAOOQHZMCW",
      "tags": ["wasmcloud.com/experimental"],
      "name": "blobby",
      "version": "0.1.0",
      "revision": "0"
    }
  }
}

component_scale_failed

The component_scale_failed event is emitted when a component fails to scale up or down.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.component_scale_failed for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.error	string	The error message.
data.host_id	string	The ID of the host on which the component is running.
data.image_ref	string	The image reference of the component.
data.max_instances	number	The maximum number of instances of the component.
data.component_id	string	The ID of the component.
data.public_key	string (optional)	The public key of the host.
data.annotations	object	Object of key/value pairs describing the annotations for the component.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.component_scale_failed",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "image_ref": "wasmcloud.azurecr.io/blobby:0.1.0",
    "max_instances": 5,
    "component_id": "blobby-blobby",
    "annotations": {
      "key": "value"
    },
    "error": "Failed to scale component"
  }
}

linkdef_set

The linkdef_set event is emitted when a link definition is set.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.linkdef_set for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.source_id	string	The ID of the source component.
data.target	string	The ID of the target component.
data.name	string	The name of the link definition.
data.wit_namespace	string	The namespace of the WebAssembly interface type.
data.wit_package	string	The package of the WebAssembly interface type.
data.interfaces	string[]	The interfaces of the link definition.
data.source_config	string[]	The source configuration of the link definition.
data.target_config	string[]	The target configuration of the link definition.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.linkdef_set",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "interfaces": ["handler"],
    "name": "default",
    "source_config": ["rust_echo_messaging-simple_subscription"],
    "source_id": "rust_echo_messaging-nats",
    "target": "echo",
    "target_config": [],
    "wit_namespace": "wasmcloud",
    "wit_package": "messaging"
  }
}

linkdef_deleted

The linkdef_deleted event is emitted when a link definition is deleted.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.linkdef_deleted for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.source_id	string	The ID of the source component.
data.name	string	The name of the link definition.
data.wit_namespace	string	The namespace of the WebAssembly interface type.
data.wit_package	string	The package of the WebAssembly interface type.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.linkdef_deleted",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "name": "default",
    "source_id": "rust_echo_messaging-nats",
    "wit_namespace": "wasmcloud",
    "wit_package": "messaging"
  }
}

provider_started

The provider_started event is emitted when a provider is started.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.provider_started for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host on which the provider is running.
data.image_ref	string	The image reference of the provider.
data.provider_id	string	The ID of the provider.
data.annotations	object	Object of key/value pairs describing the annotations for the provider.
data.claims	(optional) object	The claims on the provider (if it has been signed)
data.claims.issuer	string	The issuer of the claims.
data.claims.name	string	The name of the provider set during signing.
data.claims.version	string	The version of the provider set during signing.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.provider_started",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-05-13T18:00:53.856590Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "image_ref": "ghcr.io/wasmcloud/keyvalue-redis:0.24.0",
    "provider_id": "rust_http_kv-kvredis",
    "annotations": {
      "key": "value"
    },
    "claims": {
      "issuer": "ACOJJN6WUP4ODD75XEBKKTCCUJJCY5ZKQ56XVKYK4BEJWGVAOOQHZMCW",
      "name": "keyvalue-redis-provider",
      "version": "0.24.0"
    }
  }
}

provider_start_failed

The provider_start_failed event is emitted when a provider fails to start.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.provider_start_failed for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.provider_ref	string	The reference of the provider.
data.provider_id	string	The ID of the provider.
data.error	string	The error message.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.provider_start_failed",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "image_ref": "ghcr.io/wasmcloud/keyvalue-redis:0.24.0",
    "provider_id": "rust_http_kv-kvredis",
    "error": "Failed to start provider"
  }
}

provider_stopped

The provider_stopped event is emitted when a provider is stopped.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.provider_stopped for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host on which the provider is running.
data.provider_id	string	The ID of the provider.
data.annotations	object	Object of key/value pairs describing the annotations for the provider.
data.reason	string	The reason the provider was stopped.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.provider_stopped",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T01:12:88.856590Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "provider_id": "rust_http_kv-kvredis",
    "annotations": {
      "key": "value"
    },
    "reason": "stop"
  }
}

health_check_passed

The health_check_passed event is emitted when a health check has passed.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.health_check_passed for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host.
data.provider_id	string	The ID of the provider.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.health_check_passed",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2024-06-13T18:00:53.856590Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "provider_id": "rust_http_kv-kvredis"
  }
}

health_check_failed

The health_check_failed event is emitted when a health check has failed.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.health_check_failed for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host.
data.provider_id	string	The ID of the provider.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.health_check_failed",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "provider_id": "rust_http_kv-kvredis"
  }
}

health_check_status

The health_check_status event is emitted when the status of a health check has been reported.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.health_check_status for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host.
data.provider_id	string	The ID of the provider.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.health_check_status",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "provider_id": "rust_http_kv-kvredis"
  }
}

config_set

The config_set event is emitted when a configuration is set.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.config_set for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.config_name	string	The name of the configuration.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.config_set",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "config_name": "config"
  }
}

config_deleted

The config_deleted event is emitted when a configuration is deleted.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.config_deleted for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.config_name	string	The name of the configuration.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.config_deleted",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "config_name": "config"
  }
}

labels_changed

The labels_changed event is emitted when the labels on a host have changed.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.labels_changed for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host.
data.labels	object	Object of key/value pairs describing the labels for the host.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.labels_changed",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "labels": {
      "key": "value"
    }
  }
}

host_heartbeat

The host_heartbeat event is emitted when a host has sent a heartbeat.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.host_heartbeat for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host.
data.uptime_seconds	number	The uptime in seconds.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.host_heartbeat",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2023-06-13T00:00:00+00:00Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "uptime_seconds": 1000
  }
}

host_started

The host_started event is emitted when a host has started.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.host_started for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host.
data.labels	object	Object of key/value pairs describing the labels for the host.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.host_started",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2024-06-13T18:00:53.856590Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "labels": {
      "key": "value"
    }
  }
}

host_stopped

The host_stopped event is emitted when a host has stopped.

Data Fields

Field	Type	Description
id	string	The UUID of the event.
type	string	The type of the event. Always com.wasmcloud.lattice.host_stopped for this event
source	string	The source of the event.
datacontenttype	string	The content type of the data.
specversion	string	The version of the CloudEvents spec.
time	ISO 8601 string	The time the event was emitted.
data	object	The data payload of the event. (see below)
data.host_id	string	The ID of the host.
data.labels	object	Object of key/value pairs describing the labels for the host.
data.reason	string	The reason the host was stopped.

Example Response

json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "com.wasmcloud.lattice.host_stopped",
  "source": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "time": "2024-06-13T18:00:53.856590Z",
  "data": {
    "host_id": "NCQDNJWGAISVBPU4VF45AKDTOTU6NI74WZFNW73ZR7K7NJ72AV7PUDHP",
    "labels": {
      "key": "value"
    },
    "reason": "stop"
  }
}

RPC Events

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.

Type	Description
invocation_failed	An RPC failure notification
invocation_suceeded	An RPC success notification