Instrumenta una vez. Explica todo.
Tres SDKs open source y una API HTTP plana. Los eventos siguen una sola gramática — dominio, entidad, operación — así todo lo que capturas compone un único grafo causal.
Tu primer evento en cinco minutos.
Instala @vectry/node, crea un cliente con tu API key y captura tu primer evento estructurado. La misma gramática funciona desde el navegador con @vectry/js-core, desde React con @vectry/react o desde cualquier cosa que haga POST de JSON.
- npm install @vectry/node — licencia MIT, tipos de TypeScript incluidos.
- Todos los SDKs son open source en github.com/vectry-analytics.
- Ingesta fire-and-forget — capturar nunca bloquea tu request path.
import { Vectry } from '@vectry/node';
const vectry = new Vectry({
apiKey: process.env.VECTRY_API_KEY,
});
await vectry.capture({
namespace: 'auth.session.created',
actor_id: 'usr-102',
actor_type: 'user',
operation: {
type: 'created',
system_domain: 'auth',
system_entity: 'session',
system_entity_id: 'ses-88f2',
},
}); Cinco primitivas, un grafo.
Todo lo que Vectry almacena se reduce a cinco primitivas. Cada una lleva alcance multi-tenant, metadata de auditoría completa (created / modified / deleted con actor y timestamp) y un ciclo de vida de estados que incluye archivado y en revisión.
-
Eventobservation - Acción, cambio o señal atómica — actor + operación + contexto.
-
EventOperationembedded - Operación formal: type, system_domain, system_entity, system_entity_id, source, changes.
-
Traceexecution - Flujo localizado de eventos relacionados ligado a una entidad, con inicio/fin.
-
CausalThreadexecution - Historia entre sistemas que agrupa traces y cierra con un desenlace.
-
EventExplanationsemantics - Cadena caused_by + narrativa legible por humanos para un evento.
-
Anomalydiagnostics - Patrón esperado vs real, deviation_score, level: event | trace | causal_thread.
Un endpoint para todo lo demás.
¿Aún no hay SDK para tu stack? Haz POST de eventos a /v1/ingest con un Bearer token. Es el mismo contrato de red que usan los SDKs — y el mismo por el que emite el worker vectry.log de Sommatic, así los eventos de workflows caen en el mismo grafo que los de tus aplicaciones.
- POST https://api.vectry.io/v1/ingest — body JSON, auth Bearer.
- La misma gramática desde backends, dispositivos, workflows y pipelines.
- API keys con alcance por organización y aplicación.
Instrumenta en minutos.
SDKs open source, una API HTTP de ingesta y un modelo de datos que se lee en una tarde.
- 01
Captura
Emite eventos estructurados desde backends, navegadores y dispositivos con los SDKs o HTTP plano.
- 02
Enlaza
Vectry liga los eventos a traces e hilos causales alrededor de tus entidades reales.
- 03
Explica
Consulta el porqué: cadenas causales, narrativas y anomalías sobre tu operación.
import { Vectry } from '@vectry/node';
const vectry = new Vectry({
apiKey: process.env.VECTRY_API_KEY,
});
await vectry.capture({
namespace: 'auth.session.created',
actor_id: 'usr-102',
actor_type: 'user',
operation: {
type: 'created',
system_domain: 'auth',
system_entity: 'session',
system_entity_id: 'ses-88f2',
},
}); -
@vectry/nodeCaptura de eventos para servicios, jobs y workers en Node.js. -
@vectry/js-coreSDK universal de navegador para comportamiento de usuarios y apps. -
@vectry/reactHooks y providers para aplicaciones React. -
HTTP Ingest APIUn solo POST /v1/ingest — desde cualquier cosa que hable HTTP.
Licencia MIT · open source