---
title: "Cato 参照のみ API - appStats"
slug: "cato-read-only-api-appstats"
updated: 2026-07-30T01:26:15Z
published: 2026-07-30T01:26:15Z
canonical: "knowledge.catonetworks.com/cato-read-only-api-appstats"
---

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

# Cato 参照のみ API - appStats

## appStatsの概要

appStats APIはアプリケーションアナリティクス画面に基づいており、ソース、宛先、アプリケーションなどによる時間範囲の集計ネットワークデータを提供します。

各クエリは、特定の集計関数（合計、最大、平均など）と異なる次元（サイト名、ユーザー、アプリなど）に基づく集計を計算します（バイトアップ、バイトダウン、フローの数など）。

appStatsクエリの使用例：

- 特定サイトの全体/平均/最大帯域幅を計算する
- 特定の宛先に生成された最大フロー数
- 特定のホストによる使用数が多いアプリケーショントップ10

## appStatsの引数

これは、クエリによって返されるデータを定義するために渡すことができる引数です（すべてのフィールドは必須です）：

- accountIDs
- measures
- フィルタ
- dimension
- 並べ替え
- 期限

### appStats accountIDs 引数

クエリが返すデータのために1つ以上のアカウントIDを入力してください。

このアカウントIDはCato管理アプリケーションには表示されませんが、Cato管理アプリケーションのURLでの番号です。 たとえば、次のURLにおけるアカウントIDは26です：https://cc.catonetworks.com/#!/26/topology

### appStatsフィルタ引数

`フィルタ`引数は、クエリに含まれる特定のデータを定義します。 これは、定義できる引数です：

- fieldName - フィルタしたいフィールドのタイプを定義する（詳しくは、以下の[appStatsフィールド](/"/v1/docs/cato-read-only-api-appstats#appstats-fields%5C")を参照）
- operator - フィルタ値を活性化する方法を定義する（詳しくは、以下の[appStats filterOperator](/"/v1/docs/cato-read-only-api-appstats#appstats-filteroperator%5C")を参照）
- values - オペレータと一緒に使用するフィルタ値を定義する

次の`フィルタ`構文は、特定のアプリケーションにデータを表示するためにフィルタされたクエリの例です：

```plaintext
"フィルタ": [ { "fieldName": "application", "operator": "is", "values": [ "Slack" ] } ]
```

### appStats寸法引数

`寸法`引数を使用して、同じ値を持つフィールドをサマリ行にグループ化します。

次の例は、サイト名に基づいてフィールドをグループ化します：

```plaintext
"寸法": [ { "fieldName": "site_name" } ]
```

### appStats測定引数

`測定値`引数は、クエリが返すフィールドとその集約タイプを定義します。 定義できる引数は次のとおりです：

- fieldName -フィルタしたいフィールドのタイプを定義する（詳しくは、以下の[appStats Fields](/"/v1/docs/cato-read-only-api-appstats#appstats-fields%5C")を参照）
- aggType - 集約タイプを定義する（詳しくは、以下の[appStats Aggregation](/"/v1/docs/cato-read-only-api-appstats#appstats-aggregation%5C")を参照）

次の例は、Slackアプリケーションで作成されたフローのサマリを測定するための`測定値`構文を示しています：

```plaintext
"フィルタ": [ { "fieldName": "application", "operator": "is", "values": [ "Slack" ] } ] "測定値":[ { "fieldName": "flows_created", "aggType": "sum" }, ]
```

### appStats並べ替え引数

`並べ替え`引数は、データの並び替え方法を定義します。

次の例は、Slackアプリケーションで作成されたフローのサマリを測定するための`並べ替え`構文を示しています。 その後、作成されたフローの降順でデータを並べ替えます：

```plaintext
"フィルタ": [ { "fieldName": "application", "operator": "is", "values": [ "Slack" ] } ] "測定値": [ { "fieldName": "flows_created", "aggType": "sum" }, ] "並べ替え": [ { "fieldName": "flows_created", "order": "dec" }, ]
```

### appStarts 時間枠引数

クエリの`時間枠`を定義します。

```plaintext
"timeFrame": "last.P2D"
```

