プッシュメトリックを取り込むリソースの管理
最終更新日: 15 年 2024 月 XNUMX 日Push Metrics REST API は、LogicMonitor ポータル内の既存のリソースにメトリックをプッシュするように設計されています。さらに、API リクエストを使用して Push Metrics REST API のデフォルト設定を上書きすることもできます。この API リクエストは、クエリに一致する既存のリソースがない場合に新しいリソースを作成します。詳細については、 Push Metrics RESTAPIを使用したメトリックの取り込み.
Push Metrics REST API によって作成されたリソースを含むすべてのリソースは、LogicMonitor プラットフォームに保存されます。さらに、単一のリソースで、Push Metrics API を使用してプッシュ メトリックを取り込み、プルベースの収集方法を使用する DataSources を使用してメトリックを受信することもできます。
プッシュメトリックを取り込むリソースを管理するための要件
Push Metrics を取り込むリソースを管理するには、次のものが必要です。
- リソースグループの「管理」権限
- リソース グループは既存のリソース グループです
プッシュメトリックを取り込むリソースを使用する際の考慮事項と制限
プッシュメトリクスRESTAPIによって作成され、プッシュモデルのデータソースからのみデータを受信するリソースには特定の制限があります。
制限があるため、プッシュ (プルと比較した場合) 通信モデルのコンテキストでは、次のアクションを検討してください。
- リソースに対してActiveDiscoveryを手動で実行する
- リモートセッションを使用してリソースにアクセスする
- インスタンスを手動でポーリングして、現在のデータポイント値を確認します([生データ]タブから開始)。
- インスタンスのデバッグデータ収集([生データ]タブから開始)
プッシュメトリクスを取り込むリソースの表示
- LogicMonitorで、次の場所に移動します リソースツリー> その他情報> プッシュ メトリック データを含む必要なデータ ソースを選択します。
- インスタンスを選択し、 Rawデータ タブには何も表示されないことに注意してください。
関連リソースのプッシュメトリックの固有プロパティ
リソースを、リソース グループにグループ化された複数のデータ ソースに関連付けることができます。また、リソースはアラート ルールで参照できます。
これらの資源はユニークな特性を持っている system.pushmodules
これにより、リソースはプッシュモデルのデータ取り込みをサポートできるようになります。Push Metrics REST API呼び出しで参照されるリソースには、 system.pushmodules
。 に似ています system.categories
プロパティ、 system.pushmodules
プロパティは、対応する Push Metrics DataSources に関連付けられた値で自動的に更新されます。
たとえば、API 呼び出しが Push Metrics REST API に、データソース B を使用してリソース A のメトリックを取り込むように指示すると、次のイベントが発生します。
- データソースBに関連付けられた一意のタグがリソースAに値として追加されます。
system.pushmodules
プロパティ。 - AIマーケティング業界は、 に適用されます データソースB用に作成されたステートメントは、データソースタグを値として持つリソースに関連付けられます。
system.pushmodules
プロパティ。
![[適用先] タブのシステム プロパティを使用してメトリック リソースをプッシュします。](https://www.logicmonitor.com/wp-content/uploads/2024/12/PM-system-property-1024x538.png)
リソースマッチング
Push Metrics REST API を使用してメトリック取り込みの要求が送信されると、LogicMonitor はリソース ID をプロパティとして持つリソースを検索し、その要求をポータル内の既存のリソースとペアリングします。
指定されたリソース ID を持つリソースが複数見つかった場合、エラーが発生します。したがって、目的の結果を得るには、resourceIds フィールドの配列に一意のキーと値のペアが含まれていることを確認する必要があります。
以下は、APIクエリでの使用を検討できる、リソースタイプ別に整理されたシステムプロパティのリストです。 クエリでは任意のリソースプロパティを使用できます。 リソースプロパティの詳細については、を参照してください。 リソースとインスタンスのプロパティ.
標準デバイス/ Kubernetesコンテナ | AWSリソース | GCPリソース | Azureリソース |
システム.ディスプレイ 名前システム.デバイスID システムのホスト名 system.collectorid システム.sysoid System.ips auto.network.mac_address | システム.ディスプレイ 名前システム.デバイスID system.aws.リソースID system.aws.arn | システム.表示名 システム.デバイスID system.gcp.リソースID system.gcp.リソース名 system.gcp.projectId システム.クラウド.カテゴリ system.gcp.リソースID | システム.表示名 システム.デバイスID system.azure.resourceid システム.azure.リソース名 |
既存のリソースが返されず、リクエストで create クエリ パラメータが TRUE に設定されている場合 (デフォルト設定は FALSE)、指定されたリソース ID が設定された新しいリソースが作成されます。
Push Metrics REST APIには、リソースのプロパティの更新専用のエンドポイントがあります。 詳細については、を参照してください。 Push Metrics RESTAPIを使用したリソースプロパティの更新。
削除されたリソースのプッシュメトリクス
他のリソースと同様に、LogicMonitorインターフェイスを介してプッシュメトリックを受信するリソースを検出できます。 ただし、Push Metrics RESTAPIを使用してこれらのリソースを削除することはできません。 リソースが削除されると、そのリソースにプッシュされたデータはすべて無視されます。
削除されたリソースがPushMetrics REST APIを使用して作成され、プッシュモデルのデータソースからのみデータを受信する場合、そのリソースはすぐに削除されます(XNUMX日間最近削除されたフォルダーに移動される他のリソースとは異なります)。