> ## Documentation Index
> Fetch the complete documentation index at: https://developers.paxoslabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logging

> Configure SDK logging levels and integrate custom loggers

The Amplify SDK includes configurable logging to help debug integration issues and monitor SDK behavior in production.

## LogLevel

```ts theme={null}
export const LogLevel = {
  DEBUG: 0, // Detailed debugging information
  INFO: 1, // General operational information
  WARN: 2, // Warning messages
  ERROR: 3, // Error messages only
  NONE: 4, // Disable all logging
} as const

export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel]
```

| Level   | Value | Description                              |
| ------- | ----- | ---------------------------------------- |
| `DEBUG` | 0     | Detailed debugging information (verbose) |
| `INFO`  | 1     | General operational information          |
| `WARN`  | 2     | Warning messages for potential issues    |
| `ERROR` | 3     | Error messages only (default)            |
| `NONE`  | 4     | Disable all logging                      |

## Setting Log Level

### At Initialization

```ts theme={null}
import { initAmplifySDK, LogLevel } from '@paxoslabs/amplify-sdk'

await initAmplifySDK('pxl_your_api_key', {
  logLevel: LogLevel.DEBUG,
})
```

### At Runtime

```ts theme={null}
import { setLogLevel, LogLevel } from '@paxoslabs/amplify-sdk'

// Enable debug logs
setLogLevel(LogLevel.DEBUG)

// Disable all logs
setLogLevel(LogLevel.NONE)
```

## Custom Logger Interface

```ts theme={null}
export interface Logger {
  debug(message: string, context?: Record<string, unknown>): void
  info(message: string, context?: Record<string, unknown>): void
  warn(message: string, context?: Record<string, unknown>): void
  error(message: string, context?: Record<string, unknown>): void
}
```

## Custom Logger Examples

### Basic Console Logger

```ts theme={null}
import { initAmplifySDK, LogLevel } from '@paxoslabs/amplify-sdk'

await initAmplifySDK('pxl_your_api_key', {
  logLevel: LogLevel.DEBUG,
  logger: {
    debug: (msg, ctx) => console.debug(`[Amplify] ${msg}`, ctx),
    info: (msg, ctx) => console.info(`[Amplify] ${msg}`, ctx),
    warn: (msg, ctx) => console.warn(`[Amplify] ${msg}`, ctx),
    error: (msg, ctx) => console.error(`[Amplify] ${msg}`, ctx),
  },
})
```

### Winston Integration

```ts theme={null}
import winston from 'winston'
import { initAmplifySDK, LogLevel } from '@paxoslabs/amplify-sdk'

const winstonLogger = winston.createLogger({
  level: 'debug',
  format: winston.format.json(),
  transports: [new winston.transports.Console()],
})

await initAmplifySDK('pxl_your_api_key', {
  logLevel: LogLevel.DEBUG,
  logger: {
    debug: (msg, ctx) => winstonLogger.debug(msg, ctx),
    info: (msg, ctx) => winstonLogger.info(msg, ctx),
    warn: (msg, ctx) => winstonLogger.warn(msg, ctx),
    error: (msg, ctx) => winstonLogger.error(msg, ctx),
  },
})
```

### Pino Integration

```ts theme={null}
import pino from 'pino'
import { initAmplifySDK, LogLevel } from '@paxoslabs/amplify-sdk'

const pinoLogger = pino({ level: 'debug' })

await initAmplifySDK('pxl_your_api_key', {
  logLevel: LogLevel.DEBUG,
  logger: {
    debug: (msg, ctx) => pinoLogger.debug(ctx, msg),
    info: (msg, ctx) => pinoLogger.info(ctx, msg),
    warn: (msg, ctx) => pinoLogger.warn(ctx, msg),
    error: (msg, ctx) => pinoLogger.error(ctx, msg),
  },
})
```

## Production Recommendations

### Development

```ts theme={null}
await initAmplifySDK('pxl_your_api_key', {
  logLevel: LogLevel.DEBUG,
  telemetry: true,
})
```

### Production

```ts theme={null}
await initAmplifySDK('pxl_your_api_key', {
  logLevel: LogLevel.ERROR,
  telemetry: true,
  logger: yourProductionLogger,
})
```

### Debugging Issues

When troubleshooting, temporarily enable debug logging:

```ts theme={null}
import { setLogLevel, LogLevel } from '@paxoslabs/amplify-sdk'

// Enable verbose logging
setLogLevel(LogLevel.DEBUG)

// ... perform problematic operation ...

// Restore normal logging
setLogLevel(LogLevel.ERROR)
```

For SDK initialization options, see [initAmplifySDK](/v0.5.2/intro/products/earn/developers/api/initAmplifySDK).