Konfigurationsoptionen des Collectors

Der Collector kann beim Start über Umgebungsvariablen oder eine Konfigurationsdatei konfiguriert werden. Die folgende Liste enthält alle Konfigurationsoptionen mit dem Namen der Umgebungsvariable und dem Namen des Schlüssels in der Konfigurationsdatei. Weitere Informationen zur Konfiguration des AppSignal Collectors mit einer Konfigurationsdatei oder Umgebungsvariablen finden Sie in unserem Konfigurationsabschnitt.

​

Verfügbare Optionen

• Erforderliche Optionen
  • push_api_key
• Optionen
  • cpu_count
  • enable_host_metrics
  • files_world_accessible
  • hostname
  • http_port
  • log_level
  • push_api_endpoint
  • running_in_container
  • working_directory_path

​

push_api_key

​

Beschreibung

Der Authentifizierungsschlüssel auf Organisationsebene zur Authentifizierung gegenüber unserer Push-API. Lesen Sie mehr über den AppSignal Push-API-Schlüssel.

​

cpu_count

​

Beschreibung

Die verfügbare CPU-Kapazität des Hosts, in Anzahl von CPUs. Dies wird verwendet, um den prozentualen CPU-Verbrauch in den Host-Metriken zu berechnen. Wenn nicht gesetzt, versucht der Agent, dies automatisch aus cgroups zu erkennen. Die Anzahl der CPUs kann ein Bruchteil sein, z. B. 0.5.

​

enable_host_metrics

​

Beschreibung

Setzen Sie diese Option auf false, um die Erfassung von Host-Metriken zu deaktivieren. Auf Heroku und Dokku sind Host-Metriken standardmäßig deaktiviert. Dies geschieht, da diese Systeme aus den Containern heraus ungenaue Metriken melden. Die Erfassung von Host-Metriken kann auf diesen Systemen nicht aktiviert werden. Verwenden Sie für Heroku stattdessen den Heroku Log Drain.

​

files_world_accessible

​

Beschreibung

Wenn dies auf true gesetzt ist, ist das erstellte AppSignal-Arbeitsverzeichnis für alle Benutzer zugänglich (Unix-Berechtigungen 0666). Dies ist häufig notwendig, da Prozesse für dieselbe Anwendung unter unterschiedlichen Benutzern laufen. Setzen Sie diesen Wert auf false, um dieses Verhalten zu deaktivieren (Unix-Berechtigungen 0644).

​

hostname

​

Beschreibung

Damit wird der Hostname des Servers überschrieben. Nützlich, wenn Sie keinen benutzerdefinierten Hostnamen festlegen können oder wenn Ihnen bei Hosting-Diensten eine nichtssagende ID generiert wird.

​

http_port

​

Beschreibung

Der Port, den der HTTP-Server des Collectors zum Empfangen von OpenTelemetry-Export-Anfragen verwendet.

​

log_level

​

Beschreibung

Legt den Schweregrad des internen Loggers von AppSignal fest. Wenn er auf “info” konfiguriert ist, werden alle Fehler-, Warn- und Info-Meldungen protokolliert, jedoch keine Debug-Meldungen. Die Stufen “debug” oder “trace” werden in der Regel nur auf Anfrage des Supports benötigt. Das Setzen der Stufe auf “debug”/“trace” kann insbesondere auf Seiten mit hohem Traffic einen geringen Einfluss auf die Festplattennutzung und IO haben. Der CPU-Overhead ist bei aktivierter Debug-Option minimal. Zulässige Werte:

• error
• warning
• info
• debug
• trace

​

push_api_endpoint

​

Beschreibung

Konfigurieren Sie den Endpunkt zum Senden von Daten an AppSignal. Diese Einstellung muss in der Regel nicht geändert werden.

​

running_in_container

​

Beschreibung

AppSignal erwartet, dass es zwischen verschiedenen Deployments auf demselben Rechner läuft. Setzen Sie diesen Schlüssel auf true, wenn die Anwendung in einem Container läuft, z. B. mit Docker. Neuere Versionen der AppSignal-Integration erkennen die Containerumgebung automatisch, sodass keine manuelle Konfiguration erforderlich ist. Wenn Sie Probleme mit der automatischen Erkennung haben, kontaktieren Sie bitte den Support. Diese Option wird auf Heroku automatisch auf true gesetzt.

​

working_directory_path

​

Beschreibung

Überschreiben Sie den Speicherort, an dem der AppSignal-Collector temporäre Dateien ablegen kann. Verwenden Sie diese Option, wenn der Standardort nicht geeignet ist. Weitere Informationen zum Zweck dieses Arbeitsverzeichnisses finden Sie auf unserer Seite Wie AppSignal arbeitet. Wenn Sie mehrere Anwendungen mit AppSignal auf demselben Server betreiben, verwenden Sie diese Konfigurationsoption, um für jede AppSignal-Instanz unterschiedliche Arbeitsverzeichnisse auszuwählen, da sich die beiden Instanzen sonst gegenseitig stören könnten. Weitere Informationen zu diesem Szenario finden Sie in unserer Dokumentation Mehrere Anwendungen auf einem Host betreiben.