Adicionar dados personalizados

Você pode usar dados de amostra personalizados para definir valores mais dinâmicos do que é possível com outros tipos de personalização de dados.

🔐 Não envie Informações Pessoais Identificáveis (PII) para a AppSignal. Filtre PII (por exemplo, nomes, e-mails) e use um ID, hash ou identificador pseudonimizado no lugar.

Use Link Templates para vinculá-los de volta em sua aplicação.

Veja a tabela abaixo para uma lista de valores raiz aceitos por linguagem. Cada objeto aninhado pode conter valores que resultem em JSON válido (strings, inteiros, floats, booleanos, nulls, etc.).

Linguagem	Valores raiz aceitos
Ruby	Arrays, Hashes
JavaScript	Arrays, Objects
Elixir	Lists, Maps
Python	Lists, Maps
PHP	Arrays, Objects

Não é possível filtrar ou pesquisar nos dados definidos como dados personalizados. Eles apenas fornecem uma área adicional na interface para listar mais metadados. Ao usar dados personalizados para objetos aninhados, você pode visualizar o objeto na página Incident Sample para amostras de Exception e Performance, formatado como JSON, como no exemplo abaixo:

# Chame `add_custom_data` várias vezes para adicionar mais dados personalizados
# Exemplo de Hash
Appsignal.add_custom_data(
  :stroopwaffle => { :caramel => true },
  :market => { :type => "outdoors" }
)
Appsignal.add_custom_data(:market => { :state => :closed })
Appsignal.add_custom_data(:market => { :state => :open })
# Dados personalizados:
# {
#   :stroopwaffle => { :caramel => true },
#   :market => { :state => :open }
# }

# Exemplo de Array
Appsignal.add_custom_data(["value 1"])
Appsignal.add_custom_data(["value 2"])
# Dados personalizados: ["value 1", "value 2"]

# Exemplo de tipo de dados misto
# Os tipos de dados Hash e Array não podem ser misturados no nível raiz
Appsignal.add_custom_data(:market => :open)
Appsignal.add_custom_data(["value 1"])
# Dados personalizados: ["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',
    ],
]);

Se a aplicação definir dados personalizados várias vezes, a gem Ruby mesclará os valores no nível raiz. Para outras integrações, apenas o último valor definido é armazenado.

Introdução

Guias