Agent Connectors (SDKs)

Connect your applications to the autonomous observability agent.

Agent Connectors

To enable the BugObserve Agent to analyze your system, you need to install lightweight connectors (SDKs) in your application. These connectors stream runtime exceptions, logs, and performance metrics to the agent in real-time.

Node.js Connector

Ideal for backend services, APIs, and background workers.

Installation

npm install @bugoracle/node

Usage

import { BugOracleNode } from "@bugoracle/node";

const agent = new BugOracleNode({
  clientKey: "bo_pk_YOUR_PROJECT_KEY",
});

// Capture caught error
try {
  riskyOperation();
} catch (err) {
  agent.capture(err); // Agent starts analysis immediately
}

Browser Connector

Ideal for React, Vue, Svelte, or vanilla JS applications.

Installation

npm install @bugoracle/browser

Usage

import { BugOracleBrowser } from "@bugoracle/browser";

const agent = new BugOracleBrowser({
  clientKey: "bo_pk_YOUR_PROJECT_KEY",
});

// Automatically captures window.onerror and unhandledrejection
// The agent will correlate these client-side errors with backend traces.

Configuration

| Option | Type | Description | Default | | ----------- | ------ | ----------------------------------------------- | ------------------------------------- | | clientKey | string | Required. Your Project SDK Key. | - | | apiUrl | string | Override ingestion URL (e.g. for self-hosting). | https://bugoracle.com/api/v1/ingest |