---
title: Logs module
description: Aggregate structured logs from your services with search, filters, and tail.
section: Modules
order: 4
updatedAt: 2026-04-27
slug: modules/logs
---
# Logs module

The logs module is a low-noise structured log store. It indexes by `level`, `module`, and `service`, but does not attempt to compete with full-text logging stores. Cuitty assumes you keep heavy log volumes elsewhere — ship the high-signal subset here.

## Event shape

```json
{
  "type": "log",
  "ts": "2026-04-27T13:00:00Z",
  "data": {
    "level": "info",
    "message": "request processed",
    "module": "api",
    "service": "api",
    "fields": {
      "requestId": "abc",
      "userId": "user_123"
    }
  }
}
```

## Pino bridge

The TypeScript SDK ships a Pino multistream adapter so adding Cuitty as a destination is one line:

```typescript
cuitty.use(logsPlugin({ logger: pino, minLevel: "info" }));
```