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.
|