Skip to main content

Installation

Install the Visent Telemetry agent on your GPU nodes to begin monitoring performance metrics, resource utilization, and system health. The agent supports Linux, Windows, and containerized environments with automatic GPU discovery and minimal performance overhead. Supports NVIDIA, AMD, and Intel GPUs with both bare metal and cloud deployments.

Prerequisites

  • Linux system with GPU drivers installed (NVIDIA, AMD, or Intel)
  • Root access for GPU device access
  • For Kubernetes: Version 1.19+ with GPU nodes

Choose Your Installation Method

2. Docker

3. Kubernetes (Helm)

4. Manual Download

Get Your Enrollment Token

  1. Log in to Visent Cloud
  2. Go to Settings > API Keys
  3. Create a new enrollment token
  4. Copy the token for use in the commands above

Verify Installation

Once running, your GPU metrics will appear in the Visent Dashboard within 30 seconds. Check agent status:

Configuration Options

Export Modes

  • Cloud: Push metrics to Visent Cloud (default)
  • Prometheus: Expose metrics locally on port 9101
  • Both: Enable both modes simultaneously

Environment Variables

Troubleshooting

No metrics appearing?

  1. Check GPU drivers: nvidia-smi or rocm-smi
  2. View agent logs for errors
  3. Test with mock collector: COLLECTOR=mock VISENT_DEBUG=1 visent-agent run

Permission errors?

  • Ensure agent runs as root
  • For Docker/K8s: verify --privileged flag

Network issues?

  • Test connectivity: curl -v https://api.visent.io/health
  • Check firewall rules for HTTPS (port 443)

Next Steps