Cato API - AccountMetrics > 時系列

Prev Next

クエリで指定された時間枠(バケット)に基づいてアカウントのメトリックを表示します。 履歴とほぼリアルタイムの統計とメトリックが含まれています。 このデータは、サイトごとのCato管理画面内のサイト接続性ウィンドウに類似しています。

時系列項目

時系列項目は、アカウントメトリックデータの時間枠と、それが時間バケットに従ってどのように表示されるかを示します。

これは、クエリに対してアカウントメトリックの項目が返すことができる詳細です:

  • データ - タイムスタンプに基づいたメトリックがタプルの配列として返されます

  • ラベル - ラベル引数で定義されたメトリック

  • 合計 - 指定された時間枠のメトリックの要約

  • 単位 - メトリックの測定単位

  • 情報 - このデータセットに関連する情報

データ

データ項目は、各タプルが二つの値を含む配列である: [タイムスタンプ, メトリック]。

  • タイムスタンプ - エポックからの時間(ミリ秒)

  • メトリック - ラベル引数で要求されたデータ

データ引数

  • perSecond - 真偽値。 trueに設定された場合、データは一秒あたりの単位に正規化されます(細粒度で除算されます)。 例えば、データが6秒で24バイトを返した場合、それは一秒あたり4バイトとして表示されます。

ラベル

ラベル項目は、時系列 > ラベル引数で定義された値を表示します。

合計

合計項目は、クエリの時間枠にわたる値の概要を表示します。

単位

単位項目は、これらのメトリックの測定単位を表示します:

  • バイト

  • パケット

  • ビット

  • ms

  • パーセント

  • スコア - サイトの健全性アナリティクスはアナリティクス > サイト > 接続性ウィンドウに類似している

  • カウント - このユニットの発生数

  • 秒 - 例えばトンネルエイジなど、秒で計測されるメトリック

情報

情報項目は、このデータセットについての情報を表示します。例: サイトID、ソケット、インターフェース。

時系列の引数

時系列の引数により、クエリに対するラベルとバケットが定義できます。

  • ラベル - クエリのメトリックを定義する列挙型配列

  • バケット - クエリの時間の継続期間のためのバケットの数を定義します

ラベル

ラベル引数はクエリが返すメトリックを定義する配列です。 例えば、バイトでの上りおよび下りのトラフィック。

注: ラベルに対して返されたすべてのデータは、その時間バケットの期間を通じてのメトリックを示します。

これが、この引数のためのオプションです:

  • bytesUpstream - 上流トラフィック(Cato Cloudからサイトまで)のバイトの総数

  • bytesDownstream - 下流トラフィック(Cato Cloudからサイトまで)のバイトの総数

  • bytesUpstreamMax - 最大上流スループット(バイト単位) - タイムバケットが最小値、5 の場合、bytesUpstreamMaxはbytesUpstreamと同じ

  • bytesDownstreamMax - 下流帯域幅(バイト単位)の最大許可帯域幅 - タイムバケットが最小値、5 の場合、bytesDownstreamMaxはbytesDownstreamと同じ

  • packetsUpstream - 総上流パケット数

  • packetsDownstream - 総下流パケット数

  • lostUpstream - 上流トラフィックにおけるパケット損失数

  • lostDownstream - 下流トラフィックにおけるパケット損失数

  • lostUpstreamPcnt - 上流トラフィックにおけるパケット損失率

  • lostDownstreamPcnt - 下流トラフィックにおけるパケット損失率

  • packetsDiscardedDownstream - 下流トラフィックの破棄されたパケット総数

  • packetsDiscardedUpstream - 上流トラフィックの破棄されたパケット総数

  • jitterUptstream - 上流トラフィックのジッター(データパケット間の時間遅延の差 (ms))

  • jitterDownstream - 下流トラフィックのジッター(データパケット間の時間遅延の差 (ms))

  • bytesTotal - 上り及び下りトラフィックの総バイト数

  • rtt - サイトからCato Cloudへの往復時間

  • 健全性 - サイト向けの健全性アナリティクスはアナリティクス > サイト > 接続性ウィンドウに似ています

  • tunnelAge - 最後の再接続からのDTLSトンネルの年齢(ミリ秒)

  • lastMilePacketLoss - ソケットからCato Cloudへのパケット損失、ISPのラストマイルのパフォーマンスを測定

  • lastMileLatency - ソケットからCato Cloudへのレイテンシー、ISPのラストマイルのパフォーマンスを測定

バケット

バケット引数はクエリの時間間隔に対するバケットの数を定義する(timeFrame引数で定義される)。 例えば、48個のバケットを持つ24時間の時間間隔は、各バケットの時間の継続時間が30分であることを意味します。

バケット引数および粗粒度フィールドについての詳細は、アカウントメトリック > 粗粒度とともに作業するを参照してください。

クエリでのバケット引数の使用に関する詳細:

  • デフォルト値 - 10 バケット

  • 最小値 - 粒度5秒の1バケット

  • 最大値 - 1000 バケット