Title: GEO Metrics AI Traffic Monitor
Author: abignu
Published: <strong>4 ژوئن 2026</strong>
Last modified: 4 ژوئن 2026

---

جستجوی افزونه‌ها

![](https://ps.w.org/geo-metrics-ai-traffic-monitor/assets/icon-256x256.png?rev=
3560697)

# GEO Metrics AI Traffic Monitor

 توسط [abignu](https://profiles.wordpress.org/abignu/)

[دانلود](https://downloads.wordpress.org/plugin/geo-metrics-ai-traffic-monitor.2.4.2.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/geo-metrics-ai-traffic-monitor/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/geo-metrics-ai-traffic-monitor/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/geo-metrics-ai-traffic-monitor/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/geo-metrics-ai-traffic-monitor/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/geo-metrics-ai-traffic-monitor/)

## توضیحات

**GEO Metrics AI Traffic Monitor** turns your raw server and WordPress logs into
actionable intelligence about AI bot traffic. In a world where ChatGPT, Claude, 
Gemini, and Perplexity crawl billions of pages to power their answers, knowing whether
those bots visit _your_ site — and what they read — is a new SEO frontier.

The plugin works out of the box with zero configuration. It reads your existing `
debug.log`, access logs, and PHP error logs, identifies AI crawlers by their User-
Agent string, and displays a clean analytics dashboard inside your WordPress admin.

#### What you get

 * **AI Bot Dashboard** — KPI cards for total requests, AI bot visits, distinct 
   bots detected, and the active date range. Visual trend chart broken down per 
   bot per day. Donut chart of bot share.
 * **Bot Details tab** — per-bot breakdown with company grouping (OpenAI, Anthropic,
   Google, Meta…), bot type (crawler / agent / search / researcher), top pages visited,
   and HTTP status distribution.
 * **Log Viewer tab** — raw log lines with syntax highlighting, live refresh via
   AJAX, and per-event type/severity filtering.
 * **Live Traffic capture** — the plugin writes its own `live.log` (no server log
   access needed), capturing every frontend, REST API, and AJAX request in Combined
   Log Format, with automatic 5 MB rotation.
 * **Date range filter** — filter all dashboard data by custom date range or quick
   presets (Last 7 days, Last 30 days, etc.).
 * **WP-Cron sync** — automatic parsing on a configurable schedule (Hourly / Every
   6 hours / Twice daily / Daily).
 * **Data retention** — configurable retention period (default 30 days) with automatic
   purge.
 * **Proxy-aware IP detection** — optional trust of `X-Forwarded-For` / `CF-Connecting-
   IP` headers for sites behind Cloudflare or a reverse proxy.
 * **GEO Metrics** — visit [trygeometrics.com](https://trygeometrics.com) for cross-
   site AI traffic aggregation and visibility scoring across your entire brand.

#### Detected bots (40+)

Organized by company:

 * **OpenAI** — GPTBot, ChatGPT-User, OAI-SearchBot, OAI-AdsBot
 * **Anthropic** — ClaudeBot, Claude-Web, Claude-User, Claude-SearchBot, anthropic-
   ai
 * **Google** — Googlebot, Google-Extended, Gemini, Google-Agent, Google-CloudVertexBot,
   GoogleOther, Google-NotebookLM
 * **Microsoft** — bingbot
 * **Perplexity** — PerplexityBot, Perplexity-User, DuckAssistBot
 * **Meta** — Meta-ExternalAgent, Meta-ExternalFetcher, Meta-WebIndexer
 * **xAI** — GrokBot
 * **Mistral AI** — MistralAI-User
 * **ByteDance** — Bytespider, TikTokSpider
 * **Apple** — Applebot
 * **Amazon** — Amazonbot
 * **Cohere** — cohere-ai
 * **You.com** — YouBot
 * **DuckDuckGo** — DuckDuckBot
 * **Common Crawl / Research** — CCBot, AI2Bot
 * **SEO tools** — AhrefsBot, AhrefsSiteAudit, SemrushBot, DotBot, Barkrowler, DataForSeoBot,
   ScreamingFrog
 * **Other search engines** — BaiduSpider, Yandexbot, Naverbot, ShapBot

#### Privacy

The plugin reads log files already stored on your server. It does **not** set cookies,
collect personal data from visitors, or make any external HTTP requests. Raw log
lines are never stored in the WordPress database — only aggregated counts and parsed
metadata are persisted.

#### Source log support

 * WordPress `debug.log` (WP_DEBUG_LOG)
 * PHP `error_log` (auto-detected from `php.ini`)
 * Plugin-owned live traffic log (zero-config, works on any host)
 * Web server access log (optional path in Settings)
 * Up to 3 custom log paths

## عکس‌های صفحه

[⌊Dashboard — KPI cards, per-bot daily trend chart, and bot-share donut chart.⌉⌊
Dashboard — KPI cards, per-bot daily trend chart, and bot-share donut chart.⌉[

**Dashboard** — KPI cards, per-bot daily trend chart, and bot-share donut chart.

[⌊Bot Details — per-bot breakdown with company, type, page-level stats, and HTTP
status distribution.⌉⌊Bot Details — per-bot breakdown with company, type, page-level
stats, and HTTP status distribution.⌉[

**Bot Details** — per-bot breakdown with company, type, page-level stats, and HTTP
status distribution.

[⌊Log Viewer — raw log lines with type/severity badges and live refresh.⌉⌊Log Viewer—
raw log lines with type/severity badges and live refresh.⌉[

**Log Viewer** — raw log lines with type/severity badges and live refresh.

[⌊Settings — log source configuration, sync interval, and retention settings.⌉⌊Settings—
log source configuration, sync interval, and retention settings.⌉[

**Settings** — log source configuration, sync interval, and retention settings.

## نصب

 1. Upload the `geo-metrics-logs` directory to `/wp-content/plugins/`, or install via
    the WordPress Plugins screen.
 2. Activate the plugin through the **Plugins** screen.
 3. Go to **GEO AI Monitor** in the left admin menu.
 4. _(Optional)_ In the **Settings** tab, enter the path to your web server access 
    log and any custom log paths.
 5. Click **Manual Sync** to parse logs immediately, or wait for the next WP-Cron run.

## سوالات متداول

### I don’t have access to my server’s access log. Can I still detect bots?

Yes. The plugin’s built-in Live Traffic Monitor captures every request through WordPress’s
hook system and writes its own Combined Log Format file inside `wp-content/uploads/
geo-metrics-logs/`. No server log access or WP_DEBUG configuration is required.

### How much memory does reading large log files use?

Log files are read using `SplFileObject` which streams lines without loading the
entire file into memory. By default all available lines are read. If you have very
large log files (hundreds of MB), you can set a **Lines per Source** limit in Settings
to cap how many lines are parsed per sync.

### Where is the parsed data stored?

Aggregated counts and bot lists are stored in WordPress options. Raw parsed events
are cached in a WordPress transient with a 6-hour TTL. Raw log file content is never
written to the database.

### Can I use this with Cloudflare?

Yes. Enable **Trust Proxy Headers** in Settings to use `CF-Connecting-IP` (or `X-
Forwarded-For`) for correct visitor IP detection. Only enable this if your site 
is actually behind a trusted proxy.

### How do I set the access log path on cPanel / shared hosting?

Common paths are `/home/username/logs/access.log` or `/var/log/apache2/access.log`.
Contact your host if unsure. The Settings page shows a **Readable** / **Not readable**
indicator after you save the path.

### Does the plugin slow down my site?

The Live Traffic Monitor hook fires at `template_redirect` (priority 99) and writes
a single line to disk — negligible overhead. Log parsing runs on WP-Cron, not on
page load.

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“GEO Metrics AI Traffic Monitor” نرم افزار متن باز است. افراد زیر در این افزونه 
مشارکت کرده‌اند.

مشارکت کنندگان

 *   [ abignu ](https://profiles.wordpress.org/abignu/)

[ترجمه “GEO Metrics AI Traffic Monitor” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/geo-metrics-ai-traffic-monitor)

### علاقه‌ مند به توسعه هستید؟

[کد را مرور کنید](https://plugins.trac.wordpress.org/browser/geo-metrics-ai-traffic-monitor/)،
[مخزن SVN](https://plugins.svn.wordpress.org/geo-metrics-ai-traffic-monitor/) را
بررسی کنید، یا از طریق [RSS](https://plugins.trac.wordpress.org/log/geo-metrics-ai-traffic-monitor/?limit=100&mode=stop_on_copy&format=rss)
در [گزارش توسعه](https://plugins.trac.wordpress.org/log/geo-metrics-ai-traffic-monitor/)
مشترک شوید.

## گزارش تغییرات

#### 2.4.2

 * Moved live monitor log storage from wp-content/ to the uploads directory (wp_upload_dir()).
 * Chart data now injected via wp_add_inline_script() instead of a raw tag.
 * Updated bundled Chart.js from 4.4.4 to 4.5.1.
 * Fixed plugin header description to accurately reflect that no external HTTP requests
   are made.

#### 2.4.0

 * Per-bot daily chart: the trend line chart now shows a separate colored line for
   each detected bot.
 * Removed 500-line read cap — plugin now reads all available log lines by default(
   configurable limit for memory-constrained environments).
 * Purple top-accent border applied to all KPI stat cards for visual consistency.
 * Admin menu icon uses native WordPress dashicon rendering.
 * Lazy-populate fallback: `daily_bot_counts` option is rebuilt from the transient
   cache on first load after upgrade, so the chart is populated immediately without
   waiting for the next sync.

#### 2.3.0

 * Added date-range filter bar with quick presets (Last 7 / 30 days, This month).
 * Dashboard data updates via AJAX without page reload when a date filter is applied.

#### 2.2.0

 * Bot Details tab: per-bot pages visited table, HTTP status badge distribution.
 * Bot type classification (crawler / agent / search / researcher) with color-coded
   badges.
 * Company grouping for bots (OpenAI, Anthropic, Google, Meta, etc.).

#### 2.1.0

 * Live Traffic Monitor: plugin now writes its own access log — bot detection works
   without server log access.
 * Automatic 5 MB log rotation.
 * Proxy header support (X-Forwarded-For / CF-Connecting-IP).

#### 2.0.0

 * Added 20+ new bot signatures: GrokBot, MistralAI-User, Gemini, Google-Agent, 
   TikTokSpider, CCBot, AI2Bot, SEO researcher bots, and more.
 * Donut chart for bot share of voice.
 * Configurable data retention (default 30 days).
 * Configurable sync schedule.

#### 1.0.0

 * Initial release.
 * Detects GPTBot, ClaudeBot, PerplexityBot, Googlebot, bingbot, and 10 additional
   LLM bots.
 * Dashboard with KPI cards and daily trend chart.
 * Log Viewer with raw line display.
 * WP-Cron sync with configurable interval.
 * Zero-config bot detection from WordPress logs.

## اطلاعات

 *  نگارش **2.4.2**
 *  آخرین به‌روزرسانی **4 ماه پیش**
 *  نصب‌های فعال **50+**
 *  نگارش وردپرس ** 6.0 یا بالاتر **
 *  آزمایش‌شده تا **7.0.7**
 *  نگارش PHP ** 8.1 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/geo-metrics-ai-traffic-monitor/)
 * برچسب
 * [AI](https://fa.wordpress.org/plugins/tags/ai/)[bot detection](https://fa.wordpress.org/plugins/tags/bot-detection/)
   [LLM](https://fa.wordpress.org/plugins/tags/llm/)[logs](https://fa.wordpress.org/plugins/tags/logs/)
   [monitoring](https://fa.wordpress.org/plugins/tags/monitoring/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/geo-metrics-ai-traffic-monitor/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

[بررسی شما](https://wordpress.org/support/plugin/geo-metrics-ai-traffic-monitor/reviews/#new-post)

[مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/geo-metrics-ai-traffic-monitor/reviews/)

## مشارکت کنندگان

 *   [ abignu ](https://profiles.wordpress.org/abignu/)

## پشتیبانی

مشکلات حل شده در دو ماه گذشته:

     0 از 1

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/geo-metrics-ai-traffic-monitor/)