Logister Documentation Getting started
Documentation / Getting started

Set up your first Logister project.

Logister works best when you start from your own instance, create a clean project, generate an API token, and then choose the integration path that matches your application stack.

Guide overview

Start here if you are setting up Logister for the first time.

This page covers the product-side setup flow after you have a self-hosted Logister instance running, or after you choose the secondary hosted app. Once you have a project and API token, move into the integration guide for Ruby, .NET, Python, JavaScript, Android, iOS, CFML, or Manual / HTTP API depending on what your app runs.

Getting started

Every setup begins with a project.

In Logister, a project represents one monitored app or service. Each project has its own API keys, settings, events, monitors, and integration guidance. If a service is retired later, archive the project to keep its history while removing it from active dashboards and project lists.

Core flow

How data moves into Logister.

  1. Create a project for the app you want to monitor.
  2. Generate an API key for that project.
  3. Send events to /api/v1/ingest_events or check-ins to /api/v1/check_ins.
  4. Review errors, performance data, activity, and monitors in the project pages.

The public ingestion APIs accept 1,200 requests per minute per API token per endpoint by default. Clients that exceed the limit receive 429 Too Many Requests with retry headers. App admins can set project-level overrides when a specific project needs a different limit.

Create a project

Choose the integration type that matches your app.

Integration type Best for
Ruby package Ruby apps and Rails services using logister-ruby
.NET / ASP.NET Core .NET 8+ apps, ASP.NET Core services, C# workers, and custom metrics using Logister or Logister.AspNetCore from logister-dotnet
Python FastAPI, Django, Flask, Celery, and Python apps using logister-python, including Python logging capture
CFML Lucee and Adobe ColdFusion apps sending direct HTTP payloads
JavaScript / TypeScript JavaScript and TypeScript apps using logister-js, including optional Express middleware and console capture
Manual / HTTP API Unsupported runtimes, one-off scripts, workers, cron tasks, and custom clients that send direct JSON payloads with a project API token

Generate an API key

Create the token your app will use.

API keys are generated per project from project settings. The token is shown once at creation time, so copy it into your environment or secret manager right away. Archived projects cannot generate new tokens, and archiving a project disables active tokens for that project.

Important

The token is not shown again after creation. Store it before you leave the settings page. If you restore an archived project and want it to send events again, generate a fresh token.

Choose an integration

Move into the guide that matches your app stack.

Python

Use the Python package

Best if your app runs on FastAPI, Django, Flask, Celery, or another Python runtime and you want the logister-python client plus framework helpers and logging support.

Read Python integration docs or open the PyPI package.

Android

Use the Maven package

Best if your app is a Kotlin or Java Android app and you want errors, logs, metrics, transactions, spans, check-ins, release context, and safe device metadata.

Read Android integration docs or open Maven Central.

iOS

Use the Swift package

Best if your app is a Swift iOS app and you want async telemetry methods for errors, logs, metrics, transactions, spans, check-ins, release context, and safe device metadata.

Read iOS integration docs or open the SwiftPM release.

CFML

Send direct payloads

Best if your app runs on Lucee or Adobe ColdFusion and sends events over HTTP.

Read CFML integration docs

Manual / HTTP API

Send JSON directly

Best if your runtime does not have a first-party add-on yet, or you want cURL, Swagger, or Postman examples before writing a custom client.

Read HTTP API docs or open the API reference.

Verify setup

Confirm that your project is ready for ingestion.

Setup checklist
Project created
Integration type selected
API key generated and copied once
Destination guide chosen
Base URL for your Logister instance confirmed
One test event visible in the project inbox or activity feed
Insights tab shows the event in the summary, timeline, or recent stream
Check-in visible on the monitors page if you are instrumenting scheduled work

Next step

Once those items are done, move into the Ruby, .NET, Python, JavaScript, Android, iOS, CFML, or Manual / HTTP API guide and send one test event first.

Insights

Open the project Insights tab after your first events arrive.

Insights is the fastest way to confirm what Logister is collecting for a project. Open the project, choose the Insights tab, start with the 24h window, and check whether the summary, event mix, metric catalog, and recent stream match the data you expected to send.

  • If the page only shows errors, add logs, metrics, transactions, spans, or check-ins from your integration so the dashboard has more signals to combine.
  • If environment or release filters are empty, make sure your client sends consistent environment and release values.
  • If custom attribute filters are not useful, add stable top-level context keys such as service, region, queue, route, or tenant_tier.
  • If custom metric value charts are missing, send numeric metric values in context.value with a stable metric name.

Read the Insights guide for dashboard recipes, or use the metrics reference for supported telemetry, add-on coverage, reporting fields, and data collection boundaries.