Realtime

Operational Error Codes

List of operational codes to help understand your deployment and usage.


Error codeDescriptionAction
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.