プッシュメトリックを取り込むリソースの管理

デフォルトでは、Push Metrics REST APIは、LogicMonitorポータルの既存のリソースにメトリックをプッシュするように設計されています。 ただし、APIリクエストを使用して、プッシュメトリクスREST APIのデフォルト設定を上書きできます。これにより、クエリに一致する既存のリソースがない場合に新しいリソースが作成されます。 詳細については、を参照してください。 Push Metrics RESTAPIを使用したメトリックの取り込み.

Push Metrics REST APIによって作成されたリソースを含むすべてのリソースは、LogicMonitorプラットフォームに保存されます。 さらに、単一のリソースは、Push Metrics APIを介してプッシュメトリックを取り込むことも、プルベースの収集メソッドを使用するDataSourcesを介してメトリックを受け取ることもできます。

プッシュメトリックを取り込むリソースは、[リソース]ページに他のリソースと一緒に表示されます。

system.groupsプロパティを使用して、リソースを作成し、リソースグループに追加できます。
Note：リソースグループは既存のリソースグループである必要があり、リソースグループの管理権限が必要です。

Push Metrics APIを介してデータを受信するリソースのハートビートが、システムに送信されます。 システムが定期的にハートビートを受信しない場合、リソースはデッドとして表示されます。

リソース設計

Push Metrics REST APIを介してデータを受信するリソースは、LogicMonitorポータルの他のリソースと同様です。 リソースを、リソースグループにグループ化された複数のデータソースに関連付けることができます。 さらに、リソースはアラートルールで参照できます。

ただし、リソースには、プッシュモデルデータの取り込みをサポートできるようにするいくつかの固有の属性があります。 これらの固有の属性と制限については、次のセクションで説明します。

一意の属性：system.pushmodulesプロパティ

Push Metrics REST API呼び出しで参照されるリソースには、system.pushmodulesという名前のプロパティが割り当てられます。 system.categoriesプロパティと同様に、system.pushmodulesプロパティは、対応するプッシュメトリックデータソースに関連付ける値で自動的に更新されます。 

たとえば、API呼び出しがプッシュメトリクスREST APIに、データソースBを使用してリソースAのメトリクスを取り込むように指示した場合：

• データソースBに関連付けられた一意のタグが、リソースAのsystem.pushmodulesプロパティに値として追加されます。
• DataSource B用に作成されたAppliesToステートメントは、system.pushmodulesプロパティの値としてタグを保持するリソースにのみ関連付けられます。 DataSourceデザインの詳細については、を参照してください。 Push MetricsAPIによって作成されたデータソースの管理 このガイドのセクション。

ここに示されているPushDS1csternデータソースは、system.pushmodulesプロパティがその名前を参照しているリソースにのみ関連付けられます。

制限事項

プッシュメトリクスRESTAPIによって作成され、プッシュモデルのデータソースからのみデータを受信するリソースには特定の制限があります。
プッシュ（プル）通信モデルのコンテキストでの制限は次のとおりです。

• リソースに対してActiveDiscoveryを手動で実行する
• リモートセッションを介してリソースにアクセスする
• インスタンスを手動でポーリングして、現在のデータポイント値を確認します（[生データ]タブから開始）。
• インスタンスのデバッグデータ収集（[生データ]タブから開始）

リソースマッチング

メトリックの取り込みのリクエストがPushMetrics 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 queryパラメーターがTRUEに設定されている場合（デフォルト設定はFALSE）、指定されたリソースIDが設定された新しいリソースが作成されます。

リソースの削除

他のリソースと同様に、LogicMonitorインターフェイスを介してプッシュメトリックを受信するリソースを検出できます。 ただし、Push Metrics RESTAPIを使用してこれらのリソースを削除することはできません。 リソースが削除されると、そのリソースにプッシュされたデータはすべて無視されます。