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.
Learn more:
Your project may have been suspended for exceeding usage quotas. Contact support with your project reference ID and a description of your Realtime use case.
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 not 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.