Erfassung von Request-Headern

AppSignal erfasst standardmäßig einen begrenzten Satz von HTTP-Request-Headern für unterstützte Frameworks. Diese Header können helfen, Fehler oder Performance-Probleme aufzuspüren, die durch eine Client-Anfrage verursacht wurden. Um die DSGVO einzuhalten, hält AppSignal diese Standardauswahl klein und erfasst keine benutzeridentifizierbaren Daten. Sie können sie weiter einschränken, indem Sie konfigurieren, welche Header AppSignal erfasst.

🔐 Senden Sie keine personenbezogenen Daten (Personal Identifiable Information, PII) an AppSignal. Filtern Sie PII (z. B. Namen, E-Mail-Adressen) und verwenden Sie stattdessen eine ID, einen Hash oder einen pseudonymisierten Bezeichner.

Für HIPAA-pflichtige Stellen finden Sie weitere Informationen zum Abschluss eines Business Associate Agreement (BAA) in unserer Business Add-Ons-Dokumentation.

Header konfigurieren

Request-Header werden in einer Allowlist konfiguriert. AppSignal erfasst die Header aus der Liste und weder den Namen noch den Wert eines anderen Headers außerhalb davon. Header-Namen sind kleingeschrieben und durch Bindestriche getrennt, so wie eine HTTP-Anfrage sie schreibt. Melden Sie den Header X-Custom-Header, indem Sie x-custom-header zur Liste hinzufügen. AppSignal für Ruby benennt sie anders, wenn es an den Agent meldet. Dieser Leitfaden zeigt Ihnen, wie Sie die Request-Header-Filterungs-Allowlist Ihrer Anwendung basierend auf der von Ihrer Anwendung verwendeten Sprache konfigurieren:

Ruby
Elixir
Node.js
Python
Go
Java
PHP

Ruby

AppSignal speichert die konfigurierten Request-Header in der Ruby-Integration für Rails-Apps und andere Frameworks automatisch. Es liest sie aus der Rack-Umgebung, die den Schlüssel eines Headers benennt, indem sie ihn mit HTTP_ versieht, großschreibt und Bindestriche (-) durch Unterstriche (_) ersetzt. So wird aus X-Custom-Header HTTP_X_CUSTOM_HEADER. CONTENT_LENGTH und CONTENT_TYPE sind die beiden Schlüssel, die Rack nicht mit einem Präfix versieht. Die Konfigurationsoption request_headers listet diese Rack-Schlüssel auf. Einige von ihnen enthalten andere Werte als Header, etwa REQUEST_METHOD und SERVER_NAME.

Standardliste der Request-Header

Appsignal.configure do |config|
  config.request_headers += ["HTTP_X_CUSTOM_HEADER"]
end

production:
  request_headers: # Example list of Rack environment keys
    - HTTP_ACCEPT
    - HTTP_X_CUSTOM_HEADER

Ruby im Collector-Modus

Wenn AppSignal für Ruby an einen Collector meldet, meldet es Request-Header unter ihren HTTP-Namen und meldet den Rest der Rack-Umgebung separat. Zwei Konfigurationsoptionen ersetzen request_headers:

keep_request_headers listet Request-Header auf, benannt so, wie eine HTTP-Anfrage sie schreibt. Melden Sie den Header X-Custom-Header, indem Sie x-custom-header zur Liste hinzufügen.
keep_request_environment listet die zu meldenden Rack-Umgebungsschlüssel auf, die andere Informationen als Header darstellen, etwa REMOTE_ADDR.

Appsignal.configure do |config|
  config.keep_request_headers += ["x-custom-header"]
  config.keep_request_environment += ["REMOTE_ADDR"]
end

production:
  keep_request_headers:
    - accept
    - x-custom-header
  keep_request_environment:
    - REMOTE_ADDR

Bis Sie diese Konfigurationsoptionen setzen, leitet AppSignal ihre Werte von request_headers ab, sodass im Collector-Modus dieselben Header gemeldet werden wie im Agent-Modus.

Elixir

AppSignal speichert die konfigurierten Request-Header für Phoenix-Apps und andere Frameworks in der Elixir-Integration automatisch. Es verfügt über eine eingebaute Liste von standardmäßig erfassten Request-Headern, die Sie mit der request_headers-Konfigurationsoption anpassen können.

Standardliste der Request-Header

Um zu konfigurieren, welche Request-Header für jede Anfrage erfasst werden sollen, fügen Sie die folgende Konfiguration zu Ihrer config/appsignal.exs-Datei in der Umgebungsgruppe hinzu, in der sie gelten soll. Der request_headers-Wert ist eine Liste von Strings.

