@robojs/better-stack

Integrate Better Stack into your Robo for uptime monitoring and centralized log management. This plugin provides two core features: heartbeat monitoring to track whether your Robo is online, and log ingestion to forward structured logs to Better Stack's searchable dashboard.

Features

Prerequisites

Sign up for an account at Better Stack before configuring the plugin.

Installation

To install, run:

npx robo add @robojs/better-stack@next

Or create a new project with the plugin pre-installed:

npx create-robo@next my-project -p @robojs/better-stack@next

Heartbeat monitoring

Heartbeat monitoring sends periodic HTTP pings to Better Stack. If pings stop arriving, Better Stack marks your service as down and sends alerts through your configured channels.

export default {
	heartbeat: {
		url: 'https://uptime.betterstack.com/api/v1/heartbeat/your-heartbeat-id'
	}
}

export default {
	heartbeat: {
		url: 'https://uptime.betterstack.com/api/v1/heartbeat/your-heartbeat-id'
	}
}

See Heartbeat for setup instructions and configuration options.

Log integration

Log integration forwards your Robo's log output to Better Stack's Logtail service, providing searchable, color-coded logs with level filtering. There are three ways to configure it.

The simplest approach uses a plugin config file:

export default {
	sourceToken: 'YOUR_UNIQUE_SOURCE_TOKEN'
}

export default {
	sourceToken: 'YOUR_UNIQUE_SOURCE_TOKEN'
}

Or use environment variables for production:

BETTER_STACK_SOURCE_TOKEN="YOUR_UNIQUE_SOURCE_TOKEN"

See Log drain for all configuration methods, log level mapping, and the createLogtailDrain API.

Configuration reference

All plugin configuration options at a glance:

Environment variables

Next Steps