Operational Error Codes
List of operational codes to help understand your deployment and usage.
| Error code | Description | Action | 
|---|---|---|
ChannelRateLimitReached | The number of channels you can create has reached its limit.  | |
ClientJoinRateLimitReached | The rate of joins per second from your clients has reached the channel limits.  | |
ConnectionInitializing | Database is initializing connection.  | |
ConnectionRateLimitReached | The number of connected clients has reached its limit.  | |
DatabaseConnectionIssue | Database had connection issues and connection was not able to be established.  | |
DatabaseLackOfConnections | Realtime was not able to connect to the tenant's database due to not having enough available connections. Learn more:  | Verify your database connection limits.  | 
ErrorAuthorizingWebsocket | Error when trying to authorize the WebSocket connection.  | Verify user information on connect.  | 
ErrorConnectingToWebsocket | Error when trying to connect to the WebSocket server.  | Verify user information on connect.  | 
ErrorExecutingTransaction | Error executing a database transaction in tenant database.  | |
ErrorOnRpcCall | Error when calling another realtime node.  | |
ErrorStartingPostgresCDC | Error when starting the Postgres CDC extension which is used for Postgres Changes.  | |
ErrorStartingPostgresCDCStream | Error when starting the Postgres CDC stream which is used for Postgres Changes.  | |
IncreaseConnectionPool | The number of connections you have set for Realtime are not enough to handle your current use case.  | |
InitializingProjectConnection | Connection against Tenant database is still starting.  | |
InvalidJWTExpiration | JWT exp claim value it's incorrect.  | |
JanitorFailedToDeleteOldMessages | Scheduled task for realtime.message cleanup was unable to run.  | |
JwtSignatureError | JWT signature was not able to be validated.  | |
MalformedJWT | Token received does not comply with the JWT format.  | |
MigrationCheckFailed | Check to see if we require to run migrations fails.  | |
MigrationsFailedToRun | Error when running the migrations against the Tenant database that are required by Realtime.  | |
PartitionCreationFailed | Error when creating partitions for realtime.messages.  | |
PoolingReplicationError | Error when pooling the replication slot.  | |
PoolingReplicationPreparationError | Error when preparing the replication slot.  | |
RealtimeDisabledForConfiguration | The configuration provided to Realtime on connect will not be able to provide you any Postgres Changes.  | Verify your configuration on channel startup as you might not have your tables properly registered.  | 
RealtimeDisabledForTenant | Realtime has been disabled for the tenant.  | |
RealtimeNodeDisconnected | Realtime is a distributed application and this means that one the system is unable to communicate with one of the distributed nodes.  | |
RealtimeRestarting | Realtime is currently restarting.  | |
ReconnectSubscribeToPostgres | Postgres changes still waiting to be subscribed.  | |
ReplicationMaxWalSendersReached | Maximum number of WAL senders reached in tenant database. Learn more:  | |
ReplicationSlotBeingUsed | The replication slot is being used by another transaction.  | |
RlsPolicyError | Error on RLS policy used for authorization.  | |
StartListenAndReplicationFailed | Error when starting the replication and listening of errors for database broadcasting.  | |
SubscriptionDeletionFailed | Error when trying to delete a subscription for postgres changes.  | |
SynInitializationError | Our framework to syncronize processes has failed to properly startup a connection to the database.  | |
TableHasSpacesInName | The table you are trying to listen to has spaces in its name which we are unable to support.  | Change the table name to not have spaces in it.  | 
TenantNotFound | The tenant you are trying to connect to does not exist.  | Verify the tenant name you are trying to connect to exists in the realtime.tenants table.  | 
TimeoutOnRpcCall | RPC request within the Realtime server has timed out.  | |
TopicNameRequired | You are trying to use Realtime without a topic name set.  | |
UnableCheckoutConnection | Error when trying to checkout a connection from the tenant pool.  | |
UnableToCheckProcessesOnRemoteNode | Error when trying to check the processes on a remote node.  | |
UnableToConnectToProject | Unable to connect to Project database.  | |
UnableToConnectToTenantDatabase | Realtime was not able to connect to the tenant's database.  | |
UnableToCreateCounter | Error when trying to create a counter to track rate limits for a tenant.  | |
UnableToDecrementCounter | Error when trying to decrement a counter to track rate limits for a tenant.  | |
UnableToDeletePhantomSubscriptions | Error when trying to delete subscriptions that are no longer being used.  | |
UnableToDeleteTenant | Error when trying to delete a tenant.  | |
UnableToEncodeJson | An error were we are not handling correctly the response to be sent to the end user.  | |
UnableToFindCounter | Error when trying to find a counter to track rate limits for a tenant.  | |
UnableToIncrementCounter | Error when trying to increment a counter to track rate limits for a tenant.  | |
UnableToListenToTenantDatabase | Unable to LISTEN for notifications against the Tenant Database.  | |
UnableToProcessListenPayload | Payload sent in NOTIFY operation was JSON parsable.  | |
UnableToSetPolicies | Error when setting up Authorization Policies.  | |
UnableToSubscribeToPostgres | Error when trying to subscribe to Postgres changes.  | |
UnableToTrackPresence | Error when handling track presence for this socket.  | |
UnableToUpdateCounter | Error when trying to update a counter to track rate limits for a tenant.  | |
Unauthorized | Unauthorized access to Realtime channel.  | |
UnhandledProcessMessage | Unhandled message received by a Realtime process.  | |
UnknownDataProcessed | An unknown data type was processed by the Realtime system.  | |
UnknownErrorOnChannel | An error we are not handling correctly was triggered on a channel.  | |
UnknownErrorOnController | An error we are not handling correctly was triggered on a controller.  | |
UnknownPresenceEvent | Presence event type not recognized by service.  | |
UnprocessableEntity | Received a HTTP request with a body that was not able to be processed by the endpoint.  |