Integrate in minutes,
not hours.

// argus.js — non-blocking fetch wrapper
const ARGUS_API_KEY = "argus_live_YOUR_KEY_HERE";
const ARGUS_ENDPOINT = "https://argus-bt.duckdns.org:8443/api/events";

function getSessionId() {
  let id = sessionStorage.getItem("argus_sid");
  if (!id) {
    id = crypto.randomUUID();
    sessionStorage.setItem("argus_sid", id);
  }
  return id;
}

export async function track(eventType, extra = {}) {
  try {
    // We use "keepalive: true" so events reach the server even if the page unloads
    fetch(ARGUS_ENDPOINT, {
      method: "POST",
      keepalive: true,
      headers: {
        "Content-Type": "application/json",
        "X-API-Key": ARGUS_API_KEY,
      },
      body: JSON.stringify({
        eventId: crypto.randomUUID(),
        eventType,
        timestamp: new Date().toISOString(),
        sessionId: getSessionId(),
        url: window.location.pathname,
        service: "web-frontend", // YOUR SERVICE NAME
        data: extra, // Safely nests custom properties
      }),
    });
  } catch (e) {
    // Fail silently in production to protect user experience
  }
}

import { track } from "./argus.js";

// 1. Tracks initial page load
track("page_view", { title: document.title, theme: "dark" });

// 2. Track specific user interactions
document.getElementById("signup-btn").addEventListener("click", () => {
  track("signup_click", { device: "desktop", plan: "pro" });
});

// 3. Track performance metrics
window.addEventListener("load", () => {
  const [navigation] = performance.getEntriesByType("navigation");
  track("performance_metric", {
    latency: Math.round(navigation.domInteractive)
  });
});

# Standard requests library integration
import requests, uuid, os
from datetime import datetime, timezone

ARGUS_KEY = "argus_live_YOUR_KEY_HERE"
ARGUS_URL = "https://argus-bt.duckdns.org:8443/api/events"

def track_event(event_type: str, service_name="python-backend", **kwargs):
    """Asynchronous-style fire-and-forget ingestion"""
    payload = {
        "eventId": str(uuid.uuid4()),
        "eventType": event_type,
        "timestamp": datetime.now(timezone.utc).isoformat(),
        "sessionId": "backend-worker",
        "service": service_name,
        "data": kwargs, # Safely nests all custom **kwargs here
    }
    try:
        requests.post(
            ARGUS_URL,
            headers={"X-API-Key": ARGUS_KEY, "Content-Type": "application/json"},
            json=payload,
            timeout=1, # Keep timeouts short to avoid blocking workers
        )
    except requests.exceptions.RequestException:
        pass

# Example: Track a successful database operation
track_event("api_call", statusCode=201, latency=12, endpoint="/v1/users")

// Node.js backend integration
const fetch = require("node-fetch");

const ARGUS_KEY = "argus_live_YOUR_KEY_HERE";
const ARGUS_URL = "https://argus-bt.duckdns.org:8443/api/events";

const track = (eventType, options = {}, serviceName = "node-api") => {
  fetch(ARGUS_URL, {
    method: "POST",
    headers: { 
      "Content-Type": "application/json", 
      "X-API-Key": ARGUS_KEY 
    },
    body: JSON.stringify({
      eventId: require("crypto").randomUUID(),
      eventType,
      timestamp: new Date().toISOString(),
      sessionId: "server-runtime",
      service: serviceName,
      data: options, // Safely nests custom options here
    }),
  }).catch(() => {});
};

// Example Express middleware for automated monitoring
app.use((req, res, next) => {
  const start = Date.now();
  res.on("finish", () => {
    track("api_call", {
      url: req.path,
      statusCode: res.statusCode,
      latency: Date.now() - start
    }, "inventory-svc");
  });
  next();
});