Benutzerdefinierte Daten hinzufügen

Sie können benutzerdefinierte Sample-Daten verwenden, um dynamischere Werte zu setzen, als es mit anderen Arten der Datenanpassung möglich ist.

🔐 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 Stammwerte pro Sprache. Jedes verschachtelte Objekt kann Werte enthalten, die zu gültigem JSON führen (Strings, Integer, Floats, Booleans, Nulls usw.).

Sprache	Akzeptierte Stammwerte
Ruby	Arrays, Hashes
JavaScript	Arrays, Objekte
Elixir	Lists, Maps
Python	Lists, Maps
PHP	Arrays, Objekte

Es ist nicht möglich, die als benutzerdefinierte Daten festgelegten Daten zu filtern oder zu durchsuchen. Sie bieten nur einen zusätzlichen Bereich in der Benutzeroberfläche, um weitere Metadaten aufzulisten. Wenn Sie benutzerdefinierte Daten für verschachtelte Objekte verwenden, können Sie das Objekt auf der Incident-Sample-Seite sowohl für Exception- als auch Performance-Samples als JSON formatiert anzeigen, wie im folgenden Beispiel:

# Rufen Sie `add_custom_data` mehrmals auf, um weitere benutzerdefinierte Daten hinzuzufügen
# Hash-Beispiel
Appsignal.add_custom_data(
  :stroopwaffle => { :caramel => true },
  :market => { :type => "outdoors" }
)
Appsignal.add_custom_data(:market => { :state => :closed })
Appsignal.add_custom_data(:market => { :state => :open })
# Benutzerdefinierte Daten:
# {
#   :stroopwaffle => { :caramel => true },
#   :market => { :state => :open }
# }

# Array-Beispiel
Appsignal.add_custom_data(["value 1"])
Appsignal.add_custom_data(["value 2"])
# Benutzerdefinierte Daten: ["value 1", "value 2"]

# Beispiel für gemischte Datentypen
# Die Datentypen Hash und Array können auf der obersten Ebene nicht gemischt werden
Appsignal.add_custom_data(:market => :open)
Appsignal.add_custom_data(["value 1"])
# Benutzerdefinierte Daten: ["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',
    ],
]);

Wenn die Anwendung benutzerdefinierte Daten mehrmals setzt, führt das Ruby-Gem die Werte auf der Stammebene zusammen. Für andere Integrationen wird nur der zuletzt gesetzte Wert gespeichert.

Erste Schritte

Anleitungen