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

​
LogLevel

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];
LevelValueDescription
DEBUG0Detailed debugging information (verbose)
INFO1General operational information
WARN2Warning messages for potential issues
ERROR3Error messages only (default)
NONE4Disable all logging

​
Setting Log Level

​
At Initialization

import { initAmplifySDK, LogLevel } from "@paxoslabs/amplify-sdk";

await initAmplifySDK("pxl_your_api_key", {
  logLevel: LogLevel.DEBUG,
});

​
At Runtime

import { setLogLevel, LogLevel } from "@paxoslabs/amplify-sdk";

// Enable debug logs
setLogLevel(LogLevel.DEBUG);

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

​
Custom Logger Interface

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

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

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

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

await initAmplifySDK("pxl_your_api_key", {
  logLevel: LogLevel.DEBUG,
  telemetry: true,
});

​
Production

await initAmplifySDK("pxl_your_api_key", {
  logLevel: LogLevel.ERROR,
  telemetry: true,
  logger: yourProductionLogger,
});

​
Debugging Issues

When troubleshooting, temporarily enable debug logging: 
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 SDK Initialization.