O agente .NET da New Relic inclui uma API que permite estender a funcionalidade padrão do agente. Por exemplo, você pode usar a API do agente .NET para:
- Personalizando o nome do seu aplicativo
- Criando parâmetro de transação personalizado
- Relatando erros personalizados e métricas
Você também pode personalizar alguns dos comportamentos padrão do agente .NET ajustando as definições de configuração ou usando instrumentação personalizada.
Requisitos
Importante
A partir de setembro de 2021, um pequeno subconjunto de API, opções de configuração e opções de instalação para .NET será substituído por novos métodos. Para obter mais detalhes, incluindo como você pode se preparar facilmente para essa transição, consulte nossa postagem no Fórum de suporte.
Para usar a API do agente .NET:
Certifique-se de ter a versão mais recente do agente .NET.
Adicione uma referência ao agente no seu projeto:
Adicione uma referência a
NewRelic.Api.Agent.dll
ao seu projeto.OU
Visualize e baixe o pacote de API da biblioteca de pacotes NuGet.
Instrumento faltando seções do seu código com transação
Para instrumentar seu aplicativo, o New Relic separa cada caminho do seu código em sua própria transação. A New Relic utiliza (ou "instrumento") o método pai nessas transações para medir o desempenho geral do seu aplicativo e coleta o rastreamento da transação de transações de longa duração para obter detalhes adicionais.
Use estes métodos quando o New Relic não estiver instrumentado em uma parte específica do seu código:
Se você quiser... | Fazem isto... |
---|---|
Impedir que uma transação seja reportada à New Relic | Use |
Crie uma transação onde não existe nenhuma | Use atributo ou um arquivo XML para criar uma nova transação. |
Métodos específicos de tempo usando segmentos
Se uma transação já estiver visível na interface do New Relic, mas você não tiver dados suficientes sobre um método específico que foi chamado durante essa transação, você poderá criar segmentos para cronometrar esses métodos individuais com mais detalhes. Por exemplo, você pode querer cronometrar um método particularmente crítico com lógica complexa.
Quando desejar instrumentar um método dentro de uma transação existente, consulte instrumentação personalizada via atributo ou Adicionar detalhe às transações via XML.
Aprimore os metadados de uma transação
Às vezes, o código que você está direcionando fica visível na interface do New Relic, mas alguns detalhes do método não são úteis. Por exemplo:
- O nome padrão pode não ser útil. (Talvez esteja causando um problema de agrupamento métrico.)
- Você deseja adicionar um atributo personalizado à sua transação para poder filtrá-los no painel.
Use estes métodos quando quiser alterar a forma como o New Relic utiliza uma transação que já está visível na interface do New Relic:
Se você quiser... | Fazem isto... |
---|---|
Alterar o nome de uma transação | Use |
Evite que uma transação afete sua pontuação Apdex | Usar |
Adicione metadados (como o nome da conta do seu cliente ou nível de assinatura) à sua transação | Use atributo personalizado. Consulte |
Veja o registro relacionado
Para ver o log diretamente no contexto dos erros e rastreamento do seu aplicativo, use esta chamada de API para anotar seu log:
Para obter mais informações sobre como correlacionar dados log com outros dados de telemetria, consulte nossa documentação de logs contextualizados .
Trabalho assíncrono de instrumento
Para estruturas suportadas, o agente .NET geralmente detecta o trabalho assíncrono e o instrumenta corretamente. No entanto, se seu aplicativo usar outra framework ou se a instrumentação assíncrona padrão for imprecisa, você poderá conectar explicitamente o trabalho assíncrono.
Se você quiser... | Fazem isto... |
---|---|
Trace um método assíncrono que o New Relic já está instrumentado | Use um arquivo XML para instrumentar métodos assíncronos em aplicativos IIS. Para dicas de resolução de problemas, veja faltando métrica assíncrona. |
Trace um método assíncrono que New Relic não é instrumentado | Use um arquivo XML para instrumentar métodos assíncronos em aplicativos IIS. Para dicas de resolução de problemas, veja faltando métrica assíncrona. |
Ver chamadas para serviços externos
Para o agente .NET versão 8.9 ou superior, você pode usar a de distributed tracing carga útil API a seguir para passar manualmente distributed tracing o contexto entre os serviços de monitoramento do New Relic que não se conectam automaticamente entre si em um distributed trace.
Se você quiser... | Fazem isto... |
---|---|
Instrumento uma solicitação de saída para um aplicativo ou banco de dados externo | Adicione uma carga de distributed trace a uma solicitação de saída usando |
Conecte as solicitações recebidas ao originador da solicitação para concluir uma extensão do trace | Receba uma carga útil em uma solicitação recebida usando |
Para versões do agente .NET inferiores a 8.9, utilize o rastreamento multiaplicativo.
Colete ou erro ignorado
Normalmente, o agente .NET detecta erros automaticamente. No entanto, você pode marcar manualmente um erro com o agente. Você também pode errar ignorado .
Se você quiser... | Fazem isto... |
---|---|
Relatar um erro que o agente .NET não relata automaticamente | Usar |
Capture erros ou evite que o agente .NET relate um erro |
Envie dados de eventos personalizados e métricos do seu aplicativo
O APM inclui diversas maneiras de registrar dados personalizados arbitrários. Para obter uma explicação dos tipos de dados do New Relic, consulte Coleta de dados.
Se você quiser... | Fazem isto... |
---|---|
Envie dados sobre um evento para que você possa analisá-lo no painel | Crie um evento personalizado. Consulte |
Tag seu evento com metadados para filtrá-los e facetá-los no painel ou na análise de erros | Adicionar atributo personalizado. Consulte Atributo do agente .NET e Habilitar e desabilitar atributo. |
Relatar dados de desempenho personalizados | Use |
Controle o agente de monitoramento do Browser
Normalmente o agente é adicionado automaticamente às suas páginas ou implantado copiando/colando o trecho JavaScript. Para obter mais informações sobre esses métodos recomendados, consulte Adicionar aplicativos ao monitoramento do navegador.
No entanto, você também pode controlar o agente browser por meio da chamada de API do agente APM. Para mais informações, consulte monitoramento de Browser e agente .NET.