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

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Introdução à instrumentação personalizada do .NET

Para frameworks totalmente suportados (.NET framework | .NET Core), o agente New Relic .NET coleta e reporta automaticamente informações sobre transações da web e tarefas do browser. No entanto, se você estiver usando uma framework de aplicativo que não é instrumentada automaticamente (ou não está usando uma framework), você poderá ver grandes blocos de tempo na interface do usuário do New Relic sem detalhes ou poderá não ver nenhuma transação. Nesse caso, você pode usar instrumentação personalizada para adicionar transação e detalhes.

Este documento descreve como instrumentar atividades que não são instrumentadas pelo agente .NET por padrão. Para outras maneiras de configurar a instrumentação do seu aplicativo, consulte Guia para usar a API do agente .NET.

Importante

Para ambas as estruturas suportadas pelo agente (.NET framework e .NET Core), a instrumentação personalizada é feita da mesma maneira, salvo indicação em contrário.

Escolha um método de instrumentação personalizada

O agente .NET oferece suporte a dois métodos de instrumentação personalizada:

Método

Descrição

Atributo instrumentação personalizada

Instrumente seu código decorando seus métodos com um atributo. A instrumentação atributo é mais simples de implementar do que a instrumentação XML porque você só precisa adicionar um único decorador, no mesmo local do seu código que o método que você deseja instrumentar.

Para instruções, veja instrumentação personalizada via atributo.

Instrumentação XML personalizada

Instrumente seu código listando os métodos alvo em um arquivo XML. A instrumentação XML é mais complexa que a instrumentação atributo e falhará se você alterar o nome do assembly, classe ou método que deseja instrumentar. No entanto, a instrumentação XML não exige que você modifique o código-fonte.

Para obter instruções, consulte Criar transação via XML e Adicionar detalhes à transação via XML.

Criar transação vs. adicionar detalhes

Ao adicionar instrumentação personalizada por meio de qualquer método, você precisa escolher entre criar uma nova transação ou adicionar instrumentação a uma transação existente:

Situação

Recomendação

O método que você deseja usar não aparece na interface do New Relic

Create a new transaction. Para obter detalhes, consulte:

A transação aparece na interface do New Relic, mas contém seções de tempo não instrumentado

Add detail to an existing transaction. Para obter detalhes, consulte:

Classificar como "web" ou "não-web" (somente método de atributo)

APM separa transação em transação da web e transação fora da web na interface. Quando você adiciona detalhes a uma transação existente, sua categoria é determinada pela categoria da transação pai.

Ao criar uma transação via instrumentação personalizada utilizando o método de atributo, você deve categorizá-la como web ou non-web. (Isso não é possível com instrumentação XML; todas as transações criadas em XML são classificadas como non-web.)

Categoria

Quando usar

Rede

Use web para solicitações da web. Você só pode marcar novas transações como transações da web com instrumentação personalizada usando atributo e não usando XML.

Não-web

Use non-web para outros tipos de solicitações em segundo plano, como aplicativos e serviços de console.

Copyright © 2024 New Relic Inc.

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