NATIVE ATLASA field guide for builders
GRAND THEFT AUTO V
Connect your AI
From the reference libraryFiveM

Server

ox/ox_lib/Logger/Server.mdx

Server

lib.logger

lib.logger(source, event, message, ...)
  • source: number or string
    • Preferably an active player id, otherwise an identifier, or wherever else it originated from.
  • event: string
    • A name for the log event (i.e. the trigerring event or a description)
  • message: string
    • The content for the log.
  • vararg: string
    • Additional arguments are converted to tags for additional filtering and searching.

<br /> <u>Example</u>

local vehicle = Ox.CreateVehicle(false, `sultanrs`, vector4(-56.479122, -1116.870362, 26.432250, 0.000030517578))
lib.logger(-1, 'CreateVehicle', json.encode(vehicle))

Datadog > Create your Datadog account [step]

You will receive a free 14 day trial, otherwise refer to their pricing guide.
Free accounts are limited, however logs will still be retained for 14 days.

Datadog > Create an API key [step]

This is a UUID used to submit logs to your Datadog organisation.

Datadog > Config [step]

Set your API key and Datadog site using the following convars.

set datadog:key "yourapikey"
set datadog:site "datadoghq.com"

Grafana Loki

Loki is a horizontally scalable, highly available, multi-tenant log aggregation system inspired by Prometheus.
It is designed to be very cost effective and easy to operate.

- Has free tier with some restrictions
- Easy to manage
- Easier to setup
- Mostly managed by Grafana

### Create your [Grafana](https://grafana.com/) account [step]
### Head to [My Account](https://grafana.com/auth/sign-in/?plcmt=top-nav&cta=myaccount) [step]
### Setup Loki [step]
Find the Loki section in your account panel, and click "Details".
Generate a password and save the API key, as well as your `user` and `url`.



To setup a grafana instance you'll need docker, and knowledge on containers or kubernetes.  
Please find a guide to setup a grafana stack (min requirement grafana and grafana loki) and follow that.

Once done, setup authentication and use the username and password securing your endpoint.

- By default self-hosted loki instances do not provide any authentication layers and will require an external authentication layer such as NGINX basic auth or Cloudflare Access.

Grafana Loki > Config

Use the following convars to set your logging service, endpoint, and authentication details.

set ox:logger "loki"
set loki:user "<insert your user>"
set loki:password "<insert the api key or password>"
set loki:endpoint "<insert loki url without http:// or https://>"

Fivemanage

Fivemanage is an easy-to-use, all-in-one SaaS for game servers that provides logging.

Fivemanage > Create an account [step]

Sign up at Fivemanage.

Fivemanage > Create an account [step] > Upgrading to Hobby or Pro tier (optional) [step]

Logging is included in the free tier, but with limited storage and retention.

If you decide to upgrade, you'll get a 14-day free trial if you do not already have a subscription. You can find more information here and on the pricing page.

Fivemanage > Create a new token [step]

You'll need to create a new token with the type Logs.

Fivemanage > Config [step]

set ox:logger "fivemanage"
set fivemanage:key "YOUR_API_KEY"
Back to documentation