プッシュメトリクスRESTAPIについて
最終更新日: 09 年 2024 月 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 | 110 | 330 | 101 | 128 | 指定されたpercentileValueに依存します* | 128 |
12:01:05 = 125 12:01:25 = 107 12:01:45 = 101 | 111 | 333 | 101 | 125 | 指定されたpercentileValueに依存します* | 101 |
12:02:05 = 100 12:02:25 = 101 12:02:45 = 105 | 102 | 306 | 100 | 105 | 指定されたpercentileValueに依存します* | 105 |
ゲージメトリックの場合、これらの値はそのまま保存されます。 カウンターメトリックの場合、XNUMX秒あたりのレートを計算しているため、レートは前のタイムスタンプと現在のタイムスタンプの時間差に基づいています。
集計方法は、APIリクエストで指定されたdataPointAggregationTypeフィールドによって決定されます。 詳細については、を参照してください。 Push Metrics RESTAPIを使用したメトリックの取り込み。
メトリックデータの制限時間は、API呼び出し元とLogicMonitorの間で、過去XNUMX分から将来XNUMX分まで可能です。 このウィンドウ外のタイムスタンプを持つデータは無視されます。 さらに、そのインスタンスによってすでに取り込まれたデータより前のタイムスタンプを持つインスタンスのデータを送信することはできません。
エンドポイント
Push Metrics REST APIは、次のXNUMXつのエンドポイントで構成されています。
- https://{ACCOUNTNAME}.logicmonitor.com/rest/metric/ingest. このエンドポイントは、単一のリソースとデータソースに関連付けられた複数のインスタンスの複数のメトリックを取り込みます。 見る Push Metrics RESTAPIを使用したメトリックの取り込み.
- https://{ACCOUNTNAME}.logicmonitor.com/rest/resource_property/ingest. このエンドポイントは、既存のリソースの新しいプロパティを更新または追加します。 見る Push Metrics RESTAPIを使用したリソースプロパティの更新.
- https://{ACCOUNTNAME}.logicmonitor.com/rest/instance_property/ingest. このエンドポイントは、既存のインスタンスの新しいプロパティを更新または追加します。 見る Push Metrics RESTAPIを使用したインスタンスプロパティの更新.
ステータスコード
Push Metrics RESTAPIによって返されるステータスコードの詳細は次のとおりです。 REST APIv2について.