> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Telemetry API

> Query GPU metrics, alerts, and monitoring data through the Visent Telemetry API

# 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

```bash theme={null}
# 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

```bash theme={null}
# 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

```python theme={null}
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

* [Check authentication guide](authentication) for API key setup
* [Explore Atlas API](atlas) for pricing data
* [Use Python SDK](../sdk/python) for easier integration