Sintaxe
newrelic_accept_distributed_trace_payload_httpsafe(string $httpsafe_payload, string $transport_type)
Aceita uma carga útil distributed trace que inclui uma string JSON HTTPSafe (codificada em Base64).
Requisitos
Requer agente PHP versão 8.4 ou superior.
Descrição
distributed tracing permite que você veja o caminho que uma solicitação percorre ao percorrer sistemas distribuídos. Isto é útil, por exemplo, quando transações individuais ocorrem em vários serviços e você deseja examiná-las como um rastreamento completo da transação.
Importante
Com o agente PHP versão 9.10 ou superior, as seguintes funções JSON agora são consideradas obsoletas e serão removidas em uma versão futura:
newrelic_create_distributed_trace_payload()newrelic_accept_distributed_trace_payload($payload)newrelic_accept_distributed_trace_payload_httpsafe($payload)
Em vez disso, use a API compatível com o suporte ao W3C Trace Context, adicionada na versão 9.8 do agente. Com isso, a API do aplicativo instrumentado manualmente mudou das funções relacionadas ao payload JSON para os seguintes formatos de matriz de cabeçalho:
newrelic_insert_distributed_trace_headers($outbound_headers)newrelic_accept_distributed_trace_headers($inbound_headers)
Parâmetro
Parâmetro | Descrição |
---|---|
corda | Obrigatório. Uma representação de string JSON HTTPSafe (codificada em Base64) da carga útil. |
corda | Opcional. Uma string que substitui o tipo de transporte padrão. Valores padrão:
|
Valores de retorno
Retorna true
para indicar sucesso ou false
se ocorrer um erro.
Exemplos
Para obter exemplos de como e quando usar este método API, consulte a documentação para usar manualmente o instrumento aplicativo e serviços.