;
};
Por padrão, as integrações do AppSignal rastreiam os dados de sessão da requisição para aplicativos web em bibliotecas suportadas.
Você pode definir dados de sessão personalizados em uma transação ou span. Modificar os dados de sessão sobrescreverá os dados definidos pelas instrumentações do AppSignal.
[Todos os dados de sessão da requisição são filtrados](/guides/filter-data/filter-session-data) por nossas integrações antes de serem enviados aos nossos servidores.
🔐 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 |
| Go | String serializada em JSON |
| Java | String serializada em JSON |
| PHP | Arrays, Objects |
```ruby Ruby theme={null}
# Chame `add_session_data` várias vezes para definir mais dados de sessão
Appsignal.add_session_data(
:user_id => "123",
:menu => { :type => "hamburger" }
)
Appsignal.add_session_data(:menu => { :state => "closed" })
Appsignal.add_session_data(:menu => { :state => "open" })
# Dados de sessão:
# {
# :user_id => "123",
# :menu => { :state => "open" }
# }
```
```elixir Elixir theme={null}
Appsignal.Span.set_sample_data(
Appsignal.Tracer.root_span,
"session_data",
%{user_id: "123", menu: "open"}
)
```
```javascript Node.js theme={null}
import { setSessionData } from "@appsignal/nodejs";
setSessionData({ user_id: "123", menu: "open" });
```
```python Python theme={null}
from appsignal import set_session_data
set_session_data({"user_id": "123", "menu": "open"})
```
```go Go theme={null}
// Uma configuração adicional é necessária para primeiro buscar ou criar um novo span
import (
"encoding/json"
"go.opentelemetry.io/otel/attribute"
"go.opentelemetry.io/otel/trace"
)
session_data := map[string]interface{}{
"key1": "value1",
"key2": "value2",
"nested": map[string]interface{}{
"key3": "value3",
"key4": "value4",
},
}
json, _ := json.Marshal(session_data)
span.SetAttributes(attribute.String("appsignal.request.session_data", string(json)))
```
```java Java theme={null}
// Uma configuração adicional é necessária para primeiro buscar ou criar um novo span
import io.opentelemetry.api.trace.Span;
// Estamos usando a biblioteca JSON Jackson
// Você pode precisar adicioná-la ao seu projeto como uma dependência
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.HashMap;
import java.util.Map;
Map sessionData = new HashMap<>();
sessionData.put("user_id", "123");
sessionData.put("menu", "open");
Map nested = new HashMap<>();
nested.put("key3", "value3");
nested.put("key4", "value4");
sessionData.put("nested", nested);
try {
ObjectMapper mapper = new ObjectMapper();
String jsonString = mapper.writeValueAsString(sessionData);
Span span = Span.current();
span.setAttribute("appsignal.request.session_data", jsonString);
} catch (Exception e) {
// Adicione o tratamento de erros aqui
}
```
```php PHP theme={null}
'value1',
'param2' => 'value2',
'nested' => [
'param3' => 'value3',
'param4' => 'value4',
],
];
Appsignal::setSessionData($data);
```
Para certas linguagens, é necessária uma configuração adicional.
Siga as instruções para essas linguagens:
* [Go](/go/custom-instrumentation)
* [Java](/java/custom-instrumentation)
## Limitações
Se a aplicação definir dados de sessão várias vezes, a gem Ruby mesclará os valores no nível raiz.
Para outras integrações, apenas o último valor definido é armazenado.
## Limitações
Se a aplicação definir dados de sessão várias vezes, a gem Ruby mesclará os valores no nível raiz.
Para outras integrações, apenas o último valor definido é armazenado.