Node.js SDK for Logfire with automatic instrumentation - https://pydantic.dev/logfire
npm install @pydantic/logfire-nodeFrom the team behind Pydantic Validation, Pydantic Logfire is an observability platform built on the same belief as our open source library — that the most powerful tools can be easy to use.
What sets Logfire apart:
- Simple and Powerful: Logfire's dashboard is simple relative to the power it provides, ensuring your entire engineering team will actually use it.
- SQL: Query your data using standard SQL — all the control and (for many) nothing new to learn. Using SQL also means you can query your data with existing BI tools and database querying libraries.
- OpenTelemetry: Logfire is an opinionated wrapper around OpenTelemetry, allowing you to leverage existing tooling, infrastructure, and instrumentation for many common packages, and enabling support for virtually any language.
See the documentation for more information.
Feel free to report issues and ask any questions about Logfire in this repository!
This repo contains the JavaScript Node.js SDK; the server application for recording and displaying data is closed source.
If you need to instrument your browser application, see the Logfire Browser package.
If you're instrumenting Cloudflare, see the Logfire CF workers package.
Using Logfire from your Node.js script is as simple as
getting a write token,
installing the package, calling configure, and using the provided API. Let's
create an empty project:
``shtype: module
mkdir test-logfire-js
cd test-logfire-js
npm init -y es6 # creates package.json with
npm install @pydantic/logfire-node
Then, create the following hello.js script in the directory:
`js
import * as logfire from '@pydantic/logfire-node'
logfire.configure({
token: 'my-write-token', // replace with your write token
serviceName: 'example-node-script',
serviceVersion: '1.0.0',
})
logfire.info(
'Hello from Node.js',
{
'attribute-key': 'attribute-value',
},
{
tags: ['example', 'example2'],
}
)
`
Run the script with node hello.js`, and you should see the span being logged in
the live view of your Logfire project.
See CONTRIBUTING.md for development instructions.
MIT