Modules§
- append_
result - client_
message - compute_
node_ append_ response - full_
result - grouped_
compute_ node_ append_ response - grouped_
compute_ node_ append_ responses - health_
message - invalid_
computation - invalid_
computation_ type - milliseconds
- non_
nominal_ storage_ locator - permission_
denied - ping
- pong
- server_
message - shutdown_
notice - streaming_
compute_ node_ request - streaming_
compute_ node_ subscription - subscription_
creation - subscription_
creation_ error - subscription_
creation_ message - subscription_
creation_ success - subscription_
id - subscription_
options - subscription_
update - subscription_
update_ error - subscription_
update_ message - too_
many_ points - too_
many_ points_ for_ single_ series - unsupported_
granularity - window_
negative - window_
too_ large - window_
with_ look_ back_ too_ large
Structs§
- Append
Result - An append result won’t cover the full
StreamingComputeNodeRequest#windowWidth
but rather just a smaller window. The end of the window that the append covers is guaranteed to be later than previously sent results. The start, however, can and most likely will overlap with previous results. That allows us to support out-of-order points. The client will have to merge this newAppendResult
with previous results. Example of time windows that might be covered by results for a subscription: We send a full result for window [0s, 120s] followed by an append result for [116s, 121s] and another append result for [117s, 122s]. - Full
Result - Grouped
Compute Node Append Response - Grouped
Compute Node Append Responses - Contains a
GroupedComputeNodeAppendResponse
for each applicable grouping along with metadata describing the grouping. All the containedGroupedComputeNodeAppendResponse
s are guaranteed to be of the same type. - Invalid
Computation - Milliseconds
- NonNominal
Storage Locator - Permission
Denied - Ping
- A ping can be sent by both client and server to keep the connection open and check that it is still working. The receiving end should send back a pong immediately. We also include the times that pings and pongs are sent so that we can track latency and/or discover clock drift between server and client.
- Pong
- Shutdown
Notice - Indicates that the websocket will shut down in the near future. Until it is, SubscriptionUpdates will still be sent to the client. Clients that want to avoid downtime or latency spikes should initiate a new websocket and recreate all their subscriptions there but still keep this websocket open until the new websockets starts sending SubscriptionUpdates. Note: The initial updates that the new websocket sends might be somewhat stale because of server and connection pools warm up. The client might want to wait with fully switching to the new subscription until the updates aren’t very stale anymore.
- Streaming
Compute Node Request - A templatized version of
ComputeNodeRequest
where the end of the range will track the current time and the start of the range trackswindowWidth
time ago. - Streaming
Compute Node Subscription - Subscription
Creation Error - This will be sent if there is an error while creating a subscription. This means that the subscription was never created and the client will have to re-try creating it if warranted. This can also be sent after a subscription was first successfully started and sent result. In that case it means that the subscription encountered an unrecoverable error at runtime and will be stopped.
- Subscription
Creation Message - Subscription
Creation Success - Will be returned once a subscriptions has been successfully created.
- Subscription
Id - Subscription
Options - Subscription
Update Error - This will be sent if there is an error while updating a subscription. Note: This won’t automatically cancel
the subscription. The client will have to call
ClientMessage::unsubscribe
to do that if warranted. - Subscription
Update Message - TooMany
Points - The subscription is operating on too many points.
- TooMany
Points ForSingle Series - The subscription is operating on a series that has too many points.
- Unsupported
Granularity - Window
Negative - Window
TooLarge - Window
With Look Back TooLarge