> ## Documentation Index > Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt > Use this file to discover all available pages before exploring further. # Konfigurationsoptionen des Ruby-Gems 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 von AppSignal mit einer Konfigurationsdatei oder System-Umgebungsvariablen finden Sie in unserem Thema [Konfiguration](/ruby/configuration). ## Verfügbare Optionen * Erforderliche Optionen * [`active`](#option-active) * [`APPSIGNAL_APP_ENV`](#option-appsignal_app_env) * [`name`](#option-name) * [`push_api_key`](#option-push_api_key) * Optionen * [`activejob_report_errors`](#option-activejob_report_errors) * [`bind_address`](#option-bind_address) * [`ca_file_path`](#option-ca_file_path) * [`cpu_count`](#option-cpu_count) * [`debug`](#option-debug) * [`default_tags`](#option-default_tags) * [`dns_servers`](#option-dns_servers) * [`enable_active_support_event_log_reporter`](#option-enable_active_support_event_log_reporter) * [`enable_allocation_tracking`](#option-enable_allocation_tracking) * [`enable_at_exit_hook`](#option-enable_at_exit_hook) * [`enable_at_exit_reporter`](#option-enable_at_exit_reporter) * [`enable_frontend_error_catching`](#option-enable_frontend_error_catching) * [`enable_gvl_global_timer`](#option-enable_gvl_global_timer) * [`enable_gvl_waiting_threads`](#option-enable_gvl_waiting_threads) * [`enable_host_metrics`](#option-enable_host_metrics) * [`enable_minutely_probes`](#option-enable_minutely_probes) * [`enable_nginx_metrics`](#option-enable_nginx_metrics) * [`enable_rails_error_reporter`](#option-enable_rails_error_reporter) * [`enable_rake_performance_instrumentation`](#option-enable_rake_performance_instrumentation) * [`enable_statsd`](#option-enable_statsd) * [`endpoint`](#option-endpoint) * [`files_world_accessible`](#option-files_world_accessible) * [`filter_metadata`](#option-filter_metadata) * [`filter_parameters`](#option-filter_parameters) * [`filter_session_data`](#option-filter_session_data) * [`host_role`](#option-host_role) * [`hostname`](#option-hostname) * [`http_proxy`](#option-http_proxy) * [`ignore_actions`](#option-ignore_actions) * [`ignore_errors`](#option-ignore_errors) * [`ignore_logs`](#option-ignore_logs) * [`ignore_namespaces`](#option-ignore_namespaces) * [`instrument_code_ownership`](#option-instrument_code_ownership) * [`instrument_http_rb`](#option-instrument_http_rb) * [`instrument_net_http`](#option-instrument_net_http) * [`instrument_ownership`](#option-instrument_ownership) * [`instrument_redis`](#option-instrument_redis) * [`instrument_sequel`](#option-instrument_sequel) * [`log`](#option-log) * [`log_level`](#option-log_level) * [`log_path`](#option-log_path) * [`nginx_port`](#option-nginx_port) * [`ownership_set_namespace`](#option-ownership_set_namespace) * [`request_headers`](#option-request_headers) * [`revision`](#option-revision) * [`running_in_container`](#option-running_in_container) * [`send_environment_metadata`](#option-send_environment_metadata) * [`send_params`](#option-send_params) * [`send_session_data`](#option-send_session_data) * [`sidekiq_report_errors`](#option-sidekiq_report_errors) * [`skip_session_data`](#option-skip_session_data) * [`statsd_port`](#option-statsd_port) * [`transaction_debug_mode`](#option-transaction_debug_mode) * [`working_dir_path`](#option-working_dir_path) * [`working_directory_path`](#option-working_directory_path) ## active | Feld | Wert | | ----------------------------- | ---------------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `active` | | System-Umgebungsschlüssel | `APPSIGNAL_ACTIVE` | | Erforderlich | ja | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` / vom System erkannt | | Verfügbar seit Version | `0.3.0` | | | | ### Beschreibung **Hinweis**: Wenn die Umgebungsvariable [`APPSIGNAL_PUSH_API_KEY`](#option-push_api_key) gesetzt ist, ist der Standardwert `true`. Dies kann überschrieben werden, indem die System-Umgebungsvariable `APPSIGNAL_ACTIVE` auf `false` gesetzt wird: `APPSIGNAL_ACTIVE=false`. Konfigurieren Sie, ob AppSignal für eine bestimmte Umgebung aktiv sein soll oder nicht. Am häufigsten verwendet in der [Dateikonfiguration](/ruby/configuration) pro Umgebung. ## APPSIGNAL\_APP\_ENV | Feld | Wert | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | System-Umgebungsschlüssel | `APPSIGNAL_APP_ENV` | | Erforderlich | ja | | Typ | `String` | | Standardwert | `""` / vom System erkannt | | Verfügbar seit Version | `0.11.8` | | | | ### Beschreibung Die Umgebung der App, die an AppSignal gemeldet werden soll. Diese Konfigurationsoption wird in Rails-Apps automatisch erkannt. Bei Rails-Apps wird die Variable `RAILS_ENV` zur Erkennung der Umgebung verwendet. Bei Apps, die andere Frameworks oder gar keines verwenden, wird die Umgebungsvariable `RACK_ENV` verwendet. Um diese automatische Erkennung zu überschreiben, setzen Sie die Umgebungsvariable `APPSIGNAL_APP_ENV`. ```sh Shell theme={null} export APPSIGNAL_APP_ENV=staging rackup ``` Diese Option wird verwendet, um die Konfiguration aus den [Konfigurationsdateien](/ruby/configuration) zu laden, in denen die AppSignal-Konfiguration gespeichert ist. Die Umgebungsvariablen-Option wird häufig auf Plattformen verwendet, auf denen Apps standardmäßig in der `production`-Umgebung laufen, wie z. B. Heroku. Diese Einstellung ermöglicht es, die Umgebung beispielsweise auf `staging` zu setzen. ```sh Shell theme={null} heroku config:set APPSIGNAL_APP_ENV=staging ``` Wenn die Umgebung über den [`Appsignal.configure`-Helfer](/ruby/configuration/load-order#configure-helper) gesetzt wird, überschreibt dies die Umgebungsvariable `APPSIGNAL_APP_ENV`. **Hinweis**: Wenn Sie den [Namen](#option-name) oder die Umgebung einer bestehenden App ändern, wird auf AppSignal.com eine neue App erstellt. **Hinweis**: Diese Konfigurationsoption hat keinen Entsprechung als Konfigurationsdatei-Schlüssel. Um die Umgebung bei der AppSignal-Initialisierung zu setzen, müssen Sie [die Konfiguration manuell initialisieren](/ruby/instrumentation/integrating-appsignal#configuration-file).

