This guide covers how to read the debug logs and debug your Ditto app.
app_id
log line contains your AppID:
ditto.auth.logout()
and reconnect to the Internet to get a new certificate. Alternatively, you can clear the local cache by reinstalling the mobile application or clearing the local persistence directory.
Discovered
event.
ConnectionEstablished
event:
StreamFailed
or ConnectionEnded
or any errors related to WebSocket connection with the Big Peer, there is likely an error in the Big Peer subscription server. For troubleshooting help, contact Ditto support.
phy started
.
The pkSOME_BYTES identifer displays the public key to the Big Peer instance that
a Small Peer WebSocket connection has temporary sync access.
Note that the following snippet is merely an example; the pkSOME_BYTES
identifer is not a guaranteed static variable.
__
) before the collection name; for example, the following default internal __presence
subscription:
ParseError
can be printed in the debug logs when there is a problem with your query. For example, if you create a subscription in Swift that is the empty string, you will see a ParseError
in the logs.
OnlinePlayground
applications must connect to the Big Peer first before going offline. Read more about online playground.
invalid certificate: UnknownIssuer
. If you see this log message you will either need to get Ditto unblocked or add the CA certificate to the Small Peer’s trusted certificate store.
Verify that you can reach the following endpoints. You should see the output exactly as written below:
authenticationExpiringSoon
and authenticationRequired
both need to be
implemented according to the sample code.my-auth
).
OnlineWithAuthentication
,
ditto.refreshPermissions()
?TransportConfig
, make sure you have enabled all peer-to-peer transports using enableAllPeerToPeer()
.findAll()
because you can sync more data than the small peer can reasonably handle.stop
or cancel
API. See syncing data for more information.
Time (t) a transaction has been blocked | Log Level |
---|---|
t ≤ 30s | DEBUG |
31s < t ≤ 120s | WARN |
120s < t | ERROR |
Originator / Blocked By | Description |
---|---|
”User” | Any user-level API which modifies data. |
”Internal” | An internal job (presence data, DB maintenance, etc.). |
”Replication” | Updating the store with data received via replication. |