Skip to main content

Telemetry API

Access GPU monitoring data, metrics, and alerts through the Visent Telemetry API. Query real-time and historical performance data, manage alerts, and integrate monitoring capabilities into custom applications. Supports REST API with JSON responses, flexible filtering, and real-time data streaming.

Base URL

https://api.visent.ai/telemetry

Endpoints

Get Metrics

# Get current GPU metrics
GET /metrics

# Example request
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.visent.ai/telemetry/metrics?node=gpu-worker-1&gpu=0"

# Example response
{
  "metrics": [
    {
      "timestamp": "2024-01-15T10:30:00Z",
      "node": "gpu-worker-1",
      "gpu": 0,
      "utilization": 85.2,
      "memory_used": 16106127360,
      "temperature": 72.5,
      "power_draw": 320.1
    }
  ]
}

Historical Metrics

Coming soon - querying historical performance data with time ranges.

Real-time Streaming

Coming soon - WebSocket API for real-time metric streaming.

Alert Management

List Alerts

# Get active alerts
GET /alerts

# Filter by severity
GET /alerts?severity=critical

Create Alert Rules

Coming soon - programmatically creating and managing alert rules.

Alert Webhooks

Coming soon - configuring webhook notifications for alerts.

Node Management

List Nodes

Coming soon - retrieving information about monitored GPU nodes.

Node Configuration

Coming soon - updating node monitoring configuration via API.

Query Parameters

Coming soon - comprehensive list of supported query parameters and filters.

Response Format

Coming soon - detailed API response schemas and data types.

Rate Limits

Coming soon - API rate limiting and usage guidelines.

Error Handling

Coming soon - API error codes and troubleshooting guide.

Code Examples

Python

import requests

# Get current metrics
response = requests.get(
    "https://api.visent.ai/telemetry/metrics",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"node": "gpu-worker-1"}
)
metrics = response.json()

JavaScript

Coming soon - JavaScript/Node.js integration examples.

Next Steps