Welcome to _@robojs/better-stack_! This plugin seamlessly integrates with your existing **[Robo.js](https://github.com/Wave-Play/robo)** project, providing a comprehensive link to Better Stack, a renowned third-party service. With Better Stack, monitor yo
npm install @robojs/better-stackWelcome to _@robojs/better-stack_! This plugin seamlessly integrates with your existing Robo.js project, providing a comprehensive link to Better Stack, a renowned third-party service. With Better Stack, monitor your Robo's uptime and integrate logs in a visually appealing and searchable format.
Before integrating this plugin, ensure you've signed up for an account on Better Stack.
To install this plugin, navigate to your existing Robo project's directory and run the following command:
``bash`
npx robo add @robojs/better-stack
Once installed, the plugin enhances your Robo with Better Stack's capabilities.
To initiate heartbeat monitoring:
1. Log into your Better Stack account.
2. Create a new heartbeat, preferably naming it after your Robo.
3. Copy the generated URL.
4. Paste the URL into the plugin's config file: /config/plugins/roboplay/plugin-better-stack.mjs
`js`
export default {
heartbeat: {
url: 'https://uptime.betterstack.com/api/v1/heartbeat/8XMvMa5y7xtONEtUfj2yb8f'
}
}
- interval: Set the frequency of requests to the heartbeat URL in milliseconds. Defaults to 5000ms (5 seconds).debug
- : Control debug logging for the heartbeat. While it's set to false by default to prevent spam, turning it on ensures correct heartbeat setup.
Firstly, set up your source in Better Stack to receive a unique sourceToken.
Method 1: Using Config File
In the plugin config file, pass your sourceToken and ingestingHost:
`js`
export default {
ingestingHost: 'YOUR_INGESTING_HOST',
sourceToken: 'YOUR_UNIQUE_SOURCE_TOKEN'
}
Method 2: Using Environment Variable
Use an environment variable in your .env file:
`
BETTER_STACK_INGESTING_HOST="YOUR_INGESTING_HOST"
BETTER_STACK_SOURCE_TOKEN="YOUR_UNIQUE_SOURCE_TOKEN"
Method 3: Direct Drain Creation
Create a drain directly within the primary config file, robo.mjs. This method captures logs early, ensuring comprehensive log coverage.
`js
// @ts-check
import { createLogtailDrain } from '@robojs/better-stack'
/**
* @type {import('robo.js').Config}
**/
export default {
// ... other configurations
logger: {
drain: createLogtailDrain(process.env.BETTER_STACK_SOURCE_TOKEN, {
endpoint: 'YOUR_INGESTING_HOST'
})
}
}
``
> Yet to embark on a Robo.js journey? Kickstart your Robo project!
Harness the synergy of Robo.js and Better Stack for an enhanced bot experience! 🚀