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