LogoLogo
  • Introduction
  • sdks
    • Feature Comparison
    • Unity
    • Godot
    • Defold
    • LÖVE
    • Unreal
  • Quick Start
    • Unity
    • Godot
    • Defold
    • LÖVE
    • Unreal
  • Server Side
    • Entities
    • Chunks
    • Dimensions
    • Events
    • Logging
    • Lua Environment
    • Git Primer
    • Physics
  • HTTP API
    • Authentication
    • Player API
  • Api Reference
    • Entity API
      • Create
      • Message
    • Client API
      • Message
    • Dimension API
      • Create
      • Delete
      • List
    • Events API
      • on_player_join
      • on_player_leave
    • Table API
      • Append
      • Remove
      • Join
    • Util API
      • Time
      • TimeMillis
    • HTTP Request API
      • Get
      • Post
      • Put
      • Delete
    • Physics API
      • NewBody
      • NewBoxShape
      • NewSphereShape
Powered by GitBook
On this page
  • Creating Logs
  • Monitoring Logs
  • Groups
  • Entries
  • Messages
  • Errors
  • Log Limit
  1. Server Side

Logging

PreviousEventsNextLua Environment

Last updated 7 days ago

Console logs and errors from running your server-side code will appear in the section of the Planetary Processing website.

Creating Logs

While your game is running with the latest deployed version, Planetary Processing will log any or print() functions triggered by your server-side Lua code.

-- called when this entity receives a message
local function message(self, msg)
    -- print the message sent to this entity to logs  
    print(msg)
end

Logs will also be automatically created for any uncaught in the server-side code.

Monitoring Logs

The full list of logs is the located in the section of the web panel. Log are contained in batches called . Entries and groups can be filtered by , , time period, and . You can also use a keyword, to search for specific .

Log Filters Image

Groups

Entries

The most recent log entry will appear at the bottom of the table. While a log group is still active, the entries can be refreshed by clicking the word 'refresh' below the table.

Messages

Messages contain any information sent to logs using print() function. Because the logging process is asynchronous, messages will not always arrive in the logs in the exact order they are sent. Where possible variables will be printed in a pretty format, for example printed entities will display their individual field values, space-separated, starting with their ID; X, Y, Z positions; Type; and Data table.

Most tables nested within other tables will only show their memory address rather than being prettified. Very large numbers will be displayed using scientific 'e' notation.

Any individual messages greater than 512B in length will have their message truncated.

Errors

Log Limit

Rate limit exceeded [40/s]

Log groups are used to batch display logs from the same source together. The most recent log group will display at the top of the table. A log group will show the date and time of its first and last log . You can click on a log group's ID to view individual log .

Log Group Image

Logs will display information about: the time they occurred; the and they occurred in; and the printed or itself.

Log Entries Image

Errors and their stack traces are displayed in the section of the web panel, in the same way as other entries.

Many errors will also be visible directly from the panel map. Chunks which are failing or contain erroring entities will be coloured red on the map. Clicking on these will show an information icon 🛈 with the error causing the failure.

A game has the potential to produce large quantities of log entries, since each can be printing or sending errors . If the game detects too many logs in the same second, it will display this message:

logs
chunks
entry
entries
dimension
chunk
message
error
logs
logs
game
dimension
chunk
errors
errors
entries
log groups
entries
entity
every game tick