Ajouter des données personnalisées - AppSignal Documentation

Vous pouvez utiliser des données d’échantillon personnalisées pour définir des valeurs plus dynamiques qu’il n’est possible avec d’autres types de personnalisation des données.

🔐 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 valeurs racines acceptées par langage. Chaque objet imbriqué peut contenir des valeurs qui produisent du JSON valide (chaînes, entiers, flottants, booléens, valeurs nulles, etc.).

Langage	Valeurs racines acceptées
Ruby	Arrays, Hashes
JavaScript	Arrays, Objects
Elixir	Lists, Maps
Python	Lists, Maps
PHP	Arrays, Objects

Il n’est pas possible de filtrer ou de rechercher sur les données définies comme données personnalisées. Elles fournissent uniquement une zone supplémentaire dans l’interface pour lister davantage de métadonnées. Lors de l’utilisation de données personnalisées pour des objets imbriqués, vous pouvez visualiser l’objet sur la page d’échantillon d’incident à la fois pour les échantillons d’exception et de performance formatés en JSON, comme dans l’exemple ci-dessous :

# Call `add_custom_data` multiple times to add more custom data
# Hash example
Appsignal.add_custom_data(
  :stroopwaffle => { :caramel => true },
  :market => { :type => "outdoors" }
)
Appsignal.add_custom_data(:market => { :state => :closed })
Appsignal.add_custom_data(:market => { :state => :open })
# Custom data:
# {
#   :stroopwaffle => { :caramel => true },
#   :market => { :state => :open }
# }

# Array example
Appsignal.add_custom_data(["value 1"])
Appsignal.add_custom_data(["value 2"])
# Custom data: ["value 1", "value 2"]

# Mixed data type example
# The Hash and Array data type cannot be mixed at the root level
Appsignal.add_custom_data(:market => :open)
Appsignal.add_custom_data(["value 1"])
# Custom data: ["value 1"]

# Map
Appsignal.Span.set_sample_data(
  Appsignal.Tracer.root_span,
  "custom_data",
  %{
    stroopwaffle: %{
      caramel: true,
      origin: "market"
    }
  }
)

# List
Appsignal.Span.set_sample_data(
  Appsignal.Tracer.root_span,
  "custom_data",
  [
    "value 1",
    "value 2"
  ]
)

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

// Object
setCustomData({
  stroopwaffle: {
    caramel: true,
    origin: "market",
  },
});

// Array
setCustomData(["value 1", "value 2"]);

from appsignal import set_custom_data

# Map
set_custom_data({
  "stroopwaffle": {
    "caramel": true,
    "origin": "market"
  }
})

# Array
set_custom_data(["value 1", "value 2"])

<?php
use Appsignal\Appsignal;

Appsignal::setCustomData([
    'stroopwaffle' => [
        'caramel' => true,
        'origin' => 'market',
    ],
]);

Si l’application définit plusieurs fois des données personnalisées, le gem Ruby fusionnera les valeurs au niveau racine. Pour les autres intégrations, seule la dernière valeur définie est stockée.