---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../modules.md) / operations/logs

# operations/logs

Log operations for B2C Commerce instances.

This module provides functions for listing, tailing, and analyzing log files
on B2C Commerce instances via WebDAV.

## Examples

List log files:
```typescript
import { listLogFiles } from '@salesforce/b2c-tooling-sdk/operations/logs';

const files = await listLogFiles(instance, {
  prefixes: ['error', 'customerror'],
  sortBy: 'date',
  sortOrder: 'desc'
});

for (const file of files) {
  console.log(`${file.name} (${file.size} bytes)`);
}
```

Tail logs in real-time:
```typescript
import { tailLogs, createPathNormalizer } from '@salesforce/b2c-tooling-sdk/operations/logs';

const normalizer = createPathNormalizer({ cartridgePath: './cartridges' });

const { stop, done } = await tailLogs(instance, {
  prefixes: ['error', 'customerror'],
  pathNormalizer: normalizer,
  onEntry: (entry) => {
    console.log(`[${entry.file}] ${entry.level}: ${entry.message}`);
  },
  onError: (err) => console.error('Error:', err),
});

// Stop after 30 seconds
setTimeout(() => stop(), 30000);

await done;
```

Get recent logs (one-shot):
```typescript
import { getRecentLogs } from '@salesforce/b2c-tooling-sdk/operations/logs';

const entries = await getRecentLogs(instance, {
  prefixes: ['error'],
  maxEntries: 50
});

for (const entry of entries) {
  console.log(`[${entry.timestamp}] ${entry.message}`);
}
```

## Interfaces

- [GetRecentLogsOptions](interfaces/GetRecentLogsOptions.md)
- [ListLogsOptions](interfaces/ListLogsOptions.md)
- [LogEntry](interfaces/LogEntry.md)
- [LogFile](interfaces/LogFile.md)
- [PathNormalizerOptions](interfaces/PathNormalizerOptions.md)
- [TailLogsCallbacks](interfaces/TailLogsCallbacks.md)
- [TailLogsOptions](interfaces/TailLogsOptions.md)
- [TailLogsResult](interfaces/TailLogsResult.md)

## Functions

- [aggregateLogEntries](functions/aggregateLogEntries.md)
- [createPathNormalizer](functions/createPathNormalizer.md)
- [discoverAndCreateNormalizer](functions/discoverAndCreateNormalizer.md)
- [extractPaths](functions/extractPaths.md)
- [extractPrefix](functions/extractPrefix.md)
- [getRecentLogs](functions/getRecentLogs.md)
- [listLogFiles](functions/listLogFiles.md)
- [parseLogEntry](functions/parseLogEntry.md)
- [splitLines](functions/splitLines.md)
- [tailLogs](functions/tailLogs.md)