> ## 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.

# Performance Monitor CLI

> Monitor Agent performance via command line

Track and export Agent performance metrics from the command line.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    User([User]) --> CLI[CLI]
    CLI --> Mon[Monitor]

    classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef tool fill:#189AB4,stroke:#7C90A0,color:#fff

    class Mon agent
    class User,CLI tool
    classDef agent fill:#8B0000,color:#fff
    classDef tool fill:#189AB4,color:#fff

```

## Quick Start

<Steps>
  <Step title="Simple Usage">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    npx praisonai telemetry performance start
    ```
  </Step>

  <Step title="With Configuration">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    npx praisonai telemetry performance metric llm_latency 150
    npx praisonai telemetry performance timer start agent_response
    npx praisonai telemetry performance timer stop agent_response
    ```
  </Step>
</Steps>

## Start Monitoring

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Start performance monitor
npx praisonai telemetry performance start

# Record a metric
npx praisonai telemetry performance metric llm_latency 150

# Start a timer
npx praisonai telemetry performance timer start agent_response
npx praisonai telemetry performance timer stop agent_response
```

## View Stats

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Show all stats
npx praisonai telemetry performance stats

# Show specific metric
npx praisonai telemetry performance stats llm_latency

# Show summary dashboard
npx praisonai telemetry performance dashboard
```

## Export Metrics

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Export as JSON
npx praisonai telemetry performance export --json

# Export for Prometheus
npx praisonai telemetry performance export --prometheus

# Save to file
npx praisonai telemetry performance export --output metrics.json
```

## Live Monitoring

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Watch metrics in real-time
npx praisonai telemetry performance watch

# Watch with refresh interval
npx praisonai telemetry performance watch --interval 5
```

## Programmatic (TypeScript)

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { PerformanceMonitor, createPerformanceMonitor } from 'praisonai';

const monitor = createPerformanceMonitor();
monitor.record('latency', 150);
console.log(monitor.getStats('latency'));
```

## Related

<CardGroup cols={2}>
  <Card title="Performance Monitor" icon="gauge-high" href="/docs/js/performance-monitor">
    SDK documentation
  </Card>

  <Card title="Observability CLI" icon="terminal" href="/docs/js/observability-cli">
    Full observability
  </Card>
</CardGroup>
