Adicionar parâmetros de requisição

Por padrão, as integrações do AppSignal rastreiam os parâmetros de requisição para requisições web em bibliotecas suportadas. Isso inclui parâmetros de consulta e o corpo da requisição POST*. Para jobs em segundo plano, armazenamos os argumentos do job nos parâmetros.

*: O pacote AppSignal para PHP e as linguagens suportadas por meio de nosso beta de OpenTelemetry armazenam os parâmetros de consulta da requisição e os dados da payload da requisição separadamente. Veja a seção dados da payload da requisição para mais informações sobre como definir os dados da payload da requisição separadamente.

🔐 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.

Você pode definir parâmetros personalizados em uma transação ou span. Modificar os parâmetros de uma transação sobrescreverá os dados definidos pelas instrumentações do AppSignal. Todos os parâmetros são filtrados por nossas integrações antes de serem enviados aos nossos servidores. 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

O exemplo de código abaixo mostra como definir parâmetros de requisição personalizados:

# Values are merged at the top level
Appsignal.add_request_payload(
  :post => {
    :title => "My title",
    :body => "Post text."
  }
)
Appsignal.add_request_payload(:user => { :login => "some_name" })
Appsignal.add_request_payload(:user => { :id => 123 })
# Parameters:
# {
#   :post => { :title => "My title", :body => "Post text." },
#   :user => { :id => 123 }
# }

# Os valores são mesclados no nível superior
Appsignal.add_params(
  :post => {
    :title => "My title",
    :body => "Post text."
  }
)
Appsignal.add_params(:user => { :login => "some_name" })
Appsignal.add_params(:user => { :id => 123 })
# Parâmetros:
# {
#   :post => { :title => "My title", :body => "Post text." },
#   :user => { :id => 123 }
# }

Appsignal.Span.set_sample_data(
  Appsignal.Tracer.root_span,
  "params",
  %{
    post: %{
      title: "My new blog post!",
      body: "Some long blog post text."
    }
  }
)

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

setParams({
  post: {
    title: "My new blog post!",
    body: "Some long blog post text.",
  },
});

from appsignal import set_params

set_params({
  post: {
    title: "My new blog post!",
    body: "Some long blog post text."
  }
})

// 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"
)

params := map[string]interface{}{
	"param1": "value1",
	"param2": "value2",
	"nested": map[string]interface{}{
		"param3": "value3",
		"param4": "value4",
	},
}
json, _ := json.Marshal(params)
span.SetAttributes(attribute.String("appsignal.request.query_parameters", string(json)))

// 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<String, Object> queryParams = new HashMap<>();
queryParams.put("param1", "value1");
queryParams.put("param2", "value2");

Map<String, String> nested = new HashMap<>();
nested.put("param3", "value3");
nested.put("param4", "value4");
queryParams.put("nested", nested);

try {
    ObjectMapper mapper = new ObjectMapper();
    String jsonString = mapper.writeValueAsString(queryParams);

    Span span = Span.current();
    span.setAttribute("appsignal.request.query_parameters", jsonString);
} catch (Exception e) {
    // Adicione o tratamento de erros aqui
}

<?php
use Appsignal\Appsignal;

$params = [
    'param1' => 'value1',
    'param2' => 'value2',
    'nested' => [
        'param3' => 'value3',
        'param4' => 'value4',
    ],
];

Appsignal::setParams($params);

Para certas linguagens, é necessária uma configuração adicional. Siga as instruções para essas linguagens:

Go
Java

Tipos de parâmetros no AppSignal for Ruby

A versão 5.0.0 da gem Ruby separa os parâmetros em três tipos e dá a cada tipo seu próprio método:

# The body of a request.
Appsignal.add_request_payload(:post => { :title => "My title" })

# The parameters read from a request's query string.
Appsignal.add_query_parameters(:page => "2")

# The arguments a background job or script was called with.
Appsignal.add_function_parameters(:user_id => 123)

No modo collector, cada tipo é reportado como seu próprio atributo. Você pode filtrar e desativar cada um separadamente. Caso contrário, os três gravam nos mesmos parâmetros e aparecem na mesma caixa. Os valores são mesclados no nível raiz. Chaves definidas uma vez se acumulam, e uma chave definida duas vezes mantém o último valor. Appsignal.add_params e Appsignal.set_params continuam funcionando. No modo collector, eles estão obsoletos, pois não indicam a qual tipo os parâmetros pertencem. Tudo o que eles definem se torna, então, a payload da requisição. O AppSignal exibe um aviso na primeira vez que você os usa. Use o método correspondente aos seus dados, ou Appsignal.add_custom_data para dados que não sejam nenhum dos três tipos.

Dados da payload da requisição

O pacote AppSignal para PHP, a versão 5.0.0 e superiores da gem AppSignal for Ruby, e as linguagens suportadas por meio de nosso beta de OpenTelemetry armazenam os parâmetros de consulta da requisição e os dados da payload da requisição separadamente. Esta seção descreve como definir os dados da payload da requisição de requisições POST. Você pode definir dados personalizados de payload de requisição em um span. Modificar os dados de payload da requisição de um span sobrescreverá os dados definidos pelas instrumentações do AppSignal. Todos os parâmetros são filtrados por nossas integrações antes de serem enviados aos nossos servidores. 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
Go	String serializada em JSON
Java	String serializada em JSON
PHP	Arrays, Objects

O exemplo de código abaixo mostra como definir dados personalizados de payload de requisição:

Appsignal.add_request_payload(
  :post => {
    :title => "My title",
    :body => "Post text."
  }
)

// 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"
)

payload := map[string]interface{}{
	"param1": "value1",
	"param2": "value2",
	"nested": map[string]interface{}{
		"param3": "value3",
		"param4": "value4",
	},
}
json, _ := json.Marshal(payload)
span.SetAttributes(attribute.String("appsignal.request.payload", string(json)))

// 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<String, Object> payload = new HashMap<>();
payload.put("param1", "value1");
payload.put("param2", "value2");

Map<String, String> nested = new HashMap<>();
nested.put("param3", "value3");
nested.put("param4", "value4");
payload.put("nested", nested);

try {
    ObjectMapper mapper = new ObjectMapper();
    String jsonString = mapper.writeValueAsString(payload);

    Span span = Span.current();
    span.setAttribute("appsignal.request.payload", jsonString);
} catch (Exception e) {
    // Adicione o tratamento de erros aqui
}

<?php
use Appsignal\Appsignal;

$payload = [
    'param1' => 'value1',
    'param2' => 'value2',
    'nested' => [
        'param3' => 'value3',
        'param4' => 'value4',
    ],
];

Appsignal::setPayload($payload);

Para certas linguagens, é necessária uma configuração adicional. Siga as instruções para essas linguagens:

Go
Java

Limitações

Se a aplicação definir os parâmetros de consulta da requisição ou os dados de payload da requisição 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

Tipos de parâmetros no AppSignal for Ruby

Dados da payload da requisição

Limitações

​Tipos de parâmetros no AppSignal for Ruby

​Dados da payload da requisição

​Limitações

Tipos de parâmetros no AppSignal for Ruby

Dados da payload da requisição

Limitações