Nuxt

One-line setup for Loki logging in your Nuxt application.

Installation

pnpm add @uloki/nuxt

Setup

Add the module to nuxt.config.ts:

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ["@uloki/nuxt"],
  loki: {
    endpoint: "http://localhost:3100",
    labels: { app: "my-app", env: "production" },
    batchSize: 10,
    flushInterval: 5000,
  },
});

How It Works

The Nuxt module:

Registers as a Nuxt module (configKey: "loki")
Injects the @uloki/nitro plugin into the Nitro build
Passes config via runtimeConfig.public.loki
Auto-captures HTTP request metadata

Configuration

All standard configuration options are supported via loki key in nuxt.config.ts:

export default defineNuxtConfig({
  modules: ["@uloki/nuxt"],
  loki: {
    endpoint: string         // Loki push endpoint
    enabled?: boolean        // Enable logging (default: true)
    labels?: Record<string, string>  // Default labels
    batchSize?: number       // Entries per batch (default: 10)
    flushInterval?: number   // Max ms between flushes (default: 5000)
    redact?: (string | RegExp)[]    // Redaction patterns
  },
});

Environment-specific config

Use Nuxt's runtime config for per-environment settings:

export default defineNuxtConfig({
  modules: ["@uloki/nuxt"],
  runtimeConfig: {
    public: {
      loki: {
        endpoint: process.env.LOKI_ENDPOINT ?? "http://localhost:3100",
        enabled: process.env.NODE_ENV !== "development",
      },
    },
  },
});

Request Logging

Requests are automatically logged with method, path, status, and duration — same as the Nitro integration.

Requirements

Nuxt >= 3.12
Node.js >= 22