---
title: "Cato API - アカウントメトリクス > サイト > インタフェース"
slug: "cato-api-accountmetrics-sites-interfaces"
updated: 2026-07-30T01:21:07Z
published: 2026-07-30T01:21:07Z
canonical: "knowledge.catonetworks.com/cato-api-accountmetrics-sites-interfaces"
---

> ## 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 - アカウントメトリクス > サイト > インタフェース

## アカウントメトリクス > サイト > インタフェース

アカウントメトリクス > サイト > インタフェースフィールドにはサイトのソケットWANリンクに関連するデータが含まれます。

## インタフェースメトリクス項目

インタフェースメトリクス項目にはソケットWANリンクのデータが含まれます。 これはクエリの詳細と項目です：

- メトリクス - リンクのトラフィックデータ（入れ子になったフィールドの配列）
- 名前 - Cato管理アプリケーションでのリンク名
- タイムシリーズ - データの時間枠を示し、バケットとデータの関係を定義する（入れ子になったクエリと項目の配列）
- 注釈 - GUIの時間増分を示すタイムスタンプ注釈（入れ子になったクエリと項目の配列）
- 期間 - 特定の時間の期間オブジェクト（入れ子になったフィールドの配列）
- 情報 (SocketInterface) - ゲートウェイIPアドレスなどのリンクに関連するデータ（ネストされたフィールドの配列）
- remoteIPinfo - 国コードなどのリンクIPアドレスに関連するデータ（ネストされたフィールドの配列）
- リモートIP - このリンクのISPのIPアドレス
- ソケット情報 - ソケットとvソケットサイトに関連するデータ、シリアル番号とソケットバージョンなど（入れ子になったフィールドの配列）
- ipsec情報 - IPsecサイトに関連するデータ、IKEバージョンなど（入れ子になったフィールドの配列）
- インタフェース情報 - ソケットインタフェースの基本設定に関する情報（入れ子になったフィールドの配列）

## メトリクス (インタフェースメトリクス)

メトリクス項目はWANリンクのトラフィック分析を表示します。 以下はフィールドの詳細です：

- 期間 - ソケットデータの総時間量
- グラニュラリティ - メトリクスバケットに対する単一の秒数
- 下りバイト数 - Catoクラウドからソケットへの総下りトラフィック
- 上りバイト数 - ソケットからCatoクラウドへの総上りトラフィック
- 総バイト数 - ソケットの総トラフィック
- 下りパケット喪失 - 下りトラフィックで喪失したパケットの数
- 下りパケット喪失パーセント - 下りトラフィックでのパケット喪失率
- 上りパケット喪失 - 上りトラフィックで喪失したパケットの数
- 上りパケット喪失パーセント - 上りトラフィックでのパケット喪失率
- 下りパケット数 - 総下りパケット数
- 上りパケット数 - 総上りパケット数
- 上りジッター - 上りトラフィックのジッター（データパケット間の時間遅延の差 (ミリ秒)）
- 下りジッター - 下りトラフィックのジッター（データパケット間の時間遅延の差 (ミリ秒)）
- 下り廃棄パケット - 下りトラフィックでの総廃棄パケット
- 上り廃棄パケット - 上りトラフィックでの総廃棄パケット
- rtt - ソケットからCatoクラウドへの往復時間

toRate引数

boolean引数toRateが**true**に設定されていると、データは秒単位で返されます。 引数がfalseに設定されている場合、クエリは全時間期間を通じてデータを返します。

toRate引数はバイト単位のデータ型にのみ適用され、rtt、健全性などには適用されません。

## 名前

名前フィールドはCato管理アプリケーション（**設定 > サイト >** ソケット**設定**）で設定されているリンクの名前を表示します。

## タイムシリーズ

インタフェースメトリクスタイムシリーズ項目は、クエリで指定された時間枠（バケット）に従ってリンクのメトリクスを表示します。 歴史とほぼリアルタイムの統計とメトリクスを含む。

インタフェースメトリクスタイムシリーズ項目と引数の詳細は、アカウントメトリクスタイムシリーズと同じです。詳細は[Cato API - アカウントメトリクス > タイムシリーズ](/v1/docs/cato-api-accountmetrics-timeseries)をご覧ください。

## 注釈

注釈項目と引数は時間とイベントタイプに従って特定のイベントを表示します。 これらは項目の詳細です：

