Prometheus .Net Core-Clientbibliothek

Die Prometheus.Net Core Client-Bibliothek ist eine.NET Core-Metriken-Bibliothek. Die Versionen 4.0, 5.0 und 6.0 werden von Instana unterstützt.

Instana erkennt automatisch die Prometheus .Net Core Clientbibliothek und die Metriken werden auf dem .NET Core-Prozessdashboard angezeigt.

Alle Konfigurationsoptionen sind optional. Instana überwacht in der Standardkonfiguration keine Metriken der Prometheus .NET Core-Clientbibliothek, sie sollte manuell aktiviert werden.

Sie können jedoch die Standardeinstellungen überschreiben, indem Sie einen prometheusMetricCollection-Abschnitt unter com.instana.plugin.netcore in der configuration.yaml-Datei Ihres Agenten hinzufügen, wie im folgenden Beispiel dargestellt:

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

Die folgenden Konfigurationsoptionen werden unterstützt:

• enabled: Setzen Sie diese Option auf false, um die Überwachung der Prometheus .Net Core-Clientbibliothek zu inaktivieren. Standardwert: false.

• limit: Um eine Überlastung des Überwachungs-Back-End-Programms zu vermeiden, wird die Anzahl der Metriken pro .Net Core-Prozess begrenzt. Sie können diese Konfigurationsoption verwenden, um den Grenzwert zu ändern. Standard: 200.

• pollIntervalSeconds: Im Allgemeinen bietet Instana 1 Sekunde für die Auflösung für Messdaten. Um eine mögliche Überlastung der benutzerdefinierten Callbacks zu vermeiden, haben wir das Sendeaufrufintervall für Metriken aus der Prometheus .Net Core-Clientbibliothek standardmäßig auf 15 Sekunden erhöht. Verwenden Sie diese Konfigurationsoption, um das Abfrageintervall zu erhöhen oder zu verringern. Voreinstellung: 15.

• excludeMetricNamesStartingWith: Liste der Präfixe für Messdatennamen, die nicht überwacht werden sollen. Zum Beispiel würde die oben genannte Konfiguration alle Metriken, die mit dotnet beginnen, und alle Metriken, die mit process beginnen, ausschließen, sodass Sie die folgenden Metriken nicht sehen könnten:

  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: Dies ist eine leistungsfähigere Alternative zu excludeMetricNamesStartingWith: Alle Messdaten, die mit einer der Liste von regulären Ausdrücken übereinstimmen, werden ausgeschlossen. Der reguläre Ausdruck wird auf die gesamte metrische Zeichenkette angewendet, einschließlich der Bezeichnungen, wie counter_total{region="eu-central-1"}, und nicht nur auf den Namen der Metrik. Der reguläre Ausdruck ist nicht verankert, d. h. er kann mit einer beliebigen Stelle in der Mitte der Zeichenfolge übereinstimmen. Beispiel: Wenn Sie eu-central-1 in der Liste excludeMetricsMatching angeben, wird der Messwert counter_total{region="eu-central-1"} ausgeschlossen.

• includeMetricsMatching: Gegenstück zu excludeMetricsMatching. Es werden nur Messdaten eingeschlossen, die mit einem der regulären Ausdrücke in der Liste übereinstimmen. Alle anderen Messdaten werden ausgeschlossen.