## サンプル appStats クエリ

これは、Slackアプリケーションの各サイトにおける過去2日間の期間で作成されたフローの合計を返すためにappStats APIクエリを使用する例です。 データはトップ5サイトの順に降順でソートされます。

**サンプルクエリ**

```plaintext
query appStats($accountID: ID!, $measures: [Measure], $dimensions: [Dimension], $filters: [AppStatsFilter!], $sort: [AppStatsSort!], $timeFrame: TimeFrame!, $limit: Int, $from: Int) { appStats( accountID: $accountID timeFrame: $timeFrame measures: $measures dimensions: $dimensions filters: $filters sort: $sort ) { id records(limit: $limit, from: $from) { fieldsUnitTypes fieldsMap trends } } }
```

**変数値**

```plaintext
{ "accountID": "1234", "dimensions": [ { "fieldName": "site_name" } ], "測定値": [ { "fieldName": "flows_created", "aggType": "sum" }, ], "フィルタ": [ { "fieldName": "application", "operator": "is", "values": [ "Slack" ] } ] "並べ替え": [ { "fieldName": "flows_created", "order": "desc" } ], "timeFrame": "last.P2D", "limit": 5, "from": 0 }
```

**サンプルAppStats出力**

```plaintext
{ "data": { "appStats": { "id": "1234", "records": [ { "fieldsMap": { "flows_created": "116660", "site_name": "Sample Socket" } }, { "fieldsMap": { "flows_created": "105655", "site_name": " Sample Socket 2" } } ] } } }
```

## appStats フィールド

これは、appStatsクエリ内のフィールドの説明です。

| アイテム | 説明 |
| --- | --- |
| アプリケーション | クラウドアプリケーション名 |
| new_app | 最新のクラウドアプリケーション識別子 |
| discovered_app | 使用されているアプリの総数 |
| トラフィック | 上流データと下流データの合計バイト数 |
| 上り | クラウドアプリケーションへのアップロードデータ |
| 下り | クラウドアプリケーションからのダウンロードデータ |
| risk_score | Catoによって割り当てられたアプリケーションリスクスコア |
| risk_level | アプリケーションのリスクレベル |
| 承認済み | 組織により使用が承認され、管理されているクラウドアプリケーション |
| hq_location | 登録アプリケーションの本社が所在する国 |
| is_cloud_app | アプリケーションがクラウドアプリ/SaaSアプリとみなされるかどうかを示します |
| カテゴリ | クラウドアプリケーションカテゴリ |
| 説明 | カテゴリの説明 |
| IP | ホストまたはSDPクライアントのIP |
| サブネット | サブネットの名前 |
| ドメイン | SSL SNI、HTTPホスト名、DNS名、または宛先IP |
| dest_ip | サーバーIPアドレス（WAN接続の場合のみ関連） |
| src_site_id | サイトの内部Cato ID |
| src_site_name | ソースサイトまたはSDPユーザー |
| site_country | サイトの所在国 |
| site_state | サイトの所在州 |
| vpn_user_id | SDPユーザーの内部Cato ID |
| flows_created | 作成された接続数 |
| dest_site | 宛先サイトまたはSDPユーザーID（proto） |
| dest_is_site_or_vpn | 宛先サイトまたはSDPユーザー |
| dest_site_id | 宛先サイトまたはSDPユーザーID（DB） |
| dest_site_name | 宛先サイトまたはSDPユーザ名 |
| traffic_direction | トラフィックの方向 |
| device_name | PCまたはデバイス名 |
| ad_name | Active Directory 名 |
| src_ip | ホストまたはSDPクライアントのIP |
| ソケットインタフェース | ソケットインタフェースの名前 |
| src_is_site_or_vpn | トラフィックはサイトまたはSDPクライアント |

## appStats 集計

これはappStats `集計タイプ`の値です：

- 合計
- 数
- distinct_count
- distinct
- 平均
- 最大値
- 最小
- 全て

## appStats フィルタ演算子

これはappStats フィルタ演算子の値です：

- 該当
- 非該当
- 含む
- 非含む
- 存在する
- 非存在
- 範囲内
- 範囲外
- gt
- gte
- lt
- lte