Prometheus .Net Core クライアント・ライブラリー

Prometheus.NET Core クライアントライブラリは、.NET Core のメトリクスライブラリです。 バージョン 4.0、5.0、および 6.0 は、Instana でサポートされています。

Prometheus .Net Core クライアント・ライブラリーは Instana で自動的に検出され、メトリックは .NET Core プロセス・ダッシュボードに表示されます。

すべての構成オプションは任意指定です。 Instana のデフォルトの構成では Prometheus .NET Core クライアント・ライブラリーのメトリックがモニターされないため、手動でオンにする必要があります。

ただし、以下の例に示すように、エージェントの configuration.yaml ファイルで com.instana.plugin.netcore の下に prometheusMetricCollection セクションを追加することで、デフォルトを上書きできます。

com.instana.plugin.netcore:
  prometheusMetricCollection:
    enabled: true
    limit: 200
    pollIntervalSeconds: 15
    excludeMetricNamesStartingWith:
      - dotnet
      - process
    excludeMetricsMatching:
      - eu-central-1

以下の構成オプションがサポートされます。

• enabled: Prometheus .Net Core クライアント・ライブラリーのモニターを無効にするには、これを false に設定します。 デフォルト: false。

• limit: モニター・バックエンドが過負荷にならないように、.Net Core プロセスごとのメトリックの数が制限されています。 この構成オプションを使用して、制限を変更できます。 デフォルト: 200。

• pollIntervalSeconds: 通常、Instana がメトリックの解決に提供するのは 1 秒です。 カスタム・コールバックが過負荷にならないように、Prometheus .Net Core クライアント・ライブラリーのメトリックのポーリング間隔はデフォルトで 15 秒に延長されています。 ポーリング間隔を増減するには、この構成オプションを使用してください。 デフォルト: 15。

• excludeMetricNamesStartingWith: モニター対象にしてはならないメトリック名接頭部のリスト。 例えば、上記の構成では dotnet で始まるすべてのメトリックと process で始まるすべてのメトリックが除外されるため、以下のメトリックは参照できません。

  process_cpu_seconds_total 0.99
  process_open_fds 23.0
  dotnet_total_memory_bytes 13.07M
  ```* `includeMetricNamesStartingWith`: Counterpart to `excludeMetricNamesStartingWith`. Only metrics starting with one of these prefixes will be included.
  

• excludeMetricsMatching: これは、excludeMetricNamesStartingWith に代わるさらに強力なメトリックです。正規表現のリストのいずれかに一致するすべてのメトリックが除外されます。 正規表現式は、メトリック名だけでなく、counter_total{region="eu-central-1"} などのラベルを含むフルメトリック・ストリングに適用されます。 正規表現は固定されません。つまり、ストリングの途中のどこにでも一致します。 例えば、excludeMetricsMatching リストで eu-central-1 を指定すると、メトリック counter_total{region="eu-central-1"} は除外されます。

• includeMetricsMatching: excludeMetricsMatching と対をなすものです。 リスト内のいずれかの正規表現に一致するメトリックのみが含まれ、他のメトリックはすべて除外されます。