Benutzerdefinierte Umgebungen in der Konfigurationsdatei

In der Datei `config/appsignal.yml` ist kein Schlüssel `env` verfügbar. Wenn Sie den Umgebungsnamen für eine App dynamisch in der Konfigurationsdatei festlegen möchten, können Sie Ihre Konfigurationsdatei so anpassen, dass die Umgebung verwendet wird, um eine Umgebung zu erstellen. ```yaml YAML theme={null} # config/appsignal.yml <%= ENV["APPSIGNAL_APP_ENV"] %>: active: true ``` Wenn Sie eine andere Umgebungsvariable als `APPSIGNAL_APP_ENV` verwenden, stellen Sie sicher, dass der Wert mit einem der automatisch erkannten Umgebungsvariablennamen (`RAILS_ENV` und `RACK_ENV`) übereinstimmt oder mit dem an [`Appsignal.configure`](/ruby/configuration#ruby-configuration-file) übergebenen Wert. **Hinweis**: Wenn Sie den [Namen](#option-name) oder die Umgebung einer bestehenden App ändern, wird auf AppSignal.com eine neue App erstellt. ## name | Feld | Wert | | ------------------------------------ | --------------------------------- | | Schlüssel in der Konfigurationsdatei | `name` | | Systemumgebungsvariable | `APPSIGNAL_APP_NAME` | | Erforderlich | ja | | Typ | `String` | | Standardwert | nil (standardmäßig nicht gesetzt) | | Verfügbar seit Version | `1.0.0` | ### Beschreibung Name Ihrer Anwendung, wie er auf AppSignal.com angezeigt werden soll. Wenn Sie Ruby on Rails verwenden, erkennt das Gem den Namen automatisch und Sie können dies leer lassen. Für andere Frameworks ist das Setzen dieses Werts zwingend erforderlich. **Hinweis**: Das Ändern des Namens oder der [Umgebung](#option-env) einer bestehenden App erstellt eine neue App auf AppSignal.com. ## push\_api\_key | Feld | Wert | | ------------------------------------ | --------------------------------- | | Schlüssel in der Konfigurationsdatei | `push_api_key` | | Systemumgebungsvariable | `APPSIGNAL_PUSH_API_KEY` | | Erforderlich | ja | | Typ | `String` | | Standardwert | nil (standardmäßig nicht gesetzt) | | Verfügbar seit Version | `0.1.0` | ### Beschreibung Der Authentifizierungsschlüssel auf Organisationsebene zur Authentifizierung gegenüber unserer Push-API. Lesen Sie mehr über den [AppSignal Push-API-Schlüssel](/appsignal/terminology#push-api-key). **Hinweis**: Wenn die Systemumgebungsvariable [`APPSIGNAL_PUSH_API_KEY`](#option-push_api_key) gesetzt ist, wird die Option [`active`](#option-active) standardmäßig auf `true` statt auf `false` gesetzt. Das bedeutet, AppSignal wird für die geladene Umgebung als aktiv betrachtet, auch wenn `active` in der Konfigurationsdatei auf `false` gesetzt ist. Weitere Informationen finden Sie unter der Option [`active`](#option-active). ## activejob\_report\_errors | Feld | Wert | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `activejob_report_errors` | | System-Umgebungsschlüssel | `APPSIGNAL_ACTIVEJOB_REPORT_ERRORS` | | Erforderlich | nein | | Typ | `String` | | Standardwert | `all` | | Verfügbar seit Version | `3.6.1` | | | | ### Beschreibung Konfigurieren Sie das Melden von Fehlern, die in [Active Job](/ruby/integrations/active-job)-Jobs auftreten. Diese Option ermöglicht es, die Fehlermeldung für Active Job-Jobs zu deaktivieren, um eine benutzerdefinierte Fehlermeldung hinzuzufügen. Akzeptierte Werte: * `all`: Alle Fehler bei jeder Ausführung von Jobs melden, einschließlich Wiederholungen. * `discard`: Fehler melden, wenn der Job aufgrund des Fehlers verworfen wird. Verwenden Sie diese Option, um Fehler nur dann zu melden, wenn alle Job-Wiederholungen erschöpft sind. * `none`: Keine Fehler für Jobs melden, einschließlich Wiederholungen. **Hinweis**: Die Option `discard` funktioniert nur mit Active Job 7.1 und neuer. Auf niedrigeren Versionen wird `discard` als `all` gelesen. ## bind\_address | Feld | Wert | | ------------------------------------ | ------------------------ | | Schlüssel in der Konfigurationsdatei | `bind_address` | | Systemumgebungsvariable | `APPSIGNAL_BIND_ADDRESS` | | Erforderlich | nein | | Typ | `String` | | Standardwert | `127.0.0.1` | | Verfügbar seit Version | `3.4.8` | ### 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 Anfragen an diese Adresse abhören soll. Setzen Sie diese Option auf `0.0.0.0`, um Anfragen von Hosts unter jeder beliebigen IP-Adresse zuzulassen. Standardmäßig hört er nur auf Anfragen, die auf demselben Host gestellt werden. Diese Option wird auf alle Agent-Server angewendet ([StatsD](#option-enable_statsd), [OpenTelemetry](#option-enable_opentelemetry_http) und [NGINX](#option-enable_nginx_metrics)). ## ca\_file\_path | Feld | Wert | | ------------------------------------ | ------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `ca_file_path` | | Systemumgebungsvariable | `APPSIGNAL_CA_FILE_PATH` | | Erforderlich | nein | | Typ | `String` | | Standardwert | Mitgelieferter Pfad zur `cacert.pem`-Datei. | | Verfügbar seit Version | `1.3.5` | ### Beschreibung Konfigurieren Sie den Pfad der SSL-Zertifikatsdatei. Standardmäßig zeigt dies auf die von AppSignal [mitgelieferte `cacert.pem`-Datei](https://github.com/appsignal/appsignal-ruby/blob/4eed259e122d10df66655098ad0aa8a362f3297d/resources/cacert.pem) im Gem selbst. Verwenden Sie diese Option, um auf eine andere Zertifikatsdatei zu verweisen, falls es Probleme bei der Verbindung mit unserer API gibt. **Hinweis**: Der angegebene Pfad darf keine betriebssystemspezifischen Dateisystem-Abstraktionen enthalten, wie zum Beispiel das Homedir-Symbol `~` auf \*NIX-Systemen. Dies wird als fehlerhafter Pfad gewertet. ## cpu\_count | Feld | Wert | | ------------------------------------ | --------------------- | | Schlüssel in der Konfigurationsdatei | `cpu_count` | | Systemumgebungsvariable | `APPSIGNAL_CPU_COUNT` | | Erforderlich | nein | | Typ | `Float` | | Standardwert | `undefined` | | Verfügbar seit Version | `3.6.3` | ### Beschreibung Die verfügbare CPU-Kapazität des Hosts, ausgedrückt als Anzahl der CPUs. Dies wird verwendet, um den CPU-Auslastungsprozentsatz in den Host-Metriken zu berechnen. Wenn nicht gesetzt, versucht der Agent, dies automatisch aus cgroups zu erkennen. Die Anzahl der CPUs kann ein Bruchwert sein, z. B. `0.5`. ## debug | Feld | Wert | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `debug` | | Systemumgebungsvariable | `APPSIGNAL_DEBUG` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` | | Verfügbar seit Version | `1.0.0` | | | | ### Beschreibung **Warnung**: Diese Konfigurationsoption ist im Ruby-Gem 3.0.16 veraltet. Bitte verwenden Sie stattdessen die Option [`log_level`](#option-log_level) für das Ruby-Gem 3.0.16 und neuer. Aktiviert das Debug-Logging. Dies wird in der Regel nur auf Anfrage des Supports benötigt. Mit dieser aktivierten Option protokolliert AppSignal deutlich mehr Informationen über Entscheidungen, die während der Metrikerfassung getroffen werden, sowie über das Senden von Daten an die AppSignal.com-Server. Das Aktivieren des Debug-Loggings kann sich leicht auf die Festplattennutzung und das IO auswirken, besonders auf stark frequentierten Seiten. Der CPU-Overhead ist mit aktivierter Debug-Option minimal. Diese Option legt die Schweregradstufe des internen Loggers von AppSignal fest. Diese Konfigurationsoption hat keinen Einfluss auf die [Logging-Funktion](/logging). ## default\_tags | Feld | Wert | | ------------------------------------ | -------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `default_tags` | | Systemumgebungsvariable | `APPSIGNAL_DEFAULT_TAGS` | | Erforderlich | nein | | Typ | `Hash[String, (String \| Symbol \| Integer \| Boolean)]` | | Standardwert | undefined | | Verfügbar seit Version | `4.8.3` | ### Beschreibung Standard-Tags, die allen Transaktionen hinzugefügt werden. Transaktionsspezifische Tags, die mit [`Appsignal.add_tags`](/guides/tagging#ruby) gesetzt werden, überschreiben Standard-Tags mit demselben Schlüssel. ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| config.default_tags = { "region" => "europe", "shard" => "shard-1" } end ``` ```yaml title="config/appsignal.yml" theme={null} default: &defaults default_tags: region: europe shard: shard-1 ``` Wenn Sie die Umgebungsvariable verwenden, geben Sie eine durch Kommas getrennte Liste von Schlüssel-Wert-Paaren an. ```bash Shell theme={null} export APPSIGNAL_DEFAULT_TAGS="region=europe,shard=shard-1" ``` Tag-Werte müssen ein String, Symbol, Integer oder Boolean sein. Tags mit anderen Werttypen werden ignoriert. Lesen Sie mehr über [Tagging](/guides/tagging). ## dns\_servers | Feld | Wert | | ------------------------------------ | ------------------------------------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `dns_servers` | | Systemumgebungsvariable | `APPSIGNAL_DNS_SERVERS` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `2.2.0.beta.1` | | | | ### Beschreibung Konfigurieren Sie DNS-Server, die der AppSignal-Agent verwenden soll. ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| config.dns_servers = ["8.8.8.8", "8.8.4.4"] end ``` ```yaml title="config/appsignal.yml" theme={null} default: &defaults dns_servers: - 8.8.8.8 - 8.8.4.4 ``` ```sh title="Environment variables" theme={null} # In der Host-Umgebung export APPSIGNAL_DNS_SERVERS="8.8.8.8,8.8.4.4" ``` Falls Sie von unseren [DNS-Timeouts](/support/known-issues#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 erreichbar ist, 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\_active\_support\_event\_log\_reporter | Feld | Wert | | ------------------------------------ | ---------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_active_support_event_log_reporter` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_ACTIVE_SUPPORT_EVENT_LOG_REPORTER` | | Erforderlich | nein | | Typ | `Boolean` | | Standardwert | `true` | | Verfügbar seit Version | `4.8.0` | ### Beschreibung Aktiviert die Integration für [strukturiertes Event-Reporting](https://edgeapi.rubyonrails.org/classes/ActiveSupport/EventReporter.html) von `ActiveSupport::EventReporter`. Wenn aktiviert, abonniert die AppSignal-Integration die von `ActiveSupport::EventReporter` ausgegebenen Events und meldet sie als Logs. ## enable\_allocation\_tracking | Feld | Wert | | ------------------------------------ | -------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_allocation_tracking` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_ALLOCATION_TRACKING` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `1.0.0` | ### Beschreibung Setzen Sie diese Option auf `false`, um die Verfolgung der Anzahl der allokierten Objekte in Ruby zu deaktivieren. ## enable\_at\_exit\_hook | Feld | Wert | | ------------------------------------ | ------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_at_exit_hook` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_AT_EXIT_HOOK` | | Erforderlich | nein | | Typ | `String` | | Standardwert | 'on\_error' / 'always' auf Containern | | Verfügbar seit Version | `4.5.8` | ### Beschreibung Konfigurieren Sie, wie AppSignal heruntergefahren wird, wenn die Anwendung beendet wird. Dies bestimmt, ob `Appsignal.stop` automatisch aufgerufen wird, wodurch die Daten an die Extension und den Agent geflusht werden. Diese Option hat drei mögliche Werte: * `always`: Ruft `Appsignal.stop` immer auf, wenn das Programm beendet wird. Auf (Docker-)Containern wird dieser Wert automatisch gesetzt. * `never`: Ruft `Appsignal.stop` niemals auf, wenn das Programm beendet wird. Der Standardwert, wenn das Programm nicht in einem (Docker-)Container ausgeführt wird. * `on_error`: Ruft `Appsignal.stop` auf, wenn das Programm mit einem Fehler beendet wird. Weitere Informationen finden Sie auf unserer Seite zur [Instrumentierung für Skripte und Hintergrund-Jobs](/ruby/instrumentation/background-jobs). ## enable\_at\_exit\_reporter | Feld | Wert | | ------------------------------------ | ----------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_at_exit_reporter` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_AT_EXIT_REPORTER` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `4.0.0` | ### Beschreibung Auf `true` setzen, um den letzten Fehler zu melden, der das Beenden des Prozesses verursacht hat. Der gemeldete Fehler ist in der Regel der Fehler, der den Prozess abstürzen lässt. Wenn das Ruby-Gem den Fehler bereits gemeldet hat, wird er nicht erneut gemeldet. Über diesen Mechanismus gemeldete Fehler werden dem Namespace „unhandled“ hinzugefügt. Fügen Sie diesen Code am Anfang der Anwendung in kurzlebigen Containern und serverlosen Funktionen ein, um sicherzustellen, dass der Fehler geflusht wird, bevor das System heruntergefahren wird. ```ruby Ruby theme={null} at_exit { sleep 5 } ``` ## enable\_frontend\_error\_catching | Feld | Wert | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_frontend_error_catching` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_FRONTEND_ERROR_CATCHING` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` | | Verfügbar seit Version | `1.0.0` | | | | ### Beschreibung Aktiviert das experimentelle Frontend-Fehlerabfangsystem. Dadurch wird Ihrer App eine Route unter `/appsignal_error_catcher` hinzugefügt, mit der JavaScript-Fehler abgefangen und an AppSignal gesendet werden können. Sie können diese Route mit [`frontend_error_catching_path`](#option-frontend_error_catching_path) konfigurieren. ## enable\_gvl\_global\_timer | Feld | Wert | | ------------------------------------ | ----------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_gvl_global_timer` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_GVL_GLOBAL_TIMER` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `3.3.9` | ### Beschreibung Setzen Sie diese Option auf `false`, um die [Instrumentierung des GVL Global Timers](/ruby/integrations/global-vm-lock#waiting-threads) zu deaktivieren. Diese Konfigurationsoption hat keine Auswirkung, wenn GVLTools nicht installiert ist. ## enable\_gvl\_waiting\_threads | Feld | Wert | | ------------------------------------ | -------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_gvl_waiting_threads` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_GVL_WAITING_THREADS` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `3.3.9` | ### Beschreibung Setzen Sie diese Option auf `false`, um die [Instrumentierung der wartenden GVL-Threads](/ruby/integrations/global-vm-lock#waiting-threads) zu deaktivieren. Diese Konfigurationsoption hat keine Auswirkung, wenn GVLTools nicht installiert ist. ## enable\_host\_metrics | Feld | Wert | | ------------------------------------ | ------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_host_metrics` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_HOST_METRICS` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | \`\`true` / vom System erkannt` | | Verfügbar seit Version | `1.2.0` | ### Beschreibung Setzen Sie diese Option auf `false`, um die Erfassung von [Host-Metriken](/metrics/host-metrics) zu deaktivieren. Auf Heroku und Dokku sind Host-Metriken standardmäßig deaktiviert. Dies geschieht, weil diese Systeme ungenaue Metriken aus den Containern heraus melden. Die Erfassung von Host-Metriken auf diesen Systemen kann nicht aktiviert werden. Verwenden Sie für Heroku stattdessen den [Heroku Log Drain](/heroku/host-metrics). ## enable\_minutely\_probes | Feld | Wert | | ------------------------------------ | ---------------------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_minutely_probes` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_MINUTELY_PROBES` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `1.3.0` | | | | ### Beschreibung Aktiviert das System der [minütlichen Probes](/ruby/instrumentation/minutely-probes). ## enable\_nginx\_metrics | Feld | Wert | | ------------------------------------ | -------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_nginx_metrics` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_NGINX_METRICS` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` | | Verfügbar seit Version | `3.3.4` | ### Beschreibung Auf `true` setzen, um den NGINX-Metrik-Server zu aktivieren. [Details finden Sie in der NGINX-Metrik-Dokumentation.](/metrics/nginx) Wenn aktiviert, hört 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 davon aktiviert werden. ## enable\_rails\_error\_reporter | Feld | Wert | | ------------------------------------ | --------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_rails_error_reporter` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_RAILS_ERROR_REPORTER` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `3.4.1` | ### Beschreibung Auf `false` setzen, um den Subscriber des Rails Error Reporters zu deaktivieren. [Details finden Sie in der Rails-Dokumentation.](/ruby/integrations/rails) ## enable\_rake\_performance\_instrumentation | Feld | Wert | | ------------------------------------ | --------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_rake_performance_instrumentation` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_RAKE_PERFORMANCE_INSTRUMENTATION` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` | | Verfügbar seit Version | `3.10.0` | ### Beschreibung Aktiviert die Performance-Instrumentierung für Rake-Tasks. Standardmäßig meldet die [Rake-Instrumentierung](/ruby/integrations/rake) nur Fehler. ## enable\_statsd | Feld | Wert | | ------------------------------------ | -------------------------- | | Schlüssel in der Konfigurationsdatei | `enable_statsd` | | Systemumgebungsvariable | `APPSIGNAL_ENABLE_STATSD` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `3.0.14` | ### Beschreibung Aktiviert den [StatsD-Server](/standalone-agent/statsd) im AppSignal-Agent. Wenn aktiviert, hört 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 davon aktiviert werden. ## endpoint | Feld | Wert | | ------------------------------------ | --------------------------------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `endpoint` | | Systemumgebungsvariable | `APPSIGNAL_PUSH_API_ENDPOINT` | | Erforderlich | nein | | Typ | `String` | | Standardwert | `https://push.appsignal.com` | | Verfügbar seit Version | `0.1.0` | | | | ### Beschreibung Konfigurieren Sie den Endpunkt, an den Daten an AppSignal gesendet werden. Diese Einstellung muss in der Regel nicht geändert werden. ## files\_world\_accessible | Feld | Wert | | ------------------------------------ | ---------------------------------- | | Schlüssel in der Konfigurationsdatei | `files_world_accessible` | | Systemumgebungsvariable | `APPSIGNAL_FILES_WORLD_ACCESSIBLE` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `2.3.6` | ### Beschreibung Wenn dies auf `true` gesetzt ist, ist das erstellte [AppSignal-Arbeitsverzeichnis](/appsignal/how-appsignal-operates#working-directory) für alle Benutzer zugänglich (Unix-Berechtigungen `0666`). Dies ist oft notwendig, da Prozesse derselben App unter unterschiedlichen Benutzern laufen. Auf `false` setzen, um dieses Verhalten zu deaktivieren (Unix-Berechtigungen `0644`). ## filter\_metadata | Feld | Wert | | ------------------------------------ | --------------------------- | | Schlüssel in der Konfigurationsdatei | `filter_metadata` | | Systemumgebungsvariable | `APPSIGNAL_FILTER_METADATA` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `3.4.5` | ### Beschreibung Das AppSignal Ruby-Gem speichert standardmäßig Metadaten über Anfragen und Hintergrund-Jobs in Samples, wie z. B. Anfragepfad, Anfragemethode, Anfrage-ID, Hintergrund-Queue, Job-ID und Wiederholungsanzahl des Jobs. Diese Metadatenwerte werden in der Tag-Box angezeigt. Wenn einer dieser Metadatenwerte PII oder andere sensible Daten enthält, verwenden Sie diese Konfigurationsoption, um Metadaten nach Schlüssel herauszufiltern. Setzen Sie die Option `filter_metadata` auf eine Liste von Metadaten-Schlüsseln, die herausgefiltert werden sollen. Sie können dies mit einer Liste von Schlüsseln in der Konfigurationsdatei konfigurieren. Wenn gefiltert, werden die Metadaten in der AppSignal-UI nicht sichtbar sein. ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| config.filter_metadata += ["path", "request_id"] end ``` ```yaml title="config/appsignal.yml" theme={null} default: &defaults filter_metadata: - path - request_id ``` ## filter\_parameters | Feld | Wert | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `filter_parameters` | | Systemumgebungsvariable | `APPSIGNAL_FILTER_PARAMETERS` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `1.3.0` | | | | ### Beschreibung Liste von Parameter-Schlüsseln, die mittels AppSignal-Filterung ignoriert werden sollen. Ihre Werte werden bei der Übertragung an AppSignal durch `[FILTERED]` ersetzt. Sie können dies mit einer Liste von Schlüsseln in der Konfigurationsdatei konfigurieren. ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| config.filter_parameters += ["password", "email", "api_token", "token"] end ``` ```yaml YAML theme={null} # config/appsignal.yml default: &defaults filter_parameters: - password - email - api_token - token ``` Lesen Sie mehr über [Parameter-Filterung](/application/parameter-filtering). ## filter\_session\_data | Feld | Wert | | ------------------------------------ | ---------------------------------------------------------------------------- | | Schlüssel in der Konfigurationsdatei | `filter_session_data` | | Systemumgebungsvariable | `APPSIGNAL_FILTER_SESSION_DATA` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `2.6.0` | | | | ### Beschreibung Liste von Sessiondaten-Schlüsseln, die mittels AppSignal-Filterung ignoriert werden sollen. Ihre Werte werden bei der Übertragung an AppSignal durch `[FILTERED]` ersetzt. Sie können dies mit einer Liste von Schlüsseln in der Konfigurationsdatei konfigurieren. ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| config.filter_session_data += ["name", "email", "api_token", "token"] end ``` ```yaml YAML theme={null} # config/appsignal.yml default: &defaults filter_session_data: - name - email - api_token - token ``` Lesen Sie mehr über [Sessiondaten-Filterung](/application/session-data-filtering). ## host\_role | Feld | Wert | | ------------------------------------ | --------------------------------- | | Schlüssel in der Konfigurationsdatei | `host_role` | | Systemumgebungsvariable | `APPSIGNAL_HOST_ROLE` | | Erforderlich | nein | | Typ | `String` | | Standardwert | nil (standardmäßig nicht gesetzt) | | Verfügbar seit Version | `3.4.11` | ### Beschreibung Gruppieren Sie Hosts nach Rolle und generieren Sie auf Basis dieser Rolle Metriken. Eine solche Metrik ist die Counter-Metrik `reporting_hosts`. Eine gute Rolle gibt an, was die Hauptrolle des Servers ist, wie zum Beispiel „webserver“, „processor“, „api“, „database“, „loadbalancer“ usw. ## hostname | Feld | Wert | | ------------------------------------ | -------------------- | | Schlüssel in der Konfigurationsdatei | `hostname` | | Systemumgebungsvariable | `APPSIGNAL_HOSTNAME` | | Erforderlich | nein | | Typ | `String` | | Standardwert | vom System erkannt | | Verfügbar seit Version | `1.3.6` | ### 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 | Feld | Wert | | ------------------------------------ | --------------------------------- | | Schlüssel in der Konfigurationsdatei | `http_proxy` | | Systemumgebungsvariable | `APPSIGNAL_HTTP_PROXY` | | Erforderlich | nein | | Typ | `String` | | Standardwert | nil (standardmäßig nicht gesetzt) | | Verfügbar seit Version | `0.11.13` | ### Beschreibung Wenn der Agent die Verbindung zum Internet über einen Proxy herstellen muss, geben Sie in diesem Konfigurationsschlüssel die vollständige Proxy-URL an. ## ignore\_actions | Feld | Wert | | ------------------------------------ | -------------------------- | | Schlüssel in der Konfigurationsdatei | `ignore_actions` | | Systemumgebungsvariable | `APPSIGNAL_IGNORE_ACTIONS` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `0.10.0` | ### 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-Endpunkte oder andere Aktionen zu ignorieren, die Sie nicht überwachen möchten. Lesen Sie mehr über das [Ignorieren von Aktionen](/guides/filter-data/ignore-actions). ## ignore\_errors | Feld | Wert | | ------------------------------------ | ------------------------- | | Schlüssel in der Konfigurationsdatei | `ignore_errors` | | Systemumgebungsvariable | `APPSIGNAL_IGNORE_ERRORS` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `0.1.0` | ### Beschreibung Liste von Fehlerklassen, die ignoriert werden. Jede mit dieser Fehlerklasse ausgelöste Exception wird nicht an AppSignal übertragen. Lesen Sie mehr über das [Ignorieren von Fehlern](/guides/filter-data/ignore-errors). ## ignore\_logs | Feld | Wert | | ------------------------------------ | ----------------------- | | Schlüssel in der Konfigurationsdatei | `ignore_logs` | | Systemumgebungsvariable | `APPSIGNAL_IGNORE_LOGS` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `3.7.0` | ### Beschreibung Liste von Log-Nachrichten, die ignoriert werden. Jede Log-Nachricht, die eines der Elemente der Liste enthält, wird nicht an AppSignal übertragen. Eine kleine Teilmenge der Regex-Syntax wird unterstützt. Lesen Sie mehr dazu in unserem Leitfaden zum [Ignorieren von Logs](/guides/filter-data/ignore-logs). ## ignore\_namespaces | Feld | Wert | | ------------------------------------ | ----------------------------- | | Schlüssel in der Konfigurationsdatei | `ignore_namespaces` | | Systemumgebungsvariable | `APPSIGNAL_IGNORE_NAMESPACES` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `[]` | | Verfügbar seit Version | `2.3.0` | ### Beschreibung Liste von Namespaces, die ignoriert werden. Jeder ausgelöste Fehler oder jede langsame Anfrage, die in diesem Namespace auftritt, wird nicht an AppSignal gesendet. Lesen Sie mehr über [Namespaces](/application/namespaces). ## instrument\_code\_ownership | Feld | Wert | | ------------------------------------ | ------------------------------------- | | Schlüssel in der Konfigurationsdatei | `instrument_code_ownership` | | Systemumgebungsvariable | `APPSIGNAL_INSTRUMENT_CODE_OWNERSHIP` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `4.7.1` | ### Beschreibung Ob das [CodeOwnership-Gem](/ruby/integrations/code-ownership) automatisch instrumentiert werden soll, kann `true` oder `false` sein. ## instrument\_http\_rb | Feld | Wert | | ------------------------------------ | ------------------------------ | | Schlüssel in der Konfigurationsdatei | `instrument_http_rb` | | Systemumgebungsvariable | `APPSIGNAL_INSTRUMENT_HTTP_RB` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `3.2.0` | ### Beschreibung Aktiviert oder deaktiviert die Instrumentierung für das [http.rb Ruby-Gem](https://github.com/httprb/http). Standardmäßig aktiviert. ## instrument\_net\_http | Feld | Wert | | ------------------------------------ | ------------------------------- | | Schlüssel in der Konfigurationsdatei | `instrument_net_http` | | Systemumgebungsvariable | `APPSIGNAL_INSTRUMENT_NET_HTTP` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `0.9.0` | ### Beschreibung Ob Instrumentierung für `net/http`-Aufrufe hinzugefügt werden soll, kann `true` oder `false` sein. ## instrument\_ownership | Feld | Wert | | ------------------------------------ | -------------------------------- | | Schlüssel in der Konfigurationsdatei | `instrument_ownership` | | Systemumgebungsvariable | `APPSIGNAL_INSTRUMENT_OWNERSHIP` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `4.3.3` | ### Beschreibung Ob das [Ownership-Gem](/ruby/integrations/ownership) automatisch instrumentiert werden soll, kann `true` oder `false` sein. ## instrument\_redis | Feld | Wert | | ------------------------------------ | ---------------------------- | | Schlüssel in der Konfigurationsdatei | `instrument_redis` | | Systemumgebungsvariable | `APPSIGNAL_INSTRUMENT_REDIS` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `1.0.0` | ### Beschreibung Ob die Instrumentierung für Redis-Abfragen mit dem [Redis-Gem](https://rubygems.org/gems/redis) aktiviert werden soll, kann `true` oder `false` sein. ## instrument\_sequel | Feld | Wert | | ------------------------------------ | ----------------------------- | | Schlüssel in der Konfigurationsdatei | `instrument_sequel` | | Systemumgebungsvariable | `APPSIGNAL_INSTRUMENT_SEQUEL` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar seit Version | `1.0.0` | ### Beschreibung Ob Instrumentierung für `sequel`-Abfragen mithilfe der [Sequel-Gem-Integration](/ruby/integrations/sequel) hinzugefügt werden soll, kann `true` oder `false` sein. ## log | Feld | Wert | | ------------------------------------ | --------------- | | Schlüssel in der Konfigurationsdatei | `log` | | Systemumgebungsvariable | `APPSIGNAL_LOG` | | Erforderlich | nein | | Typ | `String` | | Standardwert | `file` | | Verfügbar seit Version | `2.0.0` | ### Beschreibung Diese Option konfiguriert, welchen Logger die interne Logging-Funktionalität von AppSignal verwendet, und beeinflusst die [Logging-Funktion](/logging) nicht. **Hinweis**: Der [AppSignal-Agent](/appsignal/how-appsignal-operates), der von der Integration verwendet wird, schreibt immer in die Datei „appsignal.log“. Wählen Sie aus, welchen Logger die AppSignal-Integration verwendet. Akzeptierte Werte sind `file` und `stdout`. Siehe auch die Konfiguration `log_path`. * `file` (Standard) * Schreibt alle AppSignal-Logs in das Dateisystem. * `stdout` (Standard auf [Heroku](https://heroku.com)) * Gibt AppSignal-Logs in STDOUT des Elternprozesses anstatt in eine Datei aus. Nützlich bei Hosting-Lösungen wie Container-Systemen und Heroku. ## log\_level | Feld | Wert | | ------------------------------------ | --------------------- | | Schlüssel in der Konfigurationsdatei | `log_level` | | Systemumgebungsvariable | `APPSIGNAL_LOG_LEVEL` | | Erforderlich | nein | | Typ | `String` | | Standardwert | `info` | | Verfügbar seit Version | `3.0.16` | ### Beschreibung Diese Option legt die Schweregradstufe des internen Loggers von AppSignal fest und beeinflusst die [Logging-Funktion](/logging) nicht. Legt die Schweregradstufe des internen Loggers von AppSignal fest. Wenn er auf „info“ konfiguriert ist, protokolliert er alle Error-, Warning- und Info-Nachrichten, aber nicht die Debug-Nachrichten. Das Setzen der Stufen „debug“ oder „trace“ wird in der Regel nur auf Anfrage des Supports benötigt. Das Setzen der Stufe auf „debug“/„trace“ kann sich leicht auf die Festplattennutzung und das IO auswirken, besonders auf stark frequentierten Seiten. Der CPU-Overhead ist mit aktivierter Debug-Option minimal. Akzeptierte Werte: * error * warning * info * debug * trace ## log\_path | Feld | Wert | | ------------------------------------ | -------------------- | | Schlüssel in der Konfigurationsdatei | `log_path` | | Systemumgebungsvariable | `APPSIGNAL_LOG_PATH` | | Erforderlich | nein | | Typ | `String` | | Standardwert | `./log` | | Verfügbar seit Version | `1.0.0` | ### Beschreibung Diese Option konfiguriert den Speicherort der internen Logging-Datei von AppSignal und beeinflusst die [Logging-Funktion](/logging) nicht.
**Hinweis**: Der angegebene Pfad darf keine betriebssystemspezifischen Dateisystem-Abstraktionen enthalten, wie zum Beispiel das Homedir-Symbol `~` auf \*NIX-Systemen. Dies wird als fehlerhafter Pfad gewertet. Überschreibt den Speicherort des Pfades (Verzeichnisses), in das die Datei `appsignal.log` geschrieben werden kann. ## nginx\_port | Feld | Wert | | ------------------------------------ | ---------------------- | | Schlüssel in der Konfigurationsdatei | `nginx_port` | | Systemumgebungsvariable | `APPSIGNAL_NGINX_PORT` | | Erforderlich | nein | | Typ | `Integer` | | Standardwert | `27649` | | Verfügbar seit Version | `4.5.15` | ### Beschreibung Konfigurieren Sie den Port, auf dem der NGINX-Metrik-Server bereitgestellt wird. Wenn AppSignal NGINX-Metriken empfängt, hört es auf einem an `localhost` gebundenen Server, standardmäßig auf Port 27649. Wenn Sie mehrere mit AppSignal instrumentierte Anwendungen auf demselben Server mit aktivierten NGINX-Metriken ausführen, verwenden Sie diese Option, um jede Anwendung so zu konfigurieren, dass sie auf einem anderen Port hört. ## ownership\_set\_namespace | Feld | Wert | | ------------------------------------ | ----------------------------------- | | Schlüssel in der Konfigurationsdatei | `ownership_set_namespace` | | Systemumgebungsvariable | `APPSIGNAL_OWNERSHIP_SET_NAMESPACE` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` | | Verfügbar seit Version | `4.3.3` | ### Beschreibung Ob die [Ownership-Gem-Instrumentierung](/ruby/integrations/ownership) den Namespace eines Samples auf seinen Owner setzen soll, kann `true` oder `false` sein. ## request\_headers | Feld | Wert | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `request_headers` | | Systemumgebungs-Schlüssel | `APPSIGNAL_REQUEST_HEADERS` | | Erforderlich | nein | | Typ | `Array` | | Standardwert | `["HTTP_ACCEPT", "HTTP_ACCEPT_CHARSET", "HTTP_ACCEPT_ENCODING", "HTTP_ACCEPT_LANGUAGE", "HTTP_CACHE_CONTROL", "HTTP_CONNECTION", "CONTENT_LENGTH", "PATH_INFO", "HTTP_RANGE", "REQUEST_METHOD", "REQUEST_PATH", "SERVER_NAME", "SERVER_PORT", "SERVER_PROTOCOL"]` | | Verfügbar ab Version | `2.6.0` | | | | ### Beschreibung Die Konfigurationsoption `request_headers` enthält eine Liste von HTTP-Request-Headern, die vom AppSignal-Ruby-Gem gelesen und gespeichert werden. Diese Konfigurationsoption `request_headers` ist eine *Allowlist*, was bedeutet, dass nur die in dieser Konfigurationsoption angegebenen Header berücksichtigt werden. Wenn diese Konfigurationsoption nicht gesetzt ist, wird der AppSignal-Standard verwendet. ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| # Add a request header config.request_headers << "PATH_INFO" # Remove a request header config.request_headers.delete("PATH_INFO") end ``` ```yaml title="config/appsignal.yml" theme={null} # To add an additional request header it's necessary to list all default headers too default: &defaults request_headers: - HTTP_ACCEPT - HTTP_ACCEPT_CHARSET - HTTP_ACCEPT_ENCODING - HTTP_ACCEPT_LANGUAGE - HTTP_CACHE_CONTROL - HTTP_CONNECTION - CONTENT_LENGTH - PATH_INFO - HTTP_RANGE - REQUEST_METHOD - REQUEST_PATH - SERVER_NAME - SERVER_PORT - SERVER_PROTOCOL ``` Beachten Sie, dass AppSignal die Header aus Ihrer Anwendung liest und diese möglicherweise nicht 1:1 mit dem übereinstimmen, was im Browser/Client gesendet wird. In [Rack-Anwendungen](https://rack.github.io/) ([Rails](/ruby/integrations/rails), [Sinatra](/ruby/integrations/sinatra) usw.) werden alle benutzerdefinierten Header mit der Zeichenkette `HTTP_` versehen, alle Headernamen werden großgeschrieben und Bindestriche (`-`) werden durch Unterstriche (`_`) ersetzt. Beispielsweise kann der Header `X-Hub-Signature` von Ihrer Anwendung und von AppSignal mit dem Namen `HTTP_X_HUB_SIGNATURE` aufgerufen werden. Um AppSignal so zu konfigurieren, dass keine HTTP-Request-Header in AppSignal-Transaktionen gespeichert werden, konfigurieren Sie die Option mit einem leeren Array. ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| config.request_headers = [] end ``` ```yaml title="config/appsignal.yml" theme={null} default: &defaults request_headers: [] ``` ## revision | Feld | Wert | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `revision` | | Systemumgebungs-Schlüssel | `APP_REVISION` | | Erforderlich | nein | | Typ | `String` | | Standardwert | nil (Standardmäßig nicht gesetzt) | | Verfügbar ab Version | `2.6.0` | | | | ### Beschreibung Legen Sie die App-Revision fest, um die aktuell laufende Version Ihrer Anwendung zu melden. AppSignal erstellt einen Deploy-Marker, wenn sich dieser Wert ändert, und versieht alle eingehenden Daten mit der aktuellen Revision. Wenn Ihre Anwendung mit Kamal bereitgestellt wird, auf Render bereitgestellt wird oder auf Heroku bereitgestellt wird und die Funktion [Heroku Labs: Dyno Metadata](https://devcenter.heroku.com/articles/dyno-metadata) aktiviert ist, erkennt die AppSignal-Integration automatisch den Git-Commit der aktuellen Bereitstellung und verwendet diesen als Revision. Sie können die automatisch erkannten Revisionen in Heroku, Render oder Kamal überschreiben, indem Sie die Konfigurationsoption `revision` manuell auf einen benutzerdefinierten Wert setzen. Weitere Informationen zu Deploy-Markern finden Sie im [Thema Deploy-Marker](/application/markers/deploy-markers). ## running\_in\_container | Feld | Wert | | ----------------------------- | -------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `running_in_container` | | Systemumgebungs-Schlüssel | `APPSIGNAL_RUNNING_IN_CONTAINER` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | vom Agent erkannt | | Verfügbar ab Version | `1.0.0` | | | | ### 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](mailto:support@appsignal.com). Diese Option wird auf [Heroku](http://heroku.com/) automatisch auf `true` gesetzt. ## send\_environment\_metadata | Feld | Wert | | ----------------------------- | ------------------------------------- | | Konfigurationsdatei-Schlüssel | `send_environment_metadata` | | Systemumgebungs-Schlüssel | `APPSIGNAL_SEND_ENVIRONMENT_METADATA` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar ab Version | `2.11.0` | ### Beschreibung Sendet Umgebungsmetadaten über die Anwendung. Weitere Informationen finden Sie unter [Umgebungsmetadaten](/application/environment-metadata). ## send\_params | Feld | Wert | | ----------------------------- | ----------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `send_params` | | Systemumgebungs-Schlüssel | `APPSIGNAL_SEND_PARAMS` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar ab Version | `0.9.0` | | | | ### Beschreibung Legt fest, ob das Senden von Request-Parametern an AppSignal übersprungen werden soll. Weitere Informationen finden Sie unter [send\_params](/application/parameter-filtering) im Abschnitt zur Filterung von Request-Parametern. ## send\_session\_data | Feld | Wert | | ----------------------------- | ----------------------------- | | Konfigurationsdatei-Schlüssel | `send_session_data` | | Systemumgebungs-Schlüssel | `APPSIGNAL_SEND_SESSION_DATA` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `true` | | Verfügbar ab Version | `3.0.20` | ### 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](/application/session-data-filtering). ## sidekiq\_report\_errors | Feld | Wert | | ----------------------------- | --------------------------------- | | Konfigurationsdatei-Schlüssel | `sidekiq_report_errors` | | Systemumgebungs-Schlüssel | `APPSIGNAL_SIDEKIQ_REPORT_ERRORS` | | Erforderlich | nein | | Typ | `String` | | Standardwert | `all` | | Verfügbar ab Version | `3.9.0` | ### Beschreibung Konfigurieren Sie die Meldung von Fehlern, die in [Sidekiq](/ruby/integrations/sidekiq)-Jobs auftreten. Akzeptierte Werte: * `all`: Alle Fehler bei jeder Job-Ausführung melden, einschließlich Wiederholungen. * `discard`: Fehler melden, wenn der Job aufgrund des Fehlers verworfen wird. Verwenden Sie diese Option, um nur dann Fehler zu melden, wenn alle Job-Wiederholungen ausgeschöpft sind. * `none`: Keine Fehler für Jobs melden, einschließlich Wiederholungen. Nützlich für benutzerdefinierte Fehlerberichterstattung. **Hinweis**: Die Option `discard` funktioniert nur in Sidekiq 5.1 und neuer. In niedrigeren Versionen wird `discard` als `all` interpretiert. ## skip\_session\_data | Feld | Wert | | ----------------------------- | ---------------------------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `skip_session_data` | | Systemumgebungs-Schlüssel | `APPSIGNAL_SKIP_SESSION_DATA` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` | | Verfügbar ab Version | `0.11.0` | | | | ### Beschreibung **Warnung**: Diese Konfigurationsoption ist im Ruby-Gem 3.0.20 veraltet. Bitte verwenden Sie für neuere Versionen des Ruby-Gems stattdessen die Option [`send_session_data`](#option-send_session_data). ## statsd\_port | Feld | Wert | | ----------------------------- | ----------------------- | | Konfigurationsdatei-Schlüssel | `statsd_port` | | Systemumgebungs-Schlüssel | `APPSIGNAL_STATSD_PORT` | | Erforderlich | nein | | Typ | `Integer` | | Standardwert | `8125` | | Verfügbar ab Version | `3.4.3` | ### 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. ## transaction\_debug\_mode | Feld | Wert | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `transaction_debug_mode` | | Systemumgebungs-Schlüssel | `APPSIGNAL_TRANSACTION_DEBUG_MODE` | | Erforderlich | nein | | Typ | Boolean (`true` / `false`) | | Standardwert | `false` | | Verfügbar ab Version | `2.9.18` | | | | ### Beschreibung **Warnung**: Diese Konfigurationsoption ist im Ruby-Gem 3.0.16 veraltet. Bitte verwenden Sie für Ruby-Gem 3.0.16 und neuer stattdessen die Option [`log_level`](#option-log_level). Aktiviert den Transaktions-Debug-Modus. Dies aktiviert eine sehr detaillierte Protokollierung von Transaktionen und Ereignissen, was bei der Entwicklung von Integrationen oder wenn Ereignisse nicht wie erwartet erfasst werden, nützlich ist. Das Log wird nur geschrieben, wenn auch die allgemeine Option `debug` aktiviert ist. Diese Option legt den Schweregrad des internen Loggers von AppSignal fest und hat keinen Einfluss auf die [Logging-Funktion](/logging). ## working\_dir\_path | Feld | Wert | | ----------------------------- | ---------------------------- | | Konfigurationsdatei-Schlüssel | `working_dir_path` | | Systemumgebungs-Schlüssel | `APPSIGNAL_WORKING_DIR_PATH` | | Erforderlich | nein | | Typ | `String` | | Standardwert | vom Agent erkannt | ### Beschreibung **Warnung**: Diese Konfigurationsoption ist im Ruby-Gem 2.7.0 veraltet. Bitte verwenden Sie für Ruby-Gem 2.7.0 und neuer stattdessen die Option [`working_directory_path`](#option-working_directory_path). Überschreibt den Ort, an dem AppSignal für Ruby ein Arbeitsverzeichnis erstellt. Siehe [`working_directory_path`](#appsignal_working_directory_path-working_directory_path) für das anwendbare Verhalten. Diese Konfigurationsoption hängt `/appsignal` an den angegebenen Pfad an, während [`working_directory_path`](#appsignal_working_directory_path-working_directory_path) dies nicht tut. **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. ## working\_directory\_path | Feld | Wert | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Konfigurationsdatei-Schlüssel | `working_directory_path` | | Systemumgebungs-Schlüssel | `APPSIGNAL_WORKING_DIRECTORY_PATH` | | Erforderlich | nein | | Typ | `String` | | Standardwert | vom Agent erkannt | | Verfügbar ab Version | `2.7.0` | | | | ### Beschreibung Überschreibt den Ort, an dem AppSignal für Ruby 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](/appsignal/how-appsignal-operates). Wenn Sie mehrere Anwendungen mit AppSignal auf demselben Server ausführen, verwenden Sie diese Konfigurationsoption, um für jede AppSignal-Instanz unterschiedliche Arbeitsverzeichnisse auszuwählen, da die beiden Instanzen sonst miteinander in Konflikt geraten könnten. Weitere Informationen zu diesem Szenario finden Sie in unserer Dokumentation [Mehrere Anwendungen auf einem Host ausführen](/guides/application/multiple-applications-on-one-host). ```ruby title="config/appsignal.rb" theme={null} Appsignal.configure do |config| config.working_directory_path = "/tmp/project_1/" end ``` ```yaml title="config/appsignal.yml" theme={null} default: &defaults working_directory_path: "/tmp/project_1/" ``` **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.