App Logs

App Logs groups repeated runtime failures into issues while retaining event stack traces, breadcrumbs, request, user, device, runtime, and release context. Use Set Up App Logs for generated SDK code.

What is captured

SDKs capture uncaught exceptions, unhandled promise rejections, console errors/warnings, failed HTTP requests, and resource-load failures. Raw senders submit message and/or exception.

Project-key prerequisite

Create the shared Feedback/App Logs key in Settings → API Key. See API Key.

Supported SDK runtimes

App tab	Package	Environment variable
Next.js	`@aiolaapp/logger`	`NEXT_PUBLIC_AIOLA_KEY`
React	`@aiolaapp/logger`	`VITE_AIOLA_KEY`
Node.js	`@aiolaapp/logger`	`AIOLA_KEY`
Edge Function	`npm:@aiolaapp/logger`	`AIOLA_KEY`
Python	`aiola`	`AIOLA_KEY`

Raw HTTP/no-SDK integration

Swift, Kotlin, Go, React Native, shell, and other HTTP-capable runtimes can post the contract directly. The generated raw example is in Set Up App Logs.

Endpoint, authentication, and payload contract

Method	URL	Authentication
`POST`	`https://aiola.app/api/app-logs-ingest`	Preferred `x-aiola-key`; Bearer also accepted

{
  "message": "Checkout failed",
  "level": "error",
  "exception": {
    "type": "PaymentError",
    "value": "Card declined",
    "stacktrace": { "frames": [{ "filename": "checkout.ts", "function": "submit", "lineno": 128, "colno": 4, "context_line": "await pay()", "pre_context": [], "post_context": [], "in_app": true }] }
  },
  "tags": { "screen": "checkout" },
  "breadcrumbs": [{ "timestamp": "2026-09-19T12:00:00Z", "category": "http", "message": "POST /pay", "level": "error", "data": {} }],
  "request": { "url": "https://example.com/pay", "method": "POST", "headers": {}, "query_string": "", "body": "{}" },
  "environment": "production",
  "release": "1.4.2",
  "platform": "javascript",
  "timestamp": "2026-09-19T12:00:00Z",
  "user": { "id": "u_123", "email": "you@example.com", "username": "you", "ip_address": "203.0.113.1" },
  "contexts": {
    "browser": { "name": "Chrome", "version": "140" },
    "os": { "name": "macOS", "version": "15" },
    "device": { "type": "desktop", "model": "", "brand": "Apple" },
    "runtime": { "name": "node", "version": "24" }
  }
}

The dashboard understands fatal, error, warning, info, and debug. The ingest endpoint accepts and stores any supplied string; when level is absent or empty, it stores error.

Payload truncation and redaction

Data	Limit
`message`, `exception.value`	8,192 characters, then truncation marker
Breadcrumbs	Last 100
Stack frames	First 200
Tags	First 50
Tag/header value	500 characters
Request body	4,096 characters, then truncation marker

Request headers removed case-insensitively: authorization, cookie, set-cookie, x-aiola-key, x-api-key, x-auth-token, proxy-authorization.

Rate limits

The per-project ingest rate is logs_rate_limit_per_minute; a missing/zero configured value falls back to 60 events per minute. Exceeding it returns 429.

Automatic capture and manual capture

SDK initialization enables automatic capture for its runtime. Manual methods are Aiola.captureException, Aiola.captureMessage, aiola.capture_exception, and aiola.capture_message; exact calls are in the setup guide.

Grouping/fingerprinting and statuses

The group hash combines project name, exception type, and normalized message. Normalization replaces query/hash parameter values, hexadecimal values, UUIDs, numbers of four or more digits, quoted strings longer than 20 characters, and IPv4 addresses.

Statuses
`open`, `in_progress`, `human_review`, `closed`, `ignored`

Source maps and release matching

Upload source maps under the exact release sent in release or tags.release. Ingest looks up maps by project key and release before storing resolved frames. Settings → App Logs → Source Maps groups uploads by release and can delete a whole release.

Setup Health

Setup Health detects outdated JavaScript logger versions and legacy hardcoded endpoints. Its Update logger action updates a package directory inside the workspace when it declares @aiolaapp/logger.

Project and central triage workflows

Workspace App Logs filters by status, time, environment, browser, OS, device, country, and HTTP status; issue actions include status, Analyze, Fix It, copy, and delete. Central → App Logs merges project-tagged groups while retaining project context; it is not another endpoint.

Retention

Groups with status closed or ignored are deleted 30 days after their last event. Groups with status open, in_progress, or human_review are not removed by this cleanup function.

Getting Started

Workspaces & Central

Chat & AI

Project Operations

Monitoring

Connections

Settings

Setup Guides

Reference

What is captured

Project-key prerequisite

Supported SDK runtimes

Raw HTTP/no-SDK integration

Endpoint, authentication, and payload contract

Payload truncation and redaction

Rate limits

Automatic capture and manual capture

Grouping/fingerprinting and statuses

Source maps and release matching

Setup Health

Project and central triage workflows

Retention

​What is captured

​Project-key prerequisite

​Supported SDK runtimes

​Raw HTTP/no-SDK integration

​Endpoint, authentication, and payload contract

​Payload truncation and redaction

​Rate limits

​Automatic capture and manual capture

​Grouping/fingerprinting and statuses

​Source maps and release matching

​Setup Health

​Project and central triage workflows

​Retention

What is captured

Project-key prerequisite

Supported SDK runtimes

Raw HTTP/no-SDK integration

Endpoint, authentication, and payload contract

Payload truncation and redaction

Rate limits

Automatic capture and manual capture

Grouping/fingerprinting and statuses

Source maps and release matching

Setup Health

Project and central triage workflows

Retention