> ## 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 Collectors

Der Collector kann beim Start über Umgebungsvariablen oder eine Konfigurationsdatei [konfiguriert](/collector/configuration) 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](/collector/configuration).

## Verfügbare Optionen

* Erforderliche Optionen
  * [`push_api_key`](#option-push_api_key)
* Optionen
  * [`cpu_count`](#option-cpu_count)
  * [`enable_host_metrics`](#option-enable_host_metrics)
  * [`files_world_accessible`](#option-files_world_accessible)
  * [`hostname`](#option-hostname)
  * [`http_port`](#option-http_port)
  * [`log_level`](#option-log_level)
  * [`push_api_endpoint`](#option-push_api_endpoint)
  * [`running_in_container`](#option-running_in_container)
  * [`working_directory_path`](#option-working_directory_path)

## push\_api\_key

<a id="option-push_api_key" />

| Feld                             | Wert                                       |
| -------------------------------- | ------------------------------------------ |
| Schlüssel in Konfigurationsdatei | `push_api_key`                             |
| Systemumgebungsschlüssel         | `APPSIGNAL_PUSH_API_KEY`                   |
| Erforderlich                     | ja                                         |
| Typ                              | `String`                                   |
| Standardwert                     | nil (Dies ist 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).

## cpu\_count

<a id="option-cpu_count" />

| Feld                             | Wert                  |
| -------------------------------- | --------------------- |
| Schlüssel in Konfigurationsdatei | `cpu_count`           |
| Systemumgebungsschlüssel         | `APPSIGNAL_CPU_COUNT` |
| Erforderlich                     | nein                  |
| Typ                              | `Float`               |
| Standardwert                     | `undefined`           |
| Verfügbar seit Version           | `0.3.0`               |

### 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

<a id="option-enable_host_metrics" />

| Feld                             | Wert                                                                                                                                  |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Schlüssel in Konfigurationsdatei | `enable_host_metrics`                                                                                                                 |
| Systemumgebungsschlüssel         | `APPSIGNAL_ENABLE_HOST_METRICS`                                                                                                       |
| Erforderlich                     | nein                                                                                                                                  |
| Typ                              | Boolean (`true` / `false`)                                                                                                            |
| Standardwert                     | `false`                                                                                                                               |
| Verfügbar seit Version           | `0.3.0`                                                                                                                               |
|                                  | <ul><li>`0.8.0`: Standardmäßig deaktiviert.</li><li>`0.3.0`: Standardmäßig im Docker-Image appsignal/collector deaktiviert.</li></ul> |

### 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, 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](/heroku/host-metrics).

## files\_world\_accessible

<a id="option-files_world_accessible" />

| Feld                             | Wert                               |
| -------------------------------- | ---------------------------------- |
| Schlüssel in Konfigurationsdatei | `files_world_accessible`           |
| Systemumgebungsschlüssel         | `APPSIGNAL_FILES_WORLD_ACCESSIBLE` |
| Erforderlich                     | nein                               |
| Typ                              | Boolean (`true` / `false`)         |
| Standardwert                     | `true`                             |
| Verfügbar seit Version           | `0.1.0`                            |

### 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 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

<a id="option-hostname" />

| Feld                             | Wert                 |
| -------------------------------- | -------------------- |
| Schlüssel in Konfigurationsdatei | `hostname`           |
| Systemumgebungsschlüssel         | `APPSIGNAL_HOSTNAME` |
| Erforderlich                     | nein                 |
| Typ                              | `String`             |
| Standardwert                     | vom System erkannt   |
| Verfügbar seit Version           | `0.3.0`              |

### 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

<a id="option-http_port" />

| Feld                             | Wert                  |
| -------------------------------- | --------------------- |
| Schlüssel in Konfigurationsdatei | `http_port`           |
| Systemumgebungsschlüssel         | `APPSIGNAL_HTTP_PORT` |
| Erforderlich                     | nein                  |
| Typ                              | `Integer`             |
| Standardwert                     | `8099`                |
| Verfügbar seit Version           | `0.3.0`               |

### Beschreibung

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

## log\_level

<a id="option-log_level" />

| Feld                             | Wert                  |
| -------------------------------- | --------------------- |
| Schlüssel in Konfigurationsdatei | `log_level`           |
| Systemumgebungsschlüssel         | `APPSIGNAL_LOG_LEVEL` |
| Erforderlich                     | nein                  |
| Typ                              | `String`              |
| Standardwert                     | `info`                |
| Verfügbar seit Version           | `0.1.0`               |

### Beschreibung

<Note>
  Diese Option legt den Schweregrad des internen Loggers von AppSignal fest und
  hat keine Auswirkung auf das [Logging-Feature](/logging).
</Note>

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

<a id="option-push_api_endpoint" />

| Feld                             | Wert                          |
| -------------------------------- | ----------------------------- |
| Schlüssel in Konfigurationsdatei | `push_api_endpoint`           |
| Systemumgebungsschlüssel         | `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 zum Senden von Daten an AppSignal. Diese Einstellung muss in der Regel nicht geändert werden.

## running\_in\_container

<a id="option-running_in_container" />

| Feld                             | Wert                             |
| -------------------------------- | -------------------------------- |
| Schlüssel in Konfigurationsdatei | `running_in_container`           |
| Systemumgebungsschlüssel         | `APPSIGNAL_RUNNING_IN_CONTAINER` |
| Erforderlich                     | nein                             |
| Typ                              | Boolean (`true` / `false`)       |
| Standardwert                     | vom Collector erkannt            |
| Verfügbar seit Version           | `0.3.0`                          |

### 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](mailto:support@appsignal.com).

Diese Option wird auf [Heroku](http://heroku.com/) automatisch auf `true` gesetzt.

## working\_directory\_path

<a id="option-working_directory_path" />

| Feld                             | Wert                                                                                                   |
| -------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Schlüssel in Konfigurationsdatei | `working_directory_path`                                                                               |
| Systemumgebungsschlüssel         | `APPSIGNAL_WORKING_DIRECTORY_PATH`                                                                     |
| Erforderlich                     | nein                                                                                                   |
| Typ                              | `String`                                                                                               |
| Standardwert                     | vom Collector erkannt                                                                                  |
| Verfügbar seit Version           | `0.1.0`                                                                                                |
|                                  | <ul><li>Diese Konfigurationsoption hieß in den Versionen 0.1.0 bis 0.3.x `working_dir_path`.</li></ul> |

### 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](/appsignal/how-appsignal-operates).

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](/guides/application/multiple-applications-on-one-host).

<Note>
  **Hinweis**: Der angegebene Pfad darf keine betriebssystemspezifischen
  Dateisystem-Abstraktionen enthalten, z. B. das Homedir-Symbol `~` für
  \*NIX-Systeme. Dies wird als ungültiger Pfad angesehen.
</Note>
