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

# Analytics Dashboard

> Comprehensive analytics and monitoring for AI agent activity and protection effectiveness

## Analytics Overview

The LLMTAG plugin provides comprehensive analytics to help you understand AI agent activity, monitor protection effectiveness, and make informed decisions about your content policies.

<Card title="Real-Time Analytics" icon="chart-line" horizontal>
  **Live Monitoring** • **Detailed Reports** • **Trend Analysis** • **Custom Dashboards**
</Card>

## Dashboard Overview

### Main Dashboard

Access your analytics dashboard at **LLMTAG > Analytics** in your WordPress admin.

<Columns cols={2}>
  <Card title="Real-Time Stats" icon="clock">
    **Current AI agent activity**
    **Blocked requests in last hour**
    **Active protection status**
    **System health indicators**
  </Card>

  <Card title="Quick Insights" icon="lightbulb">
    **Top blocked agents**
    **Most active time periods**
    **Geographic distribution**
    **Protection effectiveness**
  </Card>
</Columns>

### Key Metrics

#### Protection Metrics

<Columns cols={2}>
  <Card title="Total Blocked Requests" icon="shield">
    **Metric:** Number of AI agent requests blocked
    **Timeframe:** Configurable (1 hour, 24 hours, 7 days, 30 days)
    **Purpose:** Measure protection effectiveness
  </Card>

  <Card title="Block Success Rate" icon="check">
    **Metric:** Percentage of AI agents successfully blocked
    **Calculation:** (Blocked / Total AI Requests) × 100
    **Purpose:** Evaluate blocking accuracy
  </Card>

  <Card title="Last Blocked Event" icon="clock">
    **Metric:** Most recent AI agent blocking event
    **Details:** Agent name, time, IP address, reason
    **Purpose:** Monitor real-time activity
  </Card>

  <Card title="Active AI Agents" icon="robot">
    **Metric:** Number of unique AI agents detected
    **Timeframe:** Last 24 hours
    **Purpose:** Understand AI agent diversity
  </Card>
</Columns>

## Real-Time Monitoring

### Live Activity Feed

Monitor AI agent activity as it happens:

<Steps>
  <Step title="Access Live Feed">
    Go to **LLMTAG > Analytics > Live Activity**
  </Step>

  <Step title="View Real-Time Events">
    See AI agent requests and blocking events as they occur
  </Step>

  <Step title="Filter by Agent Type">
    Filter the feed by specific AI agents or categories
  </Step>

  <Step title="Export Activity Data">
    Export real-time data for external analysis
  </Step>
</Steps>

### Live Metrics

<Columns cols={2}>
  <Card title="Requests per Minute" icon="chart-line">
    **Shows:** Current rate of AI agent requests
    **Updates:** Every 30 seconds
    **Purpose:** Monitor traffic patterns
  </Card>

  <Card title="Block Rate" icon="shield-halved">
    **Shows:** Current percentage of requests being blocked
    **Updates:** Every minute
    **Purpose:** Monitor protection effectiveness
  </Card>
</Columns>

## Detailed Analytics

### AI Agent Analysis

#### Top Blocked Agents

See which AI agents are most frequently blocked:

<Columns cols={2}>
  <Card title="GPTBot" icon="robot">
    **Requests:** 1,247 blocked
    **Percentage:** 34.2%
    **Trend:** ↗️ Increasing
    **Last Seen:** 2 minutes ago
  </Card>

  <Card title="ChatGPT-User" icon="user-robot">
    **Requests:** 892 blocked
    **Percentage:** 24.5%
    **Trend:** ↗️ Increasing
    **Last Seen:** 5 minutes ago
  </Card>

  <Card title="Claude-Web" icon="brain">
    **Requests:** 567 blocked
    **Percentage:** 15.6%
    **Trend:** ↘️ Decreasing
    **Last Seen:** 12 minutes ago
  </Card>

  <Card title="PerplexityBot" icon="search">
    **Requests:** 445 blocked
    **Percentage:** 12.2%
    **Trend:** → Stable
    **Last Seen:** 8 minutes ago
  </Card>
</Columns>

#### Agent Activity Trends

<Steps>
  <Step title="Select Time Period">
    Choose from 1 hour, 24 hours, 7 days, or 30 days
  </Step>

  <Step title="View Trend Charts">
    See how AI agent activity changes over time
  </Step>

  <Step title="Compare Agents">
    Compare activity between different AI agents
  </Step>

  <Step title="Export Data">
    Export trend data for external analysis
  </Step>
</Steps>

### Geographic Analysis

#### Request Origins

See where AI agent requests are coming from:

