Amazon IVS Chat

Managed live chat rooms with a WebSocket messaging data plane.

Provider
aws
Category
Edge
Properties · 4 set by this component
propertytypevaluesrequiredkind defaultthis component
ackIntervalSeconds · advancedinteger—no—inherited
autoscalingboolean—nofalse▸ true
channelAssignment · advancedenumrandom | hash | stickynorandominherited
concurrentConnectionsLimit · component propertyinteger—no50000inherited
drainOnScaleIn · advancedboolean—nofalseinherited
loggingConfiguration · component propertyboolean—nofalseinherited
managedboolean—nofalse▸ true
maxMessageRatePerSecond · component propertyinteger—no100inherited
messageReviewHandlerTimeoutMs · component propertyinteger—no200inherited
protocolenumwebsocket | sse | long-poll | grpc-stream | udp-multicastnowebsocket▸ websocket
pushFallback · advancedboolean—nofalseinherited
sequenceNumbers · advancedboolean—nofalseinherited
stampedeGuard · advancedboolean—nofalseinherited
statefulboolean—notrue▸ true
subscriptionsPerUser · advancedinteger—no—inherited
Rules that apply · 3

Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.

reconnect-stampede-without-guard

When a gateway holding millions of sockets restarts, every client reconnects at once and the gateway asks the coordination service about each of them. Without a stampede guard that lookup storm takes the coordination service down too.

  • — all of these hold:
  • — the node has at least one synchronous outgoing edge to a coordination-service
  • — the node's `stampedeGuard` is false
shared-host-per-channel-without-isolation

With heavy-tail traffic a few channels carry most of the load. Assigning channels at random lands those hot channels on arbitrary hosts, and every tenant sharing a host suffers for it.

  • — all of these hold:
  • — the node's `channelAssignment` is "random"
  • — the design requirement `traffic.skew` is "heavy-tail"
stateful-websocket-scale-in-without-drain

Scaling a gateway down kills every live WebSocket on the removed instance at once. Without a drain step those clients all reconnect together.

  • — all of these hold:
  • — the node's `autoscaling` is true
  • — the node's `drainOnScaleIn` is false
Use it in a design
nodes:
  - { id: "ivs-chat", component: "aws-ivs-chat" }
Other Real-time gateway products · 19
Source
# yaml-language-server: $schema=../../schema/component.schema.json
# Amazon IVS Chat: managed live chat rooms that accompany an IVS video stream, with a WebSocket
# messaging data plane. "IVS Chat Service Quotas": 50,000 rooms per account per Region, 50,000
# concurrent chat connections per account per Region, 100 SendMessage requests per second per room,
# 10 messaging requests per second per connection, message review handler timeout 200 ms.
schemaVersion: "1"
type: "component"
id: "aws-ivs-chat"
kind: "realtime-gateway"
provider: "aws"
docs: "https://docs.aws.amazon.com/ivs/latest/ChatUserGuide/what-is.html"
defaults:
  managed: true
  protocol: "websocket"
  stateful: true
  autoscaling: true
properties:
  maxMessageRatePerSecond:
    type: "integer"
    default: 100
  concurrentConnectionsLimit:
    type: "integer"
    default: 50000
  messageReviewHandlerTimeoutMs:
    type: "integer"
    default: 200
  loggingConfiguration:
    type: "boolean"
    default: false

The same page as markdown, for an agent: /catalogue/components/aws-ivs-chat.md