---
title: Instrumentation editor: Instrument .NET from UI
source: https://docs.newrelic.com/docs/instrumentation-editor-instrument-net-ui
---

> #### 💡 PREVIEW
>
> We're still working on this feature, but we'd love for you to try it out!
>
> If you have questions or feedback, or if you need help during the preview of the .NET agent's **Instrumentation** editor, send an email to [dotnet-li-editor-beta@newrelic.com](mailto:dotnet-li-editor-beta@newrelic.com).
>
> This feature is currently provided as part of a preview program pursuant to our [pre-release policies](https://docs.newrelic.com/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy).

Our **Instrumentation** editor allows .NET app users to implement custom instrumentation from the New Relic user interface without requiring a restart of the instrumented application. This editor:

-   Allows authorized users to edit custom instrumentation from the New Relic UI instead of the local XML files.
-   Validates against the custom instrumentation schema.
-   Provides an option for customers who do not have access to either the application code or hosts on which their applications execute.

## Requirements

To use the **Instrumentation** editor, you must meet the following requirements:

| **Requirements**                                                                                                  | **Comments**                                                                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent                                                                                                             | .NET agent version 7.0.2 or higher                                                                                                                                                                        |
| [Account role](https://docs.newrelic.com/docs/accounts-partnerships/accounts/roles-permissions/users-roles#roles) | Owner or Admin                                                                                                                                                                                            |
| Security                                                                                                          | Users of [high-security mode](https://docs.newrelic.com/docs/agents/manage-apm-agents/configuration/high-security-mode) cannot use the **Instrumentation** editor to update instrumentation of their app. |

## Define custom instrumentation [#defining]

![APM Settings: .NET instrumentation](https://docs.newrelic.com/images/apm_screenshot-full_dotnet-instrumentation-editor.webp "APM Settings: .NET instrumentation")

**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM & services > (select a .NET app) > Settings > Instrumentation:** The **Instrumentation** editor provides an easy way to view or edit your custom instrumentation in the UI. This XML example shows the assembly name, class name, and method name.

> #### ⚠️ IMPORTANT
>
> Deploying live instrumentation causes a brief period of higher overhead. This can noticeably slow application requests for several seconds.

To use the **Instrumentation** editor:

1.  Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM**. Find your app, then click **Settings > Instrumentation**.
2.  Use the **Instrumentation** editor to provide XML using the same syntax as described for [editing local .xml instrumentation files](https://docs.newrelic.com/docs/agents/net-agent/custom-instrumentation/create-transactions-xml-net) and [adding instrumentation detail.](https://docs.newrelic.com/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net) Use any of these options from the UI:

    -   Type in XML code directly.
    -   Copy the code and paste it in from a clipboard.
    -   Click **Download Sample XML** to create a sample instrumentation file as a starting point.
    -   Upload an .xml file by selecting **Choose file**. For an example, see [Example MyInstrumentation.xml](https://docs.newrelic.com/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#sample).
3.  The **Instrumentation** editor validates your XML code as you type. To perform XML validation outside of the editor, select **Download XSD**, and use the XSD file with your favorite XML validation tool to diagnose problems.
4.  To deploy the changes, select **Submit**.

## View instrumentation results [#view]

The .NET agent will begin the new instrumentation within a few [harvest cycles](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/getting-started/glossary#harvest-cycle) (typically a few minutes). The **Current instrumentation** section of the **Instrumentation** UI will show the status of applied changes.

The XML from the **Instrumentation** editor is combined with the XML that exists in the local instrumentation files on the machine running the agent. The agent periodically looks for changes in the final (combined) XML and picks them up dynamically, without requiring a restart of the agent or application.