cloudgrip

CloudGrip SDK for Node.js

CloudGrip is the world’s first AI-native observability platform. It doesn’t just collect logs and metrics — it finds and fixes bugs in production automatically.

• ⚡️ Zero-config setup
• 🧠 Real-time AI root cause analysis
• 🔍 Detects the exact line of code causing a problem
• ✅ Auto-generates pull requests with the fix

CloudGrip turns observability from passive data collection into an active DevOps agent — fixing issues before users even notice.

👉 Learn more at cloudgrip.ai

Installation

npm install cloudgrip

Getting Started

🔹 Send Logs

import { CloudGrip } from 'cloudgrip';

const cg = new CloudGrip({
  apiKey: 'cg_123456789',
});

cg.logger.info('User login', { userId: 'abc123' });
cg.logger.error(new Error('Something went wrong'), 'Failed to process request');

🔹 Send Metrics

cg.metrics.counter('http.requests');
cg.metrics.histogram('http.request.duration', 245);
cg.metrics.gauge('heap.usage.bytes', process.memoryUsage().heapUsed);

🔹 Send Traces

const spanId = cg.tracer.span('db_query', { traceId: 'abc123' });
// ... your code here ...
cg.tracer.endSpan(spanId);

🔹 Use CloudGrip with Pino

import pino from 'pino';

const logger = pino({
  transport: {
    target: 'cloudgrip/transport',
    options: {
      apiKey: 'cg_123456789',
    },
  },
});

logger.info('This log is sent to CloudGrip');

Log Levels

Method	Level	Description
trace()	10	Most detailed logs — every step, for deep debugging
debug()	20	Internal debugging info
info()	30	Normal logs: service start, request handled, etc.
warn()	40	Something unexpected, but not broken
error()	50	An error occurred, but app continues to run
fatal()	60	Unrecoverable error, likely before shutdown

Configuration

Pass the following options when creating the SDK instance:

const cg = new CloudGrip({
  apiKey: 'cg_123456789',
  host: 'https://telemetry-api.cloudgrip.ai', // optional
  logLevel: 'info',                          // optional
  logToConsole: true,                        // optional
  maxBufferSize: 1000,                       // optional
  flushIntervalMs: 5000,                     // optional
});

Option	Type	Required	Description
apiKey	string	✅ Yes	Your CloudGrip API key
host	string	No	Custom endpoint for telemetry export (defaults to CloudGrip API)
logLevel	string	No	Minimum log level (trace, debug, etc.). Default: trace
logToConsole	boolean	No	Whether to also print logs to stdout. Default: true in development
maxBufferSize	number	No	Max telemetry items buffered before flushing
flushIntervalMs	number	No	Time (ms) between automatic telemetry flushes

Deployment Environment

The SDK automatically sets deployment.environment based on process.env.NODE_ENV. If NODE_ENV is not set, it defaults to "development".