config :appsignal, :config,
  request_headers: ~w(
    path-info request-method request-uri server-name server-port server-protocol
  ) # Beispielliste von Headern

Node.js

In der Node.js-Integration speichert AppSignal die konfigurierten Request-Header für Express-Apps und andere Frameworks automatisch. Es verfügt über eine eingebaute Liste von standardmäßig erfassten Request-Headern, die Sie mit der requestHeaders-Konfigurationsoption anpassen können.

Standardliste der Request-Header

Um zu konfigurieren, welche Request-Header für jede Anfrage erfasst werden sollen, fügen Sie die folgende Konfiguration zur Erstellung Ihrer AppSignal-Client-Instanz hinzu. Der requestHeaders-Wert ist ein Array von Strings.

const { Appsignal } = require("@appsignal/nodejs");

new Appsignal({
  requestHeaders: ["accept", "cache-control", "content-length", "range"],
});

Python

Wenn in der Python-Integration eine App Request-Header setzt, erfasst AppSignal die konfigurierten Request-Header automatisch. Es verfügt über eine eingebaute Liste von standardmäßig erfassten Request-Headern, die Sie mit der request_headers-Konfigurationsoption anpassen können.

Standardliste der Request-Header

from appsignal import Appsignal

appsignal = Appsignal(
    # Andere Konfiguration
    request_headers=["accept", "cache-control", "content-length", "range"],
)

Go

Wenn eine App Request-Header aufzeichnet, filtert AppSignal die konfigurierten Request-Header automatisch. Es verfügt über eine eingebaute Liste von standardmäßig erfassten Request-Headern, die Sie mit der request_headers-Konfigurationsoption anpassen können.

Standardliste der Request-Header

Weitere Informationen zur Konfiguration von OpenTelemetry für Go-Apps finden Sie auf der Go-Konfigurationsseite. Um zu konfigurieren, welche Request-Header für jede Anfrage erfasst werden sollen, fügen Sie die folgende Konfiguration zur Erstellung Ihrer AppSignal-Client-Instanz hinzu. Der request_headers-Wert ist ein Slice von Strings.

res := resource.NewWithAttributes(
	// Nur diese bestimmten Header senden
	attribute.StringSlice("appsignal.config.request_headers", []string{"accept", "request_method", "content_length"}),

	// Keine Header senden
	attribute.StringSlice("appsignal.config.request_headers", []string{}),
)

Java

Wenn in der Java-Integration eine App Request-Header setzt, erfasst AppSignal die konfigurierten Request-Header automatisch. Es verfügt über eine eingebaute Liste von standardmäßig erfassten Request-Headern, die Sie mit der request_headers-Konfigurationsoption anpassen können.

Standardliste der Request-Header

Um zu konfigurieren, welche Request-Header für jede Anfrage erfasst werden sollen, fügen Sie die folgende Konfiguration hinzu. Der request_headers-Wert ist ein Array von Strings.

function encode() {
  echo -n "$@" | sed 's/,/%2C/g'
}

export OTEL_RESOURCE_ATTRIBUTES="\
  appsignal.config.request_headers=$(encode "accept,cache-control,content-length,range"),\
  ..."

# Keine Header senden
export OTEL_RESOURCE_ATTRIBUTES="\
  appsignal.config.request_headers=,\
  ..."

PHP

Wenn in der PHP-Integration eine App Request-Header setzt, erfasst AppSignal die konfigurierten Request-Header automatisch. Es verfügt über eine eingebaute Liste von standardmäßig erfassten Request-Headern, die Sie mit der request_headers-Konfigurationsoption anpassen können.

Standardliste der Request-Header

Um zu konfigurieren, welche Request-Header für jede Anfrage erfasst werden sollen, fügen Sie die folgende Konfiguration hinzu. Der request_headers-Wert ist ein Array von Strings.

return [
    // Ausgewählte Header senden
    'request_headers' => ['accept', 'cache-control', 'content-length', 'range'],

    // Keine Header senden
    'request_headers' => [],

    // ... andere Optionen
];

Startseite

Anleitungen

Header konfigurieren

Ruby

Ruby im Collector-Modus

Elixir

Node.js

Python

Go

Java

PHP

​Header konfigurieren

​Ruby

​Ruby im Collector-Modus

​Elixir

​Node.js

​Python

​Go

​Java

​PHP

Header konfigurieren

Ruby

Ruby im Collector-Modus

Elixir

Node.js

Python

Go

Java

PHP