Home

Awesome

Palworld Exporter

GitHub release Docker image version Docker image size GitHub CI status codecov Go Report Card

Exports Palworld dedicated server metrics for prometheus.

Prerequisites

Palworld exporter relies on Palworld REST API. Set RESTAPIEnabled=True on your PalWorldSettings.ini.

Usage

usage: palworld_exporter [<flags>]


Flags:
  -h, --[no-]help             Show context-sensitive help (also try --help-long and --help-man).
      --web.listen-address=":18212"  
                              Address to expose metrics. ($LISTEN_ADDRESS)
      --scrape_uri="http://localhost:8212/v1/api/metrics"  
                              URI to Palworld REST API metrics endpoint. ($SCRAPE_URI)
      --http_user="admin"     Username for Palworld REST API basic authentication. ($HTTP_USER)
      --http_password=HTTP_PASSWORD  
                              Password for Palworld REST API basic authentication. ($HTTP_PASSWORD)
      --log.level="info"      Only log messages with the given severity or above. Valid levels: [debug, info, warn, error] ($LOG_LEVEL)
      --log.format="default"  Output format of log messages. Valid formats: [default, text, json] ($LOG_FORMAT)
      --[no-]version          Show application version.

Options can be set both as command-line arguments and environments variables.

Docker

docker run -e SCRAPE_URI=<your server endpoint> -e HTTP_PASSWORD=<your server password> -p 18212:18212 --rm jimmysharp/palworld_exporter

Metrics

NameDescriptionType
palworld_upThe status of the last scrape: 1 for success and 0 for failedGauge
palworld_server_fpsThe server FPSGauge
palworld_current_player_numThe number of current playersGauge
palworld_server_frame_timeServer frame time (ms)Gauge
palworld_max_player_numThe maximum number of playersGauge
palworld_uptimeThe server uptime of secondsCounter

License

MIT