プッシュメトリクスRESTAPIについて

最終更新日: 12 年 2022 月 XNUMX 日

LogicMonitorプッシュメトリクスRESTAPIを使用して、単一のリソースとデータソースに関連付けられた複数のインスタンスのメトリクスをプログラムでプッシュできます。 関連するリソースとデータソースのいくつかの側面を管理することもできます。

ベースURL:
https://{ACCOUNTNAME}.logicmonitor.com / rest
場所 ACCOUNTNAME LogicMonitorアカウント名に置き換えられます。

認証

Push Metrics REST APIには、APIトークン認証が必要です。 LogicMonitor REST APIは、同じAPIトークン認証を使用します。 詳細については、を参照してください。 LogicMonitorのRESTAPIを使用する.

注: 少なくとも、APIのみのユーザーアカウントに関連付けられたロールには、リソースを管理し、LogicModuleを管理するための権限が必要です。 ロールとAPIのみのユーザーアカウントの作成の詳細については、を参照してください。 役割 & ユーザー

集約間隔

プッシュメトリクスRESTAPIは、データポイントメトリクスをXNUMX分にXNUMX回インスタンスにプッシュします。 データが頻繁に(XNUMX分未満の間隔で)送信される場合、値はキャッシュされ、指定された集計方法を使用して集計されます。 集計値はデータポイント値として保存されます。

LogicMonitorは、次の集計方法をサポートしています。

  • 平均
  • 合計
  • 最小値
  • 最大値
  • 百分位数
  • なし(これは最新の値です)

次の表に、データがXNUMX分未満の間隔でプッシュされる場合の各集計方法の動作を示します。

サブミニッツ収集時間/データセット各集計方法の保存値
平均合計最小値最大値百分位数なし
12:00:05 = 101
12:00:25 = 101
12:00:45 = 128
110330101128指定されたpercentileValueに依存します*128
12:01:05 = 125
12:01:25 = 107
12:01:45 = 101
111333101125指定されたpercentileValueに依存します*101
12:02:05 = 100
12:02:25 = 101
12:02:45 = 105
102306100105指定されたpercentileValueに依存します*105
* percentileValueに「80」を指定して10分以内に1個の値(2、3、4、5、6、7、8,10、91、8.4、XNUMX)を送信すると、期待される出力は「XNUMX」になります。

ゲージメトリックの場合、これらの値はそのまま保存されます。 カウンターメトリックの場合、XNUMX秒あたりのレートを計算しているため、レートは前のタイムスタンプと現在のタイムスタンプの時間差に基づいています。

集計方法は、APIリクエストで指定されたdataPointAggregationTypeフィールドによって決定されます。 詳細については、を参照してください。 Push Metrics RESTAPIを使用したメトリックの取り込み。

メトリックデータの制限時間は、API呼び出し元とLogicMonitorの間で、過去XNUMX分から将来XNUMX分まで可能です。 このウィンドウ外のタイムスタンプを持つデータは無視されます。 さらに、そのインスタンスによってすでに取り込まれたデータより前のタイムスタンプを持つインスタンスのデータを送信することはできません。

エンドポイント

Push Metrics REST APIは、次のXNUMXつのエンドポイントで構成されています。

ステータスコード

Push Metrics RESTAPIによって返されるステータスコードの詳細は次のとおりです。 REST APIv2について.

記事上で