Request-Header hinzufügen - AppSignal Documentation

Standardmäßig erfassen die AppSignal-Integrationen HTTP-Request-Header für Webanwendungen in unterstützten Bibliotheken. Sie können benutzerdefinierte Request-Header an einer Transaktion oder einem Span setzen. Das Ändern der Request-Header überschreibt die durch die AppSignal-Instrumentierungen gesetzten Daten. Alle Request-Header werden gefiltert durch unsere Integrationen, bevor sie an unsere Server gesendet werden.

🔐 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.

Verwenden Sie Link Templates, um sie in Ihrer Anwendung zurückzuverknüpfen.

Die folgende Tabelle enthält eine Liste der akzeptierten Werttypen für Request-Header.

Sprache	Akzeptierter Header-Name	Akzeptierter Header-Wert
Ruby	String	String
Elixir	String	String
Node.js	String	String
Python	String	String
Go	String	String, String slice
Java	String	String, String array
PHP	String	String, String array

Das untenstehende Codebeispiel zeigt, wie benutzerdefinierte Request-Header gesetzt werden:

# Rufen Sie `add_headers` mehrmals auf, um weitere Header zu setzen
Appsignal.add_headers("REQUEST_METHOD" => "GET", "REQUEST_PATH" => "/some-path")
Appsignal.add_headers("PATH_INFO" => "/a-path")
Appsignal.add_headers("PATH_INFO" => "/some-path")
# Header:
# {
#   "REQUEST_METHOD" => "GET",
#   "REQUEST_PATH" => "/some-path",
#   "PATH_INFO" => "/some-path"
# }

Appsignal.Span.set_sample_data(
  Appsignal.Tracer.root_span,
  "environment",
  %{
    "request_method" => "GET",
    "path_info" => "/some-path"
  }
)

import { setHeader } from "@appsignal/nodejs";

setHeader("request_method", "GET");
setHeader("path_info", "/some-path");

from appsignal import set_header

set_header("request_method", "GET");
set_header("path_info", "/some-path");

// Zusätzliches Setup ist erforderlich, um zuerst einen neuen Span abzurufen oder zu erstellen
span.SetAttributes(attribute.StringSlice("http.request.header.content-type", []string{"application/json"}))
span.SetAttributes(attribute.StringSlice("http.request.header.custom-header"), []string{"abc", "def"})

import io.opentelemetry.api.trace.Span;
import io.opentelemetry.api.common.AttributeKey;
import java.util.Arrays;

// Zusätzliches Setup ist erforderlich, um zuerst einen neuen Span abzurufen oder zu erstellen
Span span = Span.current();

// Einzelne Header-Werte setzen
span.setAttribute("http.request.header.request-method", "GET");
span.setAttribute("http.request.header.path-info", "/some-path");
span.setAttribute("http.request.header.content-type", "application/json");

// Header mit mehreren Werten setzen (Array)
span.setAttribute(
    AttributeKey.stringArrayKey("http.request.header.custom-header"),
    Arrays.asList("value1", "value2")
);

<?php
use Appsignal\Appsignal;

// Einzelne Header-Werte setzen
Appsignal::addHeaders([
    'request-method' => 'GET',
    'path-info' => '/some-path',
    'content-type' => 'application/json',
]);

// Header mit mehreren Werten setzen (Array)
Appsignal::addHeaders([
    'custom-header' => ['value1', 'value2'],
]);

Für bestimmte Sprachen ist zusätzliches Setup erforderlich. Bitte folgen Sie den Anweisungen für diese Sprachen:

Go
Java

Einschränkungen

Wenn die Anwendung einen Request-Header mehrmals setzt, wird nur der letzte Wert für einen Request-Header gespeichert. Für Elixir wird, wenn der Helfer mehrmals aufgerufen wird, nur das letzte Set von Request-Headern (Umgebung) gespeichert.

​Einschränkungen

Einschränkungen