• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

Criar um problema

ISpan

Sintaxe

Public interface ISpan

Fornece acesso a métodos específicos de span na API New Relic.

Descrição

Fornece acesso a métodos específicos de span na API do agente .NET da New Relic. Para obter uma referência a ISpan, use:

  • A propriedade CurrentSpan em IAgent (recomendado).
  • A propriedade CurrentSpan em ITransaction.

Esta seção contém descrições e parâmetros dos métodos ISpan :

Nome

Descrição

AddCustomAttribute

Adicione informações contextuais da sua aplicação ao período atual em forma de atributo.

SetName

Altera o nome do intervalo/segmento/métrica atual que será relatado ao New Relic.

AdicionarAtributoCustom

Adiciona informações contextuais sobre sua aplicação ao intervalo atual na forma de atributo.

Este método requer a versão do agente .NET e a API do agente .NET versão 8.25 ou superior.

Sintaxe

ISpan AddCustomAttribute(string key, object value)

Parâmetro

Parâmetro

Descrição

key

corda

Identifica as informações que estão sendo relatadas. Também conhecido como nome.

  • Chaves vazias não são suportadas.
  • As chaves são limitadas a 255 bytes. atributo com chaves maiores que 255 bytes será ignorado.

value

objeto

O valor que está sendo informado.

Note: null valores não serão registrados.

Tipo .NET

Como o valor será representado

byte, Int16, Int32, Int64

sbyte, UInt16, UInt32, UInt64

Como valor integral.

float, double, decimal

Um número baseado em decimal.

string

Uma string truncada após 255 bytes.

Strings vazias são suportadas.

bool

Verdadeiro ou falso.

DateTime

Uma representação de string seguindo o formato ISO-8601, incluindo informações de fuso horário:

Exemplo: 2020-02-13T11:31:19.5767650-08:00

TimeSpan

Um número decimal que representa o número de segundos.

todo o resto

O método ToString() será aplicado. Os tipos personalizados devem ter uma implementação de Object.ToString() ou gerarão uma exceção.

Devoluções

Uma referência ao intervalo atual.

Considerações de uso

Para obter detalhes sobre os tipos de dados suportados, consulte o guia de atributo personalizado.

Exemplos

IAgent agent = NewRelic.Api.Agent.NewRelic.GetAgent();
ISpan currentSpan = agent.CurrentSpan;
currentSpan
.AddCustomAttribute("customerName","Bob Smith")
.AddCustomAttribute("currentAge",31)
.AddCustomAttribute("birthday", new DateTime(2000, 02, 14))
.AddCustomAttribute("waitTime", TimeSpan.FromMilliseconds(93842));

Nome do conjunto

Altera o nome do segmento/span atual que será reportado ao New Relic. Para segmentos/extensões resultantes de instrumentação personalizada, o nome da métrica relatado à New Relic também será alterado.

Este método requer a versão do agente .NET e a API do agente .NET versão 10.1.0 ou mais alto.

Sintaxe

ISpan SetName(string name)

Parâmetro

Parâmetro

Descrição

name

corda

O novo nome do intervalo/segmento.

Devoluções

Uma referência ao intervalo atual.

Exemplos

[Trace]
public void MyTracedMethod()
{
IAgent agent = NewRelic.Api.Agent.NewRelic.GetAgent();
ISpan currentSpan = agent.CurrentSpan;
currentSpan.SetName("MyCustomName");
}
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.