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

# telemetry • AI Agent SDK

> PraisonAI Agents Telemetry & Performance Monitoring Module

# telemetry

<Badge color="blue">AI Agent</Badge>

PraisonAI Agents Telemetry & Performance Monitoring Module

This module provides:

1. Anonymous usage tracking with privacy-first design
2. User-friendly performance monitoring and analysis tools

Telemetry can be disabled via environment variables:

* PRAISONAI\_TELEMETRY\_DISABLED=true
* PRAISONAI\_DISABLE\_TELEMETRY=true
* DO\_NOT\_TRACK=true

Performance monitoring can be optimized via environment variables:

* PRAISONAI\_PERFORMANCE\_DISABLED=true (disables performance monitoring overhead)
* PRAISONAI\_FLOW\_ANALYSIS\_ENABLED=true (enables expensive flow analysis - opt-in only)

No personal data, prompts, or responses are collected.

Performance Monitoring Features:

* Function performance tracking with detailed statistics
* API call monitoring and analysis
* Function execution flow visualization (opt-in)
* Performance bottleneck identification
* Real-time performance reporting
* External APM metrics export (DataDog, New Relic compatible)
* CLI interface for easy access

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import telemetry
```

## Functions

<CardGroup cols={2}>
  <Card title="get_telemetry()" icon="function" href="../functions/get_telemetry">
    Get the global telemetry instance.
  </Card>

  <Card title="enable_telemetry()" icon="function" href="../functions/enable_telemetry">
    Enable telemetry (if not disabled by environment).
  </Card>

  <Card title="disable_telemetry()" icon="function" href="../functions/disable_telemetry">
    Disable telemetry.
  </Card>

  <Card title="force_shutdown_telemetry()" icon="function" href="../functions/force_shutdown_telemetry">
    Force shutdown of telemetry system with comprehensive cleanup.
  </Card>

  <Card title="enable_performance_mode()" icon="function" href="../functions/enable_performance_mode">
    Enable performance mode for minimal telemetry overhead.
  </Card>

  <Card title="disable_performance_mode()" icon="function" href="../functions/disable_performance_mode">
    Disable performance mode to resume full telemetry tracking.
  </Card>

  <Card title="cleanup_telemetry_resources()" icon="function" href="../functions/cleanup_telemetry_resources">
    Clean up telemetry resources including thread pools and queues.
  </Card>
</CardGroup>