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.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: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.Reportar erros
Para reportar um erro, registre-o em um span com o métodoRecordError 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 atributoappsignal.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 decontext.Background(). Esse span é o span raiz de um novo trace, então o AppSignal reporta os erros registrados nele: