# @axiomhq/winston

> The official Axiom transport for winston logger

Latest version **2.0.0** (published 2026-08-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install @axiomhq/winston
pnpm add @axiomhq/winston
yarn add @axiomhq/winston
bun add @axiomhq/winston
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2026-08-04 |
| First published | 2023-06-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20 |
| Dependencies | 2 |
| Unpacked size | 31.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | Axiom, Inc. |
| Maintainers | lukasmalkmus, kevinehosford, bahlo, mhr3, seiflotfy, flbn, gordallottaxiom, islamshehata, njpatel |
| Keywords | axiom, winston, axiom-js, axiom-winston |

## Links

- npm: https://www.npmjs.com/package/@axiomhq/winston
- Repository: https://github.com/axiomhq/axiom-js
- Homepage: https://github.com/axiomhq/axiom-js/blob/main/packages/winston/README.md
- Issues: https://github.com/axiomhq/axiom-js/issues
- npm.io page: https://npm.io/package/@axiomhq/winston

## Dependencies (2)

- [@axiomhq/js](https://npm.io/package/@axiomhq/js.md) 2.0.0
- [winston-transport](https://npm.io/package/winston-transport.md) ^4.5.0

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 2.0.0 (latest) — 2026-08-04
- 1.8.0 — 2026-06-29
- 1.7.0 — 2026-06-17
- 1.6.1 — 2026-05-06
- 1.6.0 — 2026-03-30
- 1.5.0 — 2026-03-20
- 1.4.0 — 2026-01-27
- 1.3.1 — 2024-12-16
- 1.3.0 — 2024-11-21
- 1.2.0 — 2024-09-24
- 1.1.1 — 2024-08-15
- 1.0.0 — 2024-06-12
- 1.0.0-rc.4 — 2024-06-10
- 1.0.0-rc.3 — 2024-03-20
- 1.0.0-rc.2 — 2024-02-09
- … 5 more at https://npm.io/package/@axiomhq/winston/versions

## README

# Axiom transport for Winston logger

The Axiom transport for Winston logger allows you to send data from a Node.js app to Axiom through Winston.


```ts
import { WinstonTransport as AxiomTransport } from '@axiomhq/winston';

const logger = winston.createLogger({
    level: 'info',
    format: winston.format.json(),
    defaultMeta: { service: 'user-service' },
    transports: [
        new AxiomTransport({
            dataset: 'my-dataset',
            token: 'my-token',
            axiomClient: 'my-app/1.0',
        }),
    ],
});

logger.log({
    level: 'info',
    message: 'Logger successfully setup',
});
```

The transport sends an `X-Axiom-Client` header like `axiom-js/<version> axiom-winston/<version> my-app/1.0`.

## Requirements

Node.js 20 or higher is required. Node.js 18 is no longer supported.

## Install

```bash
npm install @axiomhq/winston
```

## Documentation

For more information about how to set up and use the Axiom transport for Winston logger, see the [axiom.co/docs/guides/winston](https://axiom.co/docs/guides/winston).

## License

[MIT](../../LICENSE)

---
_Source: https://npm.io/package/@axiomhq/winston · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._