--- title: "Cato API - アカウントメトリクス" slug: "cato-api-accountmetrics" updated: 2026-07-30T01:21:02Z published: 2026-07-30T01:21:02Z canonical: "knowledge.catonetworks.com/cato-api-accountmetrics" --- > ## 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 - アカウントメトリクス Cato APIを使用する前に、[Cato APIのサポートポリシー](/v1/docs/support-policy-for-the-cato-api)を確認することを強くお勧めします。 ## アカウントメトリクスの概要 アカウントメトリクスクエリは、サイトやSDPユーザーのCato Cloudへの接続の状態と品質を分析するのに役立ちます。 このデータは、サイトとCato Cloud間のDTLSトンネル内のトラフィックに関するものです。 アカウントメトリクスは、アカウントの歴史的なメトリクス、統計、および分析を表示します。 これは、Cato管理アプリケーションの**サイト接続**ウィンドウに類似したデータを返します。 販売代理店のアカウントに対して、接続している顧客アカウント内に別々のAPIキーを作成することができます。 レート制限とアカウントメトリクスAPIクエリに関する詳細は、[Cato APIのレート制限の理解](/v1/docs/understanding-cato-api-rate-limiting)を参照してください。 ## バケットの粒度とAPIクエリ制限の作業 アカウントメトリクスAPIクエリごとに返されるアイテムの最大数は100,000です。 あるクエリがこの制限に達すると、そのクエリは追加のデータを返さず、エラーメッセージが表示されます。 Catoは次の要素を掛け合わせてこの制限を計算します。 - サイト数プラスVPNユーザー - メトリック数（APIラベル/テレメトリー） - バケット数 つまり、（サイト数 + VPNユーザー）*（メトリック）*（バケット）の合計が100,000未満でなければなりません。 例えば、次のクエリはエラーを引き起こします： - 10サイト - 140 VPNユーザー - 5メトリック - 150バケット (10 + 140) * 5 * 150 = 112,500 アイテムがクエリに含まれています。 この例では、クエリを正常に実行するためにバケット数を減らすことができます。 APIラベルのタイプについて詳しくは、[Cato API - アカウントメトリクス > タイムシリーズ](/v1/docs/cato-api-accountmetrics-timeseries)を参照してください。 ### クエリの最小粒度の計算 このセクションでは、クエリの時間枠に基づいて最小粒度（バケットサイズ）を計算する方法を説明します。 1. 時間枠 - 時間枠を秒に換算 2. バケット制限 - 100,000 / ( (サイト数 + VPNユーザー) * (メトリック) )に基づいてバケット制限を計算。 3. 最小粒度 = (時間枠) / (バケット制限) 例えば、以下の表の最初の行は、7日間、100サイトとVPNユーザー、5メトリックでのクエリ制限を示しています。 - 7日間 = 604,800秒 - 200 バケット = 10000 / (100) * (5) - 3024秒の最小粒度 = 604800 / 200 以下の表は、最小バケット粒度を持つアカウントメトリクスクエリのサンプル設定を示しています。 | クエリ時間枠（日） | サイトとVPNユーザー | メトリック（ラベル） | バケット制限 | 最小粒度（秒） | | --- | --- | --- | --- | --- | | 7 (604800秒) | 100 | 5 | 200 | 3024 | | 7 (604800秒) | 100 | 10 | 100 | 6048 | | 7 (604800秒) | 500 | 10 | 20 | 30240 | | 3 (259200秒) | 100 | 5 | 200 | 1296 | | 3 (259200秒) | 100 | 10 | 100 | 2592 | | 3 (259200秒) | 500 | 10 | 20 | 12960 | | 1 (86400秒) | 100 | 5 | 200 | 432 | | 1 (86400秒) | 100 | 10 | 100 | 864 | | 1 (86400秒) | 500 | 10 | 20 | 4320 | ## アカウントメトリクスフィールドの詳細 これらは、クエリに対してアカウントメトリクスフィールドが返すことができる詳細です： - ID - アカウントID - from - 開始時刻 - to - 終了時刻 - 粒度 - バケットサイズ - sites - 各サイトに対して返されるデータ（ネストされたクエリとフィールドを持つ配列） - タイムシリーズ - データの時間枠を示し、バケットとデータの関係を定義します（ネストされたクエリとフィールドを持つ配列） ## アカウントメトリクスID IDフィールドは、ユニークなアカウント内部IDを表示します。 このアカウントIDはCato管理アプリケーションには表示されず、URL内の番号です。 例えば、以下のURL 中のアカウントIDは26です： https://cc2.catonetworks.com/#!/**26**/topology。 ## アカウントメトリクスFrom Fromフィールドはクエリデータの開始時刻を示し、timeFrame引数で定義されます。 ## アカウントメトリクスTo Toフィールドはクエリデータの終了時刻を示し、timeFrame引数で定義されます。 ## アカウントメトリクスの粒度 粒度フィールドは、単一のメトリックバケットの秒単位の期間を示します。 バケットの数は、タイムシリーズ>バケット引数で定義されています。 粒度は次の式に基づいて計算されます：timeFrame/buckets。 例えば、クエリが60のバケットで5分間のデータを返す場合、粒度（バケットサイズ）は5秒（300秒/60）です。 バケットの最小粒度は5秒です。 バケットの粒度が5秒未満の場合、そのバケットにはデータが返されない可能性があります。 粒度フィールドについての詳細は、[アカウントメトリクス > 粒度](/v1/docs/working-with-accountmetrics-granularity)を参照してください。 ## アカウントメトリクスサイト サイトフィールドには、アカウント内の1つ以上のサイトに関連するデータが含まれています。 VPNユーザーについても、ユーザーIDでデータを指定できます。 アカウントメトリクスのサイトフィールドについての詳細は、[Cato API - アカウントメトリクス > サイト](/v1/docs/cato-api-accountmetrics-sites)を参照してください。 ## アカウントメトリクスタイムシリーズ 指定された時間枠（バケット）に基づいてアカウントのメトリクスを表示し、過去の統計およびメトリクスを含みます。 このデータは、Cato管理アプリケーションの各サイトの**サイト接続**ウィンドウのフィールドに類似しています。 アカウントメトリクスのタイムシリーズフィールドについての詳細は、[Cato API - アカウントメトリクス > タイムシリーズ](/v1/docs/cato-api-accountmetrics-timeseries)を参照してください。 ## アカウントメトリクスの引数 これらは、クエリが返すデータを渡して定義できる引数です： - accountID - アカウントID - ID - アカウントID（レガシー引数） - timeFrame - クエリの開始時刻と終了時刻 - groupInterfaces - リンクのアナリティクスを1つのリンクにまとめます（boolean値**true**の場合）。 - groupDevices - 複数のサイト及び、複数のソケットを持つ単一のサイトの場合、アナリティクスを1つのソケットに統合します（boolean値**true**の場合）。 ## アカウントメトリクスアカウントID引数 クエリが返すデータのアカウントIDを入力します。 この引数は必須です。 このアカウントIDはCato管理アプリケーションには表示されず、URL内の番号です。 例えば、以下のURL 中のアカウントIDは26です： https://cc2.catonetworks.com/#!/**26**/topology。 ## アカウントメトリクスの時間枠引数 クエリが返すデータの時間枠を入力します。 引数は`<type>.<time value>`の形式です。。 この引数は必須です。 時間枠を定義するためにサポートされているオプションは次のとおりです： - last.