Cato API - AccountMetrics > 時系列

クエリで指定された時間枠(バケット)に従って、アカウントのメトリクスを表示します。 履歴とほぼリアルタイムの統計およびメトリクスを含みます。 このデータは、各サイトのCato管理アプリケーションのサイト接続ウィンドウに似ています。

時系列フィールド

時系列フィールドは、AccountMetricsデータの時間枠と、それが時間バケットに従ってどのように表示されるかを示しています。

AccountMetricsフィールドがクエリに返せる詳細は次の通りです。

  • data - タイムスタンプに基づくメトリクスをタプルの配列として返します
  • label - labels引数で定義されたメトリクス
  • sum - 指定された時間枠内でのメトリクスの概要
  • units - メトリクスの測定単位
  • info - このデータセットに関連する情報

データ

データフィールドは、各々が二つの値を含むタプルの配列です:[timestamp, metric]。

  • timestamp - エポック(1970年1月1日)からの経過時間(ミリ秒単位)
  • metric - labels引数で要求したデータ

データ引数

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

ラベル

ラベルフィールドは、時系列> labels引数で定義された値を示します。

合計

合計フィールドは、クエリの時間枠での値の要約を示します。

単位

単位フィールドはこれらのメトリクスの測定単位を示します。

  • バイト
  • パケット
  • ビット
  • ms
  • パーセント
  • score - 分析 > サイト > 接続ウィンドウに類似したサイトの健康分析
  • count - この単位の出現回数
  • 秒 - トンネルの年齢など、秒単位で測定されるメトリクスの場合の秒数

情報

情報フィールドはこのデータセットに関する情報を示します。例えば、サイトID、ソケット、インタフェース。

時系列引数

時系列引数は、クエリのラベルとバケットを定義します。

  • ラベル - クエリのメトリクスを定義する列挙型配列
  • バケット - クエリの時間の持続期間を定義します

ラベル

ラベル引数はクエリが返すメトリクスを定義するための配列です。 例えば、アップストリームおよびダウンストリームトラフィックのバイト数です。

注意: ラベルによって返されるすべてのデータは、その時間バケットの期間におけるメトリクスを示します。

この引数のオプションは次の通りです。

  • bytesUpstream - アップストリームトラフィックの総バイト数(CatoCloudからサイトへの)
  • bytesDownstream - ダウンストリームトラフィックの総バイト数(CatoCloudからサイトへの)
  • bytesUpstreamMax - 最大アップストリームスループット(バイト) - 時間バケットが最小値の5であるとき、bytesUpstreamMaxはbytesUpstreamと同じです
  • bytesDownstreamMax - ダウンストリーム帯域幅の最大許容帯域幅(バイト) - 時間バケットが最小値の5であるとき、bytesDownstreamMaxはbytesDownstreamと同じです
  • packetsUpstream - アップストリームパケットの合計
  • packetsDownstream - ダウンストリームパケットの合計
  • lostUpstream - アップストリームトラフィックのパケットロス数
  • lostDownstream - ダウンストリームトラフィックのパケットロス数
  • lostUpstreamPcnt - アップストリームトラフィックのパケットロスの割合
  • lostDownstreamPcnt - ダウンストリームトラフィックのパケットロスの割合
  • packetsDiscardedDownstream - ダウンストリームトラフィックで破棄されたパケットの合計
  • packetsDiscardedUpstream - アップストリームトラフィックで破棄されたパケットの合計
  • jitterUptstream - アップストリームトラフィックのジッター(データパケット間の時間遅延のミリ秒(ms)単位の差)
  • jitterDownstream - ダウンストリームトラフィックのジッター(データパケット間の時間遅延のミリ秒(ms)単位の差)
  • bytesTotal - アップストリームおよびダウンストリームトラフィックの総バイト数
  • rtt - サイトからCatoCloudまでの往復時間
  • health - 分析 > サイト > 接続 ウィンドウに類似したサイトの健康分析
  • tunnelAge - 最後の再接続からのDTLSトンネルの経過時間(ミリ秒単位)
  • lastMilePacketLoss - ソケットからCatoCloudへのパケットロスを測定し、ISPのラストマイル性能を評価
  • lastMileLatency - ソケットからCatoCloudへの遅延を測定し、ISPのラストマイル性能を評価

バケット

バケット 引数は、クエリの時間間隔(timeFrame引数で定義)のためのバケット数を定義します。 例えば、24時間の時間間隔に48バケットがあると、各バケットの時間持続時間は30分になります。

バケット引数と粒度フィールドの詳細については、Working with accountMetrics > Granularityをご覧ください。

クエリでバケット引数を使用するための詳細は以下の通りです。

  • デフォルト値 - 10バケット
  • 最小値 - 粒度5秒のバケット1個
  • 最大値 - 1000バケット

この記事は役に立ちましたか?

0人中0人がこの記事が役に立ったと言っています

0件のコメント