- 時間 - イベントのタイムスタンプ
- ラベル - イベントの説明
- ショートラベル - イベントの簡単な説明
- タイプ - イベントの種類
  - ポップ変更 - サイトが異なるPoPに接続します
  - ロール変更 - HAステータスロールの変更
  - リモートIP変更 - ISP IPアドレス（リモートIP）の変更
  - 一般 - 注釈に含まれるその他のイベント

注釈タイプ引数

クエリに含まれるイベントタイプを指定： ポップ変更、ロール変更、または一般的。

## 期間

期間項目は指定された時間における期間型メトリクスを表示します。 次は項目の詳細です：

- 期間 - 開始インデックスと終了バケットインデックスに従い、開始時間と終了時間（ミリ秒単位）を示す二つの数値のタプル
- タイトル - メトリクスを説明するラベル
- タイプ - この期間のデータタイプを識別するenum配列：
  - パケットロス - 接続問題によるパケットの損失
  - データなし - 期間に利用可能なデータなし
  - パッシブリンク - リンクは待機モードでトラフィックを通さない
  - アクティブ - リンクはアクティブな負荷状態でトラフィックを通します
  - オーバーフロー - いくつかのパケットがキューに入り、遅延後に送信されました
  - 輻輳 - キュー中にタイムアウトしたため、いくつかのパケットが廃棄されました
  - ラストマイルパケットロス - ソケットとPoP間のパケットロスを測定
  - ラストマイルレイテンシー - ソケットとPoP間のレイテンシーを測定
  - 一般 - 不明な理由でリンクに影響がありました
  - ポップ - リンクが現在接続されている特定のPoP

## リモートIP情報

リモートIP情報項目はリンクのIPアドレスを示すデータを表示します。 以下はIPアドレスに関連する項目の詳細です：

- ip - リンクのIPアドレス
- 国コード - 地理位置ISO国コード
- 国名 - 地理位置国名
- 都市 - 地理位置都市
- 州 - 地理位置州
- プロバイダ - ISPインターネットプロバイダ
- 緯度 - ISPの地理位置緯度
- 経度 - ISPの地理位置経度

## リモートIP

リモートIP項目は、リモートIP情報からの追加データなしでリンクのIPアドレスを表示します。

## ソケット情報

**ソケット情報**フィールドは、バージョン番号やシリアル番号などのソケットに関するデータを表示します。 次はフィールドの詳細です：

- id - ソケットのユニークなID
- シリアル - ソケットのシリアル番号
- isPrimary - HA構成の場合、この真のboolean値が設定されているとき、これがプライマリソケットです
- プラットフォーム - ソケットの種類を表示します：
  - not_set - ソケットのプラットフォームが設定されていません
  - VM - レガシー値
  - X1 - レガシー値
  - X1500 - X1500ソケット
  - NATIVE - レガシー値
  - X1500_BR2 - TBD
  - X1700 - X1700ソケット
  - AWS1500 - AWS vソケット
  - RPI64 - レガシー値
  - AZ1500 - Azure vソケット
  - ESX1500 - VMware ESX vソケット
- バージョン - 現在ソケットにインストールされているソフトウェアバージョン番号
- バージョン更新時間 - ソケットが現在のハードウェアバージョンにアップグレードされたタイムスタンプ

## ipsec情報

**ipsec情報**フィールドは、IPsecサイトの接続設定に関するデータを表示します。 以下はフィールドの詳細です：

- isPrimary - HA構成の場合、この真のboolean値が設定されているとき、これがプライマリIPsecファイアウォールまたはルーティングデバイスです
- catoIP - CatoクラウドのIPsecトンネルの送信元IPアドレス
- リモートIP - IPsecトンネルの宛先IPアドレス（サイト内）
- IKEバージョン - IKEv1の場合は1, IKEv2の場合は2を表示

## インタフェース情報

インタフェース情報項目は、Cato管理アプリケーション（**設定 > サイト >** ソケット**設定**）で設定されたサイトのソケットポートに関連するデータを含んでいます。 以下はフィールドの詳細です：

- id - ソケットWebUI **モニタ**タブ内のソケットポートのID
- 名前 - Cato管理アプリケーションでのポートの名前
- 上り帯域幅 - このポートで許可される最大帯域幅、サイトからCatoクラウドへのトラフィック用
- 下り帯域幅 - このポートでのトラフィック用に許可される最大帯域幅、Catoクラウドからサイトへ