<Columns cols={2}>
  <Card title="United States" icon="flag-usa">
    **Requests:** 2,156 (59.2%)
    **Top Agent:** GPTBot
    **Trend:** ↗️ Increasing
  </Card>

  <Card title="United Kingdom" icon="flag-gb">
    **Requests:** 567 (15.6%)
    **Top Agent:** ChatGPT-User
    **Trend:** → Stable
  </Card>

  <Card title="Germany" icon="flag-de">
    **Requests:** 445 (12.2%)
    **Top Agent:** Claude-Web
    **Trend:** ↘️ Decreasing
  </Card>

  <Card title="Other Countries" icon="globe">
    **Requests:** 472 (13.0%)
    **Top Agent:** Various
    **Trend:** → Stable
  </Card>
</Columns>

### Time-Based Analysis

#### Hourly Patterns

<Steps>
  <Step title="View Hourly Chart">
    See AI agent activity patterns throughout the day
  </Step>

  <Step title="Identify Peak Hours">
    Find when AI agents are most active
  </Step>

  <Step title="Plan Protection Strategy">
    Adjust protection levels based on activity patterns
  </Step>

  <Step title="Optimize Resources">
    Allocate server resources based on peak usage
  </Step>
</Steps>

#### Daily Trends

<Columns cols={2}>
  <Card title="Weekday Activity" icon="calendar">
    **Pattern:** Higher activity during business hours
    **Peak:** 2:00 PM - 4:00 PM
    **Average:** 45 requests/hour
  </Card>

  <Card title="Weekend Activity" icon="calendar-weekend">
    **Pattern:** Lower but consistent activity
    **Peak:** 10:00 AM - 12:00 PM
    **Average:** 28 requests/hour
  </Card>
</Columns>

## Custom Reports

### Report Builder

Create custom reports tailored to your needs:

<Steps>
  <Step title="Select Metrics">
    Choose which metrics to include in your report
  </Step>

  <Step title="Set Time Range">
    Define the time period for your report
  </Step>

  <Step title="Add Filters">
    Filter data by agent type, geographic location, or other criteria
  </Step>

  <Step title="Generate Report">
    Create and view your custom report
  </Step>

  <Step title="Schedule Reports">
    Set up automatic report generation and delivery
  </Step>
</Steps>

### Pre-Built Reports

#### Daily Protection Summary

```txt theme={null}
Daily Protection Summary - January 15, 2024

Total AI Agent Requests: 3,642
Successfully Blocked: 3,642 (100%)
Block Success Rate: 100%

Top Blocked Agents:
1. GPTBot: 1,247 requests (34.2%)
2. ChatGPT-User: 892 requests (24.5%)
3. Claude-Web: 567 requests (15.6%)
4. PerplexityBot: 445 requests (12.2%)
5. Other: 491 requests (13.5%)

Geographic Distribution:
- United States: 2,156 requests (59.2%)
- United Kingdom: 567 requests (15.6%)
- Germany: 445 requests (12.2%)
- Other: 474 requests (13.0%)

Peak Activity: 2:00 PM - 4:00 PM (156 requests/hour)
Lowest Activity: 3:00 AM - 5:00 AM (12 requests/hour)
```

#### Weekly Trend Analysis

<Columns cols={2}>
  <Card title="Request Volume" icon="chart-line">
    **Trend:** ↗️ 15% increase from last week
    **Peak Day:** Tuesday (567 requests)
    **Lowest Day:** Sunday (234 requests)
  </Card>

  <Card title="Agent Diversity" icon="users">
    **Unique Agents:** 12 (same as last week)
    **New Agents:** 0
    **Retired Agents:** 0
  </Card>
</Columns>

### Automated Reports

#### Email Reports

<Steps>
  <Step title="Configure Email Settings">
    Set up email addresses for report delivery
  </Step>

  <Step title="Choose Report Frequency">
    Select daily, weekly, or monthly reports
  </Step>

  <Step title="Customize Report Content">
    Choose which metrics and insights to include
  </Step>

  <Step title="Set Up Alerts">
    Configure alerts for unusual activity or issues
  </Step>
</Steps>

#### Report Templates

<Tabs>
  <Tab title="Executive Summary">
    **Audience:** Management, stakeholders
    **Content:** High-level metrics, trends, key insights
    **Frequency:** Weekly or monthly
  </Tab>

  <Tab title="Technical Details">
    **Audience:** IT staff, developers
    **Content:** Detailed metrics, technical analysis, troubleshooting info
    **Frequency:** Daily or weekly
  </Tab>

  <Tab title="Security Report">
    **Audience:** Security team, compliance
    **Content:** Security metrics, threat analysis, compliance status
    **Frequency:** Daily or weekly
  </Tab>
</Tabs>

## Performance Analytics

### System Performance

Monitor how the plugin affects your website's performance:

