Logs in context for the .NET agent connects your logs and APM data in New Relic. Bringing all of this data together in a single tool helps you quickly get to the root cause of an issue and find the log lines that you need to identify and resolve a problem.
To enable logs in context for APM apps monitored by .NET:
- Make sure you have already set up logging in New Relic. This includes configuring a supported log forwarder that collects your application logs and extends the metadata that is forwarded to New Relic.
- Install or update to the latest .NET agent version, and enable distributed tracing. Use .NET agent version 8.21 or higher and the New Relic .NET agent API version 8.21 or higher for logs in context.
- Install or update to Microsoft .NET Framework 4.5 or higher or .NET Core 2.0 or higher.
- Install and configure any of the following logging extensions to enrich your log data, including:
- Check your log data in the New Relic UI.
You can use the Apache log4net version 2.0.8 or higher extension to link your log data with related data across the rest of the New Relic platform.
You can use our NLog 4.5 or higher extension to link to your log data with related data across the rest of the New Relic platform.
You can use our Serilog extension to link to your log data with related data across the rest of the New Relic platform. This requires:
To verify that you have configured the log appender correctly, run your application, then check your logs data in New Relic One using the query operator
If everything is configured correctly and your data is being forwarded to New Relic with the enriched metadata, your logs should now be emitted as JSON and contain
span.id fields. If you don't see log data in the UI, follow the troubleshooting procedures.
After you set up APM logs in context, make the most of your logging data:
- Explore the logging data across your platform with our Logs UI.
- See your logs in context of your app's performance in the APM UI. Troubleshoot errors with distributed tracing, stack traces, application logs, and more.
- Get deeper visibility into both your application and your platform performance data by forwarding your logs with our infrastructure monitoring agent. Review your infrastructure logs in the UI.
- Set up alerts.
- Query your data and create dashboards.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.