;
};
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](/guides/custom-data).
🔐 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](https://docs.appsignal.com/application/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:
```ruby Ruby theme={null}
# 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"]
```
```elixir Elixir theme={null}
# 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"
]
)
```
```javascript Node.js theme={null}
import { setCustomData } from "@appsignal/nodejs";
// Object
setCustomData({
stroopwaffle: {
caramel: true,
origin: "market",
},
});
// Array
setCustomData(["value 1", "value 2"]);
```
```python Python theme={null}
from appsignal import set_custom_data
# Map
set_custom_data({
"stroopwaffle": {
"caramel": true,
"origin": "market"
}
})
# Array
set_custom_data(["value 1", "value 2"])
```
```php PHP theme={null}
[
'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.