<Columns cols={2}>
  <Card title="Page Load Impact" icon="clock">
    **Average Impact:** +8ms
    **Peak Impact:** +15ms
    **Trend:** → Stable
    **Optimization:** Good
  </Card>

  <Card title="Memory Usage" icon="memory">
    **Average Usage:** 12MB
    **Peak Usage:** 18MB
    **Trend:** → Stable
    **Optimization:** Good
  </Card>

  <Card title="CPU Usage" icon="microchip">
    **Average Usage:** 2.3%
    **Peak Usage:** 4.1%
    **Trend:** → Stable
    **Optimization:** Good
  </Card>

  <Card title="Database Queries" icon="database">
    **Average Queries:** 3.2 per request
    **Peak Queries:** 5.8 per request
    **Trend:** → Stable
    **Optimization:** Good
  </Card>
</Columns>

### Optimization Recommendations

<Steps>
  <Step title="Analyze Performance Data">
    Review performance metrics to identify bottlenecks
  </Step>

  <Step title="Identify Optimization Opportunities">
    Look for areas where performance can be improved
  </Step>

  <Step title="Implement Optimizations">
    Apply recommended performance improvements
  </Step>

  <Step title="Monitor Results">
    Track performance improvements over time
  </Step>
</Steps>

## Data Export and Integration

### Export Options

Export your analytics data for external analysis:

<Columns cols={2}>
  <Card title="CSV Export" icon="file-csv">
    **Format:** Comma-separated values
    **Use for:** Excel, Google Sheets, data analysis
    **Data:** Raw metrics and timestamps
  </Card>

  <Card title="JSON Export" icon="file-code">
    **Format:** JavaScript Object Notation
    **Use for:** APIs, custom applications
    **Data:** Structured data with metadata
  </Card>

  <Card title="PDF Report" icon="file-pdf">
    **Format:** Portable Document Format
    **Use for:** Presentations, documentation
    **Data:** Formatted reports with charts
  </Card>
</Columns>

### API Integration

Access analytics data programmatically:

```javascript theme={null}
// Example API call to get analytics data
fetch('/wp-json/llmtag/v1/analytics', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => {
  console.log('Analytics data:', data);
});
```

### Third-Party Integrations

<Columns cols={2}>
  <Card title="Google Analytics" icon="google">
    **Integration:** Send blocking events to GA4
    **Purpose:** Combine with website analytics
    **Setup:** One-click integration
  </Card>

  <Card title="Slack Notifications" icon="slack">
    **Integration:** Send alerts to Slack channels
    **Purpose:** Team notifications
    **Setup:** Webhook configuration
  </Card>
</Columns>

## Troubleshooting

### Common Analytics Issues

<AccordionGroup>
  <Accordion title="No data showing in analytics">
    **Possible causes:**

    * No AI agents accessing the site
    * Analytics not enabled
    * Database issues
    * Plugin configuration problems

    **Solutions:**

    * Wait for AI agent traffic
    * Enable analytics in settings
    * Check database connectivity
    * Verify plugin configuration
  </Accordion>

  <Accordion title="Inaccurate metrics">
    **Possible causes:**

    * Caching issues
    * Time zone problems
    * Data processing errors
    * Configuration mistakes

    **Solutions:**

    * Clear all caches
    * Check time zone settings
    * Review data processing logic
    * Verify configuration settings
  </Accordion>

  <Accordion title="Performance impact from analytics">
    **Possible causes:**

    * Too much data collection
    * Inefficient queries
    * Large database tables
    * Real-time processing overhead

    **Solutions:**

    * Reduce data collection frequency
    * Optimize database queries
    * Clean up old data
    * Adjust real-time processing settings
  </Accordion>
</AccordionGroup>

## Best Practices

### Analytics Configuration

<Columns cols={2}>
  <Card title="Set Appropriate Retention" icon="clock">
    Keep analytics data for a reasonable period (30-90 days) to balance insights with storage costs.
  </Card>

  <Card title="Regular Review" icon="eye">
    Review analytics data regularly to identify trends and make informed decisions.
  </Card>

  <Card title="Custom Alerts" icon="bell">
    Set up alerts for important events like high-volume blocking or new AI agents.
  </Card>

  <Card title="Data Backup" icon="save">
    Regularly backup analytics data to prevent loss of historical information.
  </Card>
</Columns>

### Performance Optimization

<Note>
  Follow these tips to optimize analytics performance:
</Note>

* **Enable caching** for frequently accessed analytics data
* **Optimize database queries** to reduce load
* **Clean up old data** regularly to maintain performance
* **Use appropriate data retention** periods
* **Monitor resource usage** and adjust as needed

### Privacy and Compliance

<Warning>
  Always ensure your analytics configuration complies with privacy regulations:
</Warning>

* **Anonymize IP addresses** in analytics data
* **Respect user privacy** when collecting data
* **Follow GDPR requirements** for data processing
* **Implement data retention** policies
* **Provide opt-out mechanisms** where required