サポートセンターホーム


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

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分未満の間隔で)送信される場合、値はキャッシュされ、指定された集計方法を使用して集計されます。 集計値はデータポイント値として保存されます。

平均、合計、なしのXNUMXつの集計方法がサポートされています。 次の表に、データがXNUMX分未満の間隔でプッシュされた場合の各集計方法の動作を示します。

サブミニッツ収集時間/データセット各集計方法の保存値
平均合計なし
12:00:05 = 10112:00:25 = 10112:00:45 = 128110330128
12:01:05 = 12512:01:25 = 10712:01:45 = 101111333101
12:02:05 = 10012:02:25 = 10112:02:45 = 105102306105

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

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

API呼び出し元とLogicMonitorの差を設定するために、10分の制限時間が設定されています。 このウィンドウ外のタイムスタンプを持つデータは無視されます。 さらに、そのインスタンスによってすでに取り込まれたデータより前のタイムスタンプを持つインスタンスのデータを送信することはできません。

エンドポイント

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

ステータスコード

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

記事上で