Logfire Resource Provider

Manage Pydantic Logfire projects, alerts, dashboards, channels, and API tokens with Pulumi.

Installing

This package is available for several languages/platforms:

Node.js (JavaScript/TypeScript)

To use from JavaScript or TypeScript in Node.js, install using either npm:

npm install @pydantic/pulumi-logfire

or yarn:

yarn add @pydantic/pulumi-logfire

Python

To use from Python, install using pip:

pip install pydantic-pulumi-logfire

Import it in code as pulumi_logfire.

Go

To use from Go, use go get to grab the latest version of the library:

go get github.com/pydantic/pulumi-logfire/sdk/go/logfire

Configuration

The following configuration points are available for the logfire provider:

• logfire:baseUrl (environment: LOGFIRE_BASE_URL) – Optional override for the Logfire API base URL. If omitted, the provider uses LOGFIRE_BASE_URL or infers the SaaS endpoint from the API key region. Self-hosted customers should set this explicitly.
• logfire:apiKey (environment: LOGFIRE_API_KEY) – Bearer token for the Logfire API.

Example stack config:

pulumi config set --secret logfire:apiKey pylf_v2_us_...
# Self-hosted only:
# pulumi config set logfire:baseUrl https://<self-hosted-logfire>

For Logfire SaaS, the provider infers https://logfire-us.pydantic.dev or https://logfire-eu.pydantic.dev from the API key region. If you set logfire:baseUrl or LOGFIRE_BASE_URL, that value is used instead.

Importing existing resources

Existing Logfire resources can be imported into Pulumi state with pulumi import. For resources that are easy to look up by name or slug, prefer the name-based import IDs:

Resource	Recommended import ID	Example
logfire:Project	organization/project-name	pulumi import logfire:index/project:Project prod "acme/prod-logs"
logfire:Alert	project-name/alert-name	pulumi import logfire:index/alert:Alert errors "prod-logs/error-alert"
logfire:Dashboard	project-name/dashboard-slug	pulumi import logfire:index/dashboard:Dashboard overview "prod-logs/prod-overview"

UUID-based import IDs are also supported if you already have the backend IDs. The separators /, ,, and | are accepted for multi-part import IDs.

Reference

For detailed reference documentation, please visit the Pulumi registry.

Resources

• Projects (logfire:Project)
• Channels (logfire:Channel)
• Alerts (logfire:Alert)
• Dashboards (logfire:Dashboard)
• Write tokens (logfire:WriteToken)
• Read tokens (logfire:ReadToken)
• Organizations (logfire:Organization)