Pular para o conteúdo principal
O AppSignal é compatível com pacotes de instrumentação do OpenTelemetry. Alguns desses pacotes de instrumentação podem exigir configuração adicional. Isso nem sempre inclui as informações que você precisa para depurar problemas. Para um relatório mais granular, você pode adicionar instrumentação customizada. Damos suporte ao tracing do OpenTelemetry conforme descrito na documentação do OpenTelemetry. É possível adicionar mais dados a um span usando atributos de span do OpenTelemetry. Também existem atributos de span do AppSignal que podem mudar como os traces são agrupados e alguns atributos que permitem filtrar dados sensíveis.

Configuração

Ao adicionar instrumentação customizada, primeiro importe o pacote de trace do OpenTelemetry no arquivo onde você deseja adicionar a instrumentação.

Criando um novo span

Usando o tracer inicializado durante a instalação, crie um novo span.
Nota: Nestes exemplos, dependemos do contexto da requisição HTTP, fornecido por r.Context(). A forma de receber o contexto pode ser diferente na sua aplicação.

Obter o span atual

Você também pode obter o span atual usando o tracer inicializado durante a instalação:
Nota: Isso só retornará um span se já houver um ativo. Mais formas de criar e obter spans estão documentadas na página de instrumentação Go do OpenTelemetry.

Atributos do AppSignal

Depois de criar ou obter um span, você pode definir certos atributos específicos do AppSignal para personalizar como os dados chegam ao AppSignal.
Veja nossos guias para mais informações sobre quais atributos customizados do AppSignal são suportados:

Reportar erros

Para reportar um erro, registre-o em um span com o método RecordError do OpenTelemetry. Passe trace.WithStackTrace(true) para incluir o stack trace. Você também pode definir o status do span como Error com SetStatus.
RecordError adiciona ao span um evento exception com o tipo e a mensagem do erro, além do stack trace quando você passa trace.WithStackTrace(true). O AppSignal reporta esses eventos de exceção como erros quando eles são registrados no span raiz da parte do trace que pertence ao seu serviço, como o span de uma requisição HTTP recebida. Para impedir que o AppSignal reporte um erro, adicione o tipo dele à lista ignore_errors. O tipo é o tipo Go do erro, e o AppSignal também o exibe como o nome do erro. Por exemplo, todo erro criado com errors.New tem o tipo *errors.errorString. Então, adicionar esse tipo ignora todos eles.

Reportar um erro a partir de um span filho

O AppSignal só reporta um erro registrado em um span filho, como um span que você criou dentro de uma requisição, quando você adiciona o atributo appsignal.alert_this_error definido como true:

Reportar um erro fora de uma requisição

Para código que não roda dentro de uma requisição, como um job em segundo plano, inicie um novo span a partir de context.Background(). Esse span é o span raiz de um novo trace, então o AppSignal reporta os erros registrados nele: