サポートセンターホーム


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

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

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

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

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

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リソース
system.display
namesystem.deviceid
system.hostname 
system.collectorid
system.sysoid
System.ips
auto.network.mac_address
system.display
namesystem.deviceid
system.aws.resourceid
system.aws.arn
system.displayname
system.deviceid
system.gcp.resourceid
system.gcp.resourcename
system.gcp.projectId
system.cloud.category
system.gcp.resourceid
system.displayname
system.deviceid
system.azure.resourceid
system.azure.resourcename

既存のリソースが返されず、リクエストでcreate queryパラメーターがTRUEに設定されている場合(デフォルト設定はFALSE)、指定されたリソースIDが設定された新しいリソースが作成されます。

Push Metrics REST APIには、リソースのプロパティの更新専用のエンドポイントがあります。 詳細については、を参照してください。 Push Metrics RESTAPIを使用したリソースプロパティの更新。

リソースの削除

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

削除されたリソースがPushMetrics REST APIを使用して作成され、プッシュモデルのデータソースからのみデータを受信する場合、そのリソースはすぐに削除されます(XNUMX日間最近削除されたフォルダーに移動される他のリソースとは異なります)。

記事上で