Skip to content

Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.

Merge remote-tracking branch 'origin/telemetry-tenant-read' into scale-core

Abel Dantas288a5561f4f7
diff --cc CHANGELOG.md
index 6a585ac1a,c47dcb533..a3e85e489
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -159,89 -159,14 +159,97 @@@ version of their own to them without al
compares it only when someone signs in.
#### Changed
+- **Workspaces belong to organizations. Upgrade by replacing every pod, and
+ downgrade the database before rolling back.** Every existing workspace gets
+ an organization of its own, and its owners become the organization's admins.
+ An organization admin administers every workspace in it without being added
+ to each. A release from before organizations doesn't know about organization
+ admins: if old and new pods serve together during a rolling update, or after
+ a rollback that keeps the new database, an owner removed from a workspace by
+ an old pod is still the organization's admin and can come back into it. So
+ for this release, replace every switch-core pod at once rather than rolling
+ them, and to roll back, first downgrade the database to the revision before
+ `238c68b7306e` (`alembic downgrade 238c68b7306e-1`), then start the older
+ release.
+- **The statements every message write costs run on asyncpg directly.**
+ Taking the room's lock, reading its head, storing the agents' own events
+ and reading the room's agent members again under the lock go straight to
+ asyncpg on the transaction's connection (`db/raw.py`), as the delivery
+ reads do, rather than through SQLAlchemy's execution.
+- **The two reads behind every delivery run on asyncpg directly.** A
+ stream reads an agent's events, and counts its unread messages, for every
+ event it delivers, and under load SQLAlchemy's work around each statement
+ cost more than Postgres took to run it. `db/raw.py` runs a statement
+ SQLAlchemy compiled once on the session's own asyncpg connection, in its
+ transaction and under its tenant, with SQLAlchemy's type conversions and
+ timed into `db.query.duration` as every other statement is.
+- **Pods start in seconds again with many rooms.** Every process checks at
+ startup that each room has its clients, under a lock that lets one
+ process at a time through, and read each room on its own to do it. With
+ tens of thousands of rooms that took about 100 seconds, so processes
+ starting together were restarted while they waited. Rooms are now read a
+ thousand at a time.
+- **Idle agents behind a controller cost the database far less.** A
+ controller stream's pass, including the one after every idle interval,
+ read each of its agents' events in a session of its own; it now reads all
+ their heads in one query and reads only the agents with something new. And
+ each process's 30-second re-check of controllers held by another process
+ read every agent's rooms with a query of its own, which grew with
+ processes times agents; it is now one query per controller.
+- **A delivery to an agent behind a controller takes two database
+ transactions instead of four.** The controller's stream read the heads of
+ all its agents to find the work, again after delivering, and again before
+ waiting. It now reads them once a pass, and an event that arrives after
+ that read wakes the stream for the next pass.
+- **A controller keeps its socket when a delivery pass cannot get a
+ database connection.** When a pod was too busy to hand its streams a
+ connection within the pool timeout, the controller's stream ended and its
+ socket closed, and every agent on it reconnected, which needs more of
+ what was short. The pass is now tried again after a short wait, doubling
+ to 5 seconds, and the socket closes only if it is still failing after a
+ minute.
+- **Switch's own reader is woken only by commands.** The process that holds
+ a workspace's admin client read every row of every room to find the
+ `!command` rows it answers. A new row's announcement now names its type,
+ and that reader is woken for command rows only and reads only those, from
+ a partial index on them. Its warnings for tags nobody can answer are
+ already posted by the process that writes the message.
+- **The heads-up for tagging an agent that isn't in the room comes from the
+ process that wrote the message, and costs nothing when every name tagged
+ is one of the room's agents.** The admin's consumer, which reads every
+ message in a workspace on one process, checked each message with an `@`:
+ two database sessions and a lookup for every name tagged. Under load that
+ one process fell behind the rest. The check now runs once a message has
+ committed, on whichever process wrote it, and only when the message tags
+ a name that is none of the room's agents (a role, a person, an agent not
+ in the room). The warnings read as before.
+- **The server spends less CPU on its event loop and on finding the agent
+ sending a message.** It now runs on uvloop wherever uvloop is installed,
+ which is every platform but Windows. Finding the actor of the agent
+ sending a message no longer looks through every client's actor, and
+ compiled mention patterns are kept per name. In a CPU profile under
+ message load the event loop's own work was about 15% of a pod's CPU and
+ the actor lookup about 3%.
+- **Creating a room or an agent no longer looks through every running
+ client.** Every process keeps an actor for every client, and finding a
+ workspace's admin, or the actor of an agent registered in another process
+ a moment before, read all of them. Each is now found from an index of the
+ running clients by type and by agent. While 10,000 agents were being
+ created, these lookups took about 11% of a process's CPU in a profile.
+- **Each database transaction costs the server a little less.** Binding the
+ workspace to a transaction built and compiled the same statement every
+ time; it is now sent to the driver as it is. And timing who holds a pooled
+ connection worked out the borrower's name and a short stack on every
+ checkout; the name is now kept per function, and the stack is written out
+ only for a hold long enough to log.
+ - **Usage analytics read the database far less per message in a large
+ workspace.** With usage reporting on, each message looked up its room's
+ platform and member counts, its sender and the agent's runtime, each kept
+ for five minutes in caches of at most 10,000 entries. Quiet rooms missed
+ every time, and with thousands of agents the caches evicted what they were
+ about to be asked again. A room's facts are now kept for fifteen minutes,
+ a sender and an agent's runtime, which do not change, for an hour, and up
+ to 50,000 of each.
- **An agent's stream reads in one database session per pass, and pooled
connections are no longer pinged before use.** A pass that delivered a
message opened a session for each of its reads, six pool checkouts and six
@@@ -307,30 -232,10 +315,34 @@@
group whose subgroup would move up next to a namesake is refused too, and
the dashboard now shows why. Names can no longer contain `/` or be blank.
Existing duplicates are left as they are and can be reached by id.
+- **Delivering an event to an agent behind a controller no longer reads the
+ agent's head first.** The notification of a new agent event already carries
+ its number, and the controller's stream now keeps it as the agent's head, so
+ a delivery costs the agent's own read alone, where it read the heads of all
+ the controller's agents first. The heads are still read after each idle
+ interval, when an agent is attached, and after the listener reconnects.
+- **Delivering an event to an agent costs three statements, where it cost
+ seven.** The rooms dropped after the agent's cursor are read with its
+ events, and the unread count reads the agent's baseline, the room's window
+ and the agent's user id in the statement that counts.
+- **Writing a message no longer costs four statements for each agent it is
+ for.** The agents' own events are stored together, in two statements and
+ one savepoint, where each agent's event took a savepoint, a numbering, an
+ insert and a release of its own.
+- **A controller's stream waits on three events, where it waited on one per
+ agent and two more.** Every attached agent's doorbell now rings the stream's
+ one bell.
+- **Reading an agent's own events no longer builds its query each time.**
+ Each shape of the read is built once and run with bind parameters.
+- **A message addressed to a connected agent no longer reads the agent's
+ membership after it commits.** That read stops an agent removed from the
+ room in the meantime from saying anything there, and a connected agent has
+ nothing to say about a message addressed to it, so the read is now made only
+ before a refusal or an offline notice is posted, or a machine woken.
+ - **Message telemetry reads a workspace's rooms, clients and agents at once.**
+ The first lookup that misses reads all of them, where each room, sender and
+ agent was read on its own, so in a large workspace most messages no longer
+ cost a lookup.
#### Fixed
- **On Slack, the 👀 and the activity card no longer arrive after the agent's