Zum Hauptinhalt springen
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 Standalone Agents mit einer Konfigurationsdatei oder Umgebungsvariablen finden Sie in unserem Abschnitt Konfiguration.

​
Verfügbare Optionen

​
app_name

​
Beschreibung

Der Name Ihrer Anwendung, wie er auf AppSignal.com angezeigt werden soll.
Hinweis: Das Ändern des Namens oder der Umgebung einer bestehenden App erstellt eine neue App auf AppSignal.com.

​
environment

​
Beschreibung

Die Umgebung der App, die an AppSignal gemeldet werden soll.
Hinweis: Das Ändern des Namens oder der Umgebung einer bestehenden App erstellt eine neue App auf AppSignal.com.

​
push_api_key

​
Beschreibung

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

​
bind_address

​
Beschreibung

Eine gültige IPv4-Adresse, die der AppSignal-Agent als Bindung für seine TCP- und UDP-Server verwendet. Verwenden Sie eine bestimmte Adresse, wenn der Agent nur auf Anfragen lauschen soll, die an diese Adresse gerichtet sind. Setzen Sie diese Option auf 0.0.0.0, um Anfragen von Hosts mit beliebiger IP-Adresse zu empfangen. Standardmäßig lauscht er nur auf Anfragen, die auf demselben Host gemacht werden. Diese Option wird auf alle Agent-Server angewendet (StatsD, OpenTelemetry und NGINX).

​
ca_file_path

​
Beschreibung

  • Konfiguriert den Pfad der SSL-Zertifikatsdatei.
Verwenden Sie diese Option, um auf eine andere Zertifikatsdatei zu verweisen, falls es Probleme beim Verbinden mit unserer API gibt.
Hinweis: Der angegebene Pfad darf keine betriebssystemspezifischen Dateisystem-Abstraktionen enthalten, wie etwa das Homedir-Symbol ~ für *NIX-Systeme. Dies wird als fehlerhafter Pfad interpretiert.

​
cpu_count

​
Beschreibung

Die verfügbare CPU-Kapazität des Hosts, angegeben in Anzahl der CPUs. Dies wird verwendet, um den Prozentsatz der CPU-Auslastung 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.

​
dns_servers

​
Beschreibung

Konfigurieren Sie DNS-Server, die vom AppSignal-Agenten verwendet werden sollen.
YAML
Wenn Sie von unseren DNS-Timeouts betroffen sind, versuchen Sie, mit dieser Option manuell einen DNS-Server festzulegen, der nicht mehr als 4 Punkte im Servernamen verwendet.
  • Akzeptable Werte: 8.8.8.8, my.custom.local.server.
  • Nicht akzeptable Werte: foo, my.awesome.custom.local.dns.server.
Wenn der DNS-Server nicht erreicht werden kann, greift der Agent auf die DNS-Konfiguration des Hosts zurück und gibt eine Meldung in der Datei appsignal.log aus: A problem occurred while setting DNS servers.

​
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 liegt daran, dass 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.

​
enable_http

​
Beschreibung

Setzen Sie diese Option auf true, um den OpenTelemetry-HTTP-Server zu aktivieren. Wenn aktiviert, lauscht der AppSignal-Agent auf einem an localhost gebundenen Server auf Port 8099. Wenn Sie mehrere mit AppSignal instrumentierte Anwendungen auf demselben Server ausführen, kann diese Konfigurationsoption nur in einer von ihnen aktiviert werden. Dies ist für Apps erforderlich, die den OpenTelemetry-HTTP-Exporter verwenden, um Daten an AppSignal zu melden.

​
enable_nginx_metrics

​
Beschreibung

Auf true setzen, um den NGINX-Metrik-Server zu aktivieren. Siehe die NGINX-Metrik-Dokumentation für Details. Wenn aktiviert, lauscht der AppSignal-Agent auf einem an localhost gebundenen Server auf Port 27649. Wenn Sie mehrere mit AppSignal instrumentierte Anwendungen auf demselben Server ausführen, kann diese Konfigurationsoption nur in einer von ihnen aktiviert werden.

​
enable_opentelemetry_http

​
Beschreibung

Setzen Sie diese Option auf true, um den OpenTelemetry-HTTP-Server zu aktivieren. Wenn aktiviert, lauscht der AppSignal-Agent auf einem an localhost gebundenen Server auf Port 8099. Wenn Sie mehrere mit AppSignal instrumentierte Anwendungen auf demselben Server ausführen, kann diese Konfigurationsoption nur in einer von ihnen aktiviert werden. Dies ist für Apps erforderlich, die den OpenTelemetry-HTTP-Exporter verwenden, um Daten an AppSignal zu melden.

​
enable_statsd

​
Beschreibung

Aktiviert den StatsD-Server im AppSignal-Agenten. Wenn aktiviert, lauscht der AppSignal-Agent auf einem an localhost gebundenen Server auf Port 8125. Wenn Sie mehrere mit AppSignal instrumentierte Anwendungen auf demselben Server ausführen, kann diese Konfigurationsoption nur in einer von ihnen aktiviert werden.

​
filter_parameters

​
Beschreibung

Liste von Parameter-Schlüsseln, die mit der AppSignal-Filterung ignoriert werden sollen. Ihre Werte werden beim Senden an AppSignal durch [FILTERED] ersetzt.
TOML
Lesen Sie mehr über Parameter-Filterung.

​
filter_session_data

​
Beschreibung

Liste von Session-Daten-Schlüsseln, die mit der AppSignal-Filterung ignoriert werden sollen. Ihre Werte werden beim Senden an AppSignal durch [FILTERED] ersetzt.
TOML
Lesen Sie mehr über Session-Daten-Filterung.

​
host_role

​
Beschreibung

Gruppieren Sie Hosts nach Rolle und generieren Sie Metriken auf Basis dieser Rolle. Eine solche Metrik ist die Zählermetrik reporting_hosts. Eine gute Rolle gibt an, welche Hauptfunktion der Server hat, wie etwa “webserver”, “processor”, “api”, “database”, “loadbalancer” usw.

​
hostname

​
Beschreibung

Dies überschreibt den Hostnamen des Servers. Nützlich, wenn Sie keinen benutzerdefinierten Hostnamen festlegen können oder wenn auf Hosting-Diensten eine nichtssagende ID für Sie generiert wird.

​
http_proxy

​
Beschreibung

Wenn der Agent über einen Proxy mit dem Internet verbunden werden muss, geben Sie die vollständige Proxy-URL in diesem Konfigurationsschlüssel an.

​
ignore_actions

​
Beschreibung

Mit dieser Konfigurationsoption können Sie eine Liste von Aktionen angeben, die von AppSignal ignoriert werden. Alles, was passiert, einschließlich Exceptions, wird nicht an AppSignal übertragen. Dies kann nützlich sein, um Health-Check-Endpoints oder andere Aktionen zu ignorieren, die Sie nicht überwachen möchten. Lesen Sie mehr über das Ignorieren von Aktionen.

​
ignore_errors

​
Beschreibung

Liste von Fehlerklassen, die ignoriert werden. Alle mit dieser Fehlerklasse ausgelösten Exceptions werden nicht an AppSignal übertragen. Lesen Sie mehr über das Ignorieren von Fehlern.

​
ignore_namespaces

​
Beschreibung

Liste von Namespaces, die ignoriert werden. Jeder Fehler oder jeder langsame Request, der in diesem Namespace auftritt, wird nicht an AppSignal gesendet. Lesen Sie mehr über Namespaces.

​
log_level

​
Beschreibung

Diese Option legt den Schweregrad des internen Loggers von AppSignal fest und hat keinen Einfluss auf die Logging-Funktion.
Legt den Schweregrad des internen Loggers von AppSignal fest. Wenn er auf “info” konfiguriert ist, werden alle Error-, Warning- und Info-Meldungen protokolliert, aber keine Debug-Meldungen. Das Setzen auf die Stufen “debug” oder “trace” ist normalerweise nur auf Anfrage des Supports erforderlich. Das Setzen der Stufe auf “debug”/“trace” könnte leichte Auswirkungen auf die Festplattennutzung und I/O haben, insbesondere bei stark frequentierten Sites. Der CPU-Overhead ist mit aktivierter Debug-Option minimal. Akzeptierte Werte:
  • error
  • warning
  • info
  • debug
  • trace

​
nginx_port

​
Beschreibung

Konfigurieren Sie den Port, auf dem der NGINX-Metrik-Server bereitgestellt wird. Wenn AppSignal NGINX-Metriken empfängt, lauscht es auf einem an localhost gebundenen Server, standardmäßig auf Port 27649. Wenn Sie mehrere mit AppSignal instrumentierte Anwendungen mit aktivierten NGINX-Metriken auf demselben Server ausführen, verwenden Sie diese Option, um jede Anwendung so zu konfigurieren, dass sie auf einem anderen Port lauscht.

​
opentelemetry_port

​
Beschreibung

Setzen Sie diese Option, um den OpenTelemetry-HTTP-Server-Port des AppSignal-Agent-Prozesses zu konfigurieren. Konfigurieren Sie diesen Port, wenn auf der Maschine bereits ein anderer Prozess läuft, der ebenfalls diesen Port verwendet, um Konflikte zu vermeiden.

​
push_api_endpoint

​
Beschreibung

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

​
running_in_container

​
Beschreibung

AppSignal erwartet, dass es zwischen verschiedenen Deployments auf derselben Maschine läuft. Setzen Sie diesen Schlüssel auf true, wenn die Anwendung in einem Container ausgeführt wird, beispielsweise mit Docker. Neuere Versionen der AppSignal-Integration erkennen ihre Container-Umgebung 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.

​
send_environment_metadata

​
Beschreibung

Sendet Umgebungsmetadaten über die Anwendung. Weitere Informationen finden Sie unter Umgebungsmetadaten.

​
send_params

​
Beschreibung

Legt fest, ob das Senden von Request-Parametern an AppSignal übersprungen werden soll. Weitere Informationen finden Sie unter send_params im Abschnitt zur Filterung von Request-Parametern.

​
send_session_data

​
Beschreibung

Setzen Sie diese Option auf false, um keine Session-Daten mit Exception-Traces und Performance-Issue-Samples zu senden. Weitere Informationen finden Sie unter Filterung von Request-Session-Daten.

​
statsd_port

​
Beschreibung

Setzen Sie diese Option, um den StatsD-HTTP-Server-Port des AppSignal-Agent-Prozesses zu konfigurieren. Konfigurieren Sie diesen Port, wenn auf der Maschine bereits ein anderer Prozess läuft, der ebenfalls diesen Port verwendet, um Konflikte zu vermeiden.

​
working_dir_path

​
Beschreibung

Überschreibt den Ort, an dem der Standalone-AppSignal-Agent temporäre Dateien speichern kann. Verwenden Sie diese Option, wenn der Standardort nicht geeignet ist. Weitere Informationen zum Zweck dieses Arbeitsverzeichnisses finden Sie auf unserer Seite Wie AppSignal funktioniert.
Hinweis: Der angegebene Pfad darf keine betriebssystemspezifischen Dateisystem-Abstraktionen enthalten, wie etwa das Homedir-Symbol ~ für *NIX-Systeme. Dies wird als fehlerhafter Pfad interpretiert.