# ダッシュボードレポート - Webクローラーのユーザーエージェント

**URL:** <https://meta.discourse.org/t/dashboard-report-web-crawler-user-agents/294762>\
**Category:** Data & reporting\
**Tags:** sql-query, dashboard-reports, dashboard-sql\
**Created:** [2024 年 2 月 8 日午後 11:28 UTC](https://meta.discourse.org/t/dashboard-report-web-crawler-user-agents/294762 "2024-02-08T23:28:54Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![SaraDev](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/saradev/32/335139_2.png) [@SaraDev](https://meta.discourse.org/u/SaraDev)\
**Post date:** [2024 年 2 月 8 日午後 11:28 UTC](https://meta.discourse.org/t/dashboard-report-web-crawler-user-agents/294762/1 "2024-02-08T23:28:55Z")

</div>

これは、WebクローラーのユーザーエージェントのダッシュボードレポートのSQLバージョンです。

このダッシュボードレポートは、ページビュー数でソートされた上位のWebクローラーユーザーエージェントをリストし、どのクローラーがサイトで最もアクティブであるかについての洞察を提供します。

```sql
--[params]
-- date :start_date = 2024-01-06
-- date :end_date = 2024-02-07

SELECT
  user_agent,
  SUM(count) AS pageviews
FROM web_crawler_requests
WHERE date BETWEEN :start_date AND :end_date
GROUP BY user_agent
ORDER BY pageviews DESC

```

### SQLクエリの説明

- **パラメータ** : クエリは、レポートの時間範囲を定義する `:start_date` と `:end_date` の2つのパラメータを受け入れます。両方の日付パラメータは `YYYY-MM-DD` の形式を受け入れます。
- **SELECT** : クエリは、フォーラムへのWebクローラーによるリクエストを記録する `web_crawler_requests` テーブルからデータを取得します。このテーブルの各レコードには、クローラーの `user_agent` とページビューの `count` が含まれます。
- **SUM** : `SUM(count)` 関数は、指定された日付範囲内の各 `user_agent` のページビューの合計数を計算します。
- **フィルタリング** : `WHERE` 句は、`date` 列を使用して、指定された日付範囲内にあるレコードのみを含めるようにレコードをフィルタリングします。
- **集計** : `GROUP BY` 句は、結果を `user_agent` でグループ化し、各Webクローラーのデータが個別に要約されるようにします。
- **ソート** : `ORDER BY` 句は、結果を `pageviews` の降順でソートし、最もアクティブなWebクローラーをレポートの上部に配置します。

> :discourse: `web_crawler_requests` テーブルからのレコードは、30日後に自動的に[削除](https://github.com/discourse/discourse/blob/main/app/models/web_crawler_request.rb#L12)されます。このレポートの結果は、レポートが実行された時点から過去30日間のもののみ利用可能ですが、このクエリのデータパラメータを使用して、過去30日間の結果をフィルタリングできます。

### 結果例

| user\_agent | pageviews |
| --- | --- |
| Mozilla/5.0 (compatible; SeekportBot; +https://bot.seekport.com) | 1406 |
| Mozilla/5.0 (compatible; YandexBot/3.0; +http://yandex.com/bots) | 724 |
| Mozilla/5.0 (compatible; DataForSeoBot/1.0; +https://dataforseo.com/dataforseo-bot) | 533 |
| … | … |

---

_[View the full topic](https://meta.discourse.org/t/dashboard-report-web-crawler-user-agents/294762)._
