@softpulse/pulse-sdk

Cliente oficial da Pulse Ingest API v1 — envie logs, métricas e traces com HTTP + JSON, sem OpenTelemetry.

Instalação

npm install @softpulse/pulse-sdk

Uso

import { PulseClient } from "@softpulse/pulse-sdk";

const pulse = new PulseClient({
  apiKey: process.env.PULSE_API_KEY!,
  baseUrl: "https://pulse-api.orkestraai.com.br",
  serviceName: "checkout-api",
});

pulse.info("pedido criado", { orderId: "ord_1" });
pulse.metric("orders.total", 1);
const { traceId } = pulse.span({
  name: "POST /orders",
  durationMs: 42,
  status: "ok",
  attributes: { orderId: "ord_1" },
});
pulse.info("pedido ok", { orderId: "ord_1", traceId });
await pulse.flush();

Variáveis de ambiente

| Variável | Descrição | |----------|-----------| | PULSE_API_KEY | pulse_live_… | | ORKESTRA_PULSE_URL | Base da API | | PULSE_LOG_SERVICE_NAME | Nome do serviço |

import { pulseClientFromEnv } from "@softpulse/pulse-sdk";
const pulse = pulseClientFromEnv();

Publicar

npm login
cd sdk/node
npm publish --access public

Documentação

Ver ../../docs/INGEST-API-V1.md.