Documentation

Everything you need to integrate PrimVera into your developer tools.

Quick Start

Get your first events flowing in under 5 minutes. Covers account setup, API key generation, and SDK installation.

Read guide →

VS Code SDK

Our most popular integration. Track activation, commands, errors, and custom events from your VS Code extension.

Read guide →

REST API Reference

Complete reference for the Ingest API, Query API, and Management API. Includes authentication, rate limits, and error codes.

Read reference →

Node.js / CLI SDK

Instrument Node.js CLIs and tools. Automatic command tracking, error capture, and session management.

Read guide →

Go SDK

Lightweight telemetry for Go CLIs and services. Zero-allocation hot path, async batching, graceful shutdown.

Read guide →

Python SDK

Track usage of Python packages, CLIs, and Jupyter extensions. Automatic environment detection and context capture.

Read guide →

Pipeline Configuration

Configure event validation, PII scrubbing, field enrichment, and routing rules using YAML pipeline definitions.

Read guide →

Data Export

Export raw events to S3, BigQuery, Snowflake, or your own Kafka cluster. Real-time streaming or scheduled batch exports.

Read guide →

Ingest API Example

# Send a telemetry event
curl -X POST https://primvera.tech/api/v2/telemetry/ingest \
  -H "Content-Type: application/json" \
  -H "X-Telemetry-Token: your_api_token" \
  -d '{
    "event": "command_executed",
    "properties": {
      "command": "myExtension.doThing",
      "duration_ms": 142,
      "success": true
    },
    "context": {
      "extension_version": "1.2.4",
      "vscode_version": "1.87.0",
      "os": "darwin"
    }
  }'

# Response
{ "status": "ok", "event_id": "evt_8f3a..." }