Atalaya Sentinel
v1.2 Production ContractRFC-0021 / D-017 Compliant

Atalaya Sentinel Telemetry & SDK Integration Guide

Atalaya Sentinel provides real-time deterministic exception monitoring, SHA-256 fingerprinting, SLA health verification and autonomous auto-healing bridges for Next.js, Node.js and distributed microservices.

Quick Start & Onboarding

PASO 01

Generate Bearer Key

Configure your environment with an authorized ATALAYA_API_KEY token to authenticate telemetry requests.
PASO 02

Inject SDK Client

Wrap global exception handlers or middleware with the lightweight non-blocking telemetry emitter.
PASO 03

Auto-Healing Bridge

Critical incidents automatically emit cryptographic webhooks to AI-SEOS for automated root cause analysis.

Telemetry Ingestion Endpoint

POST /api/v1/telemetry/events
Headers ContractHTTP/1.1 & HTTP/2 Supported
Content-Type: application/json
Authorization: Bearer <ATALAYA_API_KEY>
X-Atalaya-Signature: sha256=<hmac-hash> (Optional for webhook authenticity)

JSON Payload Specification

{
  "serviceId": "checkout-api",
  "environment": "production",
  "errorClass": "PaymentGatewayTimeoutException",
  "errorMessage": "Upstream timeout after 5000ms while processing charge",
  "severity": "CRITICAL",
  "stackTrace": "Error: Upstream timeout\n  at PaymentClient.charge (/app/dist/payment.js:42:15)\n  at async handleCheckout (/app/dist/routes/checkout.js:18:9)",
  "fingerprint": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "metadata": {
    "requestId": "req_84f92a10",
    "region": "europe-west1",
    "tenantId": "org_jmrs92",
    "httpMethod": "POST",
    "path": "/api/v1/orders/charge"
  },
  "timestamp": "2026-10-12T17:20:00.000Z"
}

SDK Code Snippets

cURL Example

curl -X POST https://atalaya.fabribrain.com/api/v1/telemetry/events \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${ATALAYA_API_KEY}" \
  -d '{
    "serviceId": "auth-service",
    "errorClass": "TokenExpiredError",
    "errorMessage": "JWT token expired at timestamp 1791816000",
    "severity": "MEDIUM",
    "timestamp": "'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'"
  }'

Node.js / TypeScript Emitter

import crypto from 'node:crypto';

export async function captureIncident(error: Error, severity: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL' = 'HIGH') {
  const fingerprint = crypto.createHash('sha256')
    .update(`${error.name}:${error.message}`)
    .digest('hex');

  await fetch('https://atalaya.fabribrain.com/api/v1/telemetry/events', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${process.env.ATALAYA_API_KEY}`
    },
    body: JSON.stringify({
      serviceId: process.env.SERVICE_NAME || 'web-app',
      errorClass: error.name || 'UnknownError',
      errorMessage: error.message,
      severity,
      stackTrace: error.stack,
      fingerprint,
      timestamp: new Date().toISOString()
    })
  }).catch((err) => console.error('[Atalaya] Ingestion dispatch failed:', err.message));
}

Autonomous Auto-Healing Bridge

When an incident with severity CRITICAL or HIGH occurs, Atalaya Sentinel automatically calculates exception repetition thresholds. If occurrences exceed 3 within a 60-second window, an encrypted auto-healing webhook event is dispatched to the AI-SEOS operator bridge:

POST https://ai-seos.fabribrain.com/api/v1/operator/auto-heal
  • Lineage tracking binds the exception fingerprint to the exact task and commit SHA.
  • Specialist AI agents generate a corrective pull request in an isolated Git worktree.
  • Zero human intervention needed for known regression patterns.
Need production API keys or custom enterprise webhook policies?