Ajouter des en-têtes de requête - AppSignal Documentation

Par défaut, les intégrations AppSignal suivent les en-têtes HTTP des requêtes pour les applications web dans les bibliothèques prises en charge. Vous pouvez définir des en-têtes de requête personnalisés sur une transaction ou un span. Modifier les en-têtes de requête écrasera les données définies par les instrumentations AppSignal. Tous les en-têtes de requête sont filtrés par nos intégrations avant d’être envoyés à nos serveurs.

🔐 N’envoyez pas d’informations personnelles identifiables (PII) à AppSignal. Filtrez les PII (par exemple, noms, e-mails) et utilisez un identifiant, un hash ou un identifiant pseudonymisé à la place.

Utilisez les Link Templates pour les relier dans votre application.

Consultez le tableau ci-dessous pour la liste des types de valeurs acceptés pour les en-têtes de requête.

Langage	Nom d’en-tête accepté	Valeur d’en-tête acceptée
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

L’exemple de code ci-dessous montre comment définir des en-têtes de requête personnalisés :

# Call `add_headers` multiple times to set more headers
Appsignal.add_headers("REQUEST_METHOD" => "GET", "REQUEST_PATH" => "/some-path")
Appsignal.add_headers("PATH_INFO" => "/a-path")
Appsignal.add_headers("PATH_INFO" => "/some-path")
# Headers:
# {
#   "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");

// Additional setup is required to first fetch or create a new span
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;

// Additional setup is required to first fetch or create a new span
Span span = Span.current();

// Set single header values
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");

// Set header with multiple values (array)
span.setAttribute(
    AttributeKey.stringArrayKey("http.request.header.custom-header"),
    Arrays.asList("value1", "value2")
);

<?php
use Appsignal\Appsignal;

// Set single header values
Appsignal::addHeaders([
    'request-method' => 'GET',
    'path-info' => '/some-path',
    'content-type' => 'application/json',
]);

// Set header with multiple values (array)
Appsignal::addHeaders([
    'custom-header' => ['value1', 'value2'],
]);

Pour certains langages, une configuration supplémentaire est requise. Veuillez suivre les instructions pour ces langages :

Go
Java

Limitations

Seule la dernière valeur d’un en-tête de requête est stockée si l’application définit un en-tête de requête plusieurs fois. Pour Elixir, si l’assistant est appelé plusieurs fois, seul le dernier ensemble d’en-têtes de requête (environnement) est stocké.

​Limitations

Limitations