OpenMetricsモニタリング

最終更新日: 19 年 2022 月 XNUMX 日

LogicMonitorは、Telegrafなどのシステムからメトリックを収集できるモニタリングパッケージテンプレートを作成しました。このテンプレートは、オープンソースのメトリック公開形式であるOpenMetricsでメトリックを公開します。 以前はPrometheusとして知られていたOpenMetricsは、Cloud Native Computing Foundationに採用されており、多数のプロジェクトで使用されています。

OpenMetricsデータは、任意の数のリソースからの任意の数のメトリックを表すことができるため、LogicMonitorが提供するテンプレートをカスタマイズするだけでなく、OpenMetricsメトリックを公開しているリソースにカスタムプロパティを追加する必要があります。

互換性

LogicMonitorのOpenMetrics監視パッケージは、OpenMetrics形式でメトリックを公開するすべてのシステムと互換性があります。

セットアップ要件

LogicModulesをインポートする

LogicMonitorリポジトリから、適切なOpenMetricsLogicModuleをインポートします。 LogicMonitorは、OpenMetricsDataSourceテンプレートのXNUMXつのバージョンを提供します。

  • OpenMetricsテンプレート。 これはシングルインスタンスバージョンです。 データポイントが同じホスト上の複数のエンティティに適用されない場合(ホストのメモリ使用量など)、このデータソーステンプレートを使用します。
  • OpenMetricsテンプレートMultiInstance。 これはマルチインスタンスバージョンです。 データポイントが同じホスト上の複数のエンティティに適用される場合(マルチコアシステムでのコア使用率の監視など)、このデータソーステンプレートを使用します。

LogicModuleのクローンを作成してカスタマイズする

OpenMetrics LogicModuleがインポートされたら、クローンを作成して、よりわかりやすい名前に変更します。 LogicModuleのクローン作成の詳細については、を参照してください。 LogicModuleのクローン作成.

キャプチャしようとしているデータを反映するデータポイントを編集および/または作成します。 DataSourceテンプレートで提供されるサンプルデータポイントを処理するこのプロセスは、主に、収集されるメトリックのキーを反映するようにデータポイントのクローンを作成し、名前を変更し、更新することで構成されます。 データポイントの構成の詳細については、を参照してください。 データポイントの概要.

注: の推奨ロジック に適用されます フィールドはコメント化されています。 ほとんどの場合、このロジックをアクティブにして、データソースが openmetrics.host プロパティを構成し(次のセクションで説明します)、 false() 指定。 ただし、データソースの複数のクローンを作成し、各クローンを一意のホストに適用する必要がある場合は、のロジックをカスタマイズする必要があります。 に適用されます ユースケースに適した方法でフィールド。

モニタリングへのホストの追加

OpenMetricsホストが現在存在しない場合は、監視に追加します。 監視にリソースを追加する方法の詳細については、を参照してください。 デバイスの追加.

ホストにプロパティを設定する

LogicMonitor内のOpenMetricsホストで次のカスタムプロパティを設定します。 プロパティの設定の詳細については、を参照してください。 リソースとインスタンスのプロパティ.

プロパティ

必須またはオプション

openmetrics.host 必須 OpenMetrics形式でメトリックを公開しているホストの名前またはIP。 これは、プロパティを適用しているのと同じホストである可能性があります。
openmetrics.user 必須 OpenMetricsのエンドポイントURLでHTTP基本認証が必要な場合は、認証ユーザー名を入力します。
openmetrics.pass 必須 OpenMetricsのエンドポイントURLでHTTP基本認証が必要な場合は、認証パスワードを入力します。
openmetrics.path オプション ホストがOpenMetrics形式でメトリックを提供しているURLパス。 このプロパティは、パスがデフォルトの「/ metrics」パスと異なる場合にのみ必要です。
オープンメトリクス.ssl オプション OpenMetricsエンドポイントがHTTPS経由でメトリックを提供している場合は、このプロパティを次のように設定します。 TRUE.
openmetrics.port オプション OpenMetricsエンドポイントにアクセスするために接続するポート。 このプロパティは、ポートがデフォルトの9273ポートと異なる場合にのみ必要です。
openmetrics.hostlabel オプション デフォルトでは、データソースは出力で「ホスト」ラベルを検索し、このラベルが割り当てられたメトリックのみを解析します。これは、 システムのホスト名 プロパティ。 「host」以外のラベルを使用して出力でホストを識別する場合は、ここでそのラベルを割り当てます。
openmetrics.mapホスト名 オプション デフォルトでは、データソースは出力で「ホスト」ラベルを検索し、このラベルが割り当てられたメトリックのみを解析します。これは、 システムのホスト名 プロパティ。 「ホスト」以外のエンティティからメトリックを収集する場合は、このプロパティを次のように設定します。 間違った情報。 たとえば、Telegrafなどのメトリック収集システムは、多くの場合、複数のホストからメトリックを受信します。 このプロパティを使用すると、現在のホストに関連するメトリックのみに制限したり、無効にすることで、複数のインスタンス間でメトリックを集約したりできます。 インスタンス名の場合、 openmetrics.instance_keys プロパティは、何らかの方法でホストを識別し、メトリックホストソースを区別することができます。
openmetrics.instance_keys マルチインスタンスに必要 インスタンス名を識別するキー。 これは、マルチインスタンスバージョンのデータソースを使用する場合に必要です。 複数のキーを参照できます。 たとえば、「cpu、host」のプロパティ値を次のサンプル出力に適用すると、「cpu1telegraf」、「cpu2telegraf」、「cpu1sqlserver」などのインスタンス名が返されます。
cpu_usage_guest {"cpu-total",host="telegraf" } 25.3719
cpu_usage_guest {"cpu1",host="telegraf" } 23.1476
cpu_usage_guest {"cpu2",host="telegraf" } 27.4582
cpu_usage_guest {"cpu-total",host="sqlserver" } 40.5491
cpu_usage_guest {"cpu1",host="sqlserver" } 32.1539
cpu_usage_guest {"cpu2",host="sqlserver" } 45.9334
サンプル出力

パッケージ内のLogicModules

OpenMetrics用のLogicMonitorのパッケージは、次のLogicModuleで構成されています。

表示名

説明

OpenMetricsテンプレート データソース これはシングルインスタンスバージョンです。 データポイントが同じホスト上の複数のエンティティに適用されない場合(ホストのメモリ使用量など)、このデータソーステンプレートを使用します。
OpenMetricsテンプレートマルチインスタンス データソース これはマルチインスタンスバージョンです。 データポイントが同じホスト上の複数のエンティティに適用される場合(マルチコアシステムでのコア使用率の監視など)、このデータソーステンプレートを使用します。

このパッケージには、事前定義されたデータポイントのしきい値は含まれていません(つまり、収集されたデータに基づいてアラートはトリガーされません)。 これは、データソースがテンプレートとして提供され、高度にカスタマイズされるように設計されているためです。 収集されたデータのアラートを受信するには、で説明されているように、手動でしきい値を作成する必要があります。 データポイントの静的しきい値の調整.

記事上で