Fixes

Author: daniel-romano-DD

content/en/security/application_security/setup/dotnet/linux.md

@@ -41,9 +41,11 @@ Install the Datadog Agent by following the [setup instructions for Linux hosts][
 {{< tabs >}}
 {{% tab "AMD 64 Platforms" %}}
 
-Download the latest [.NET Tracer package][3] that supports your operating system and architecture.
+Download the latest [Datadog .NET Tracer package][3] that supports your operating system and architecture.
 
-**Note on version**: replace <TRACER_VERSION> with the latest three component version of the library (ej: 3.21.0)
+<div class="alert alert-warning">
+  *Note on version:* replace *<TRACER_VERSION>* with the latest three component version of the library (ej: 3.21.0)
+</div>
 
 ```bash
 wget -O datadog-dotnet-apm-<TRACER_VERSION>.tar.gz 'https://github.com/DataDog/dd-trace-dotnet/releases/download/v<TRACER_VERSION>'
@@ -74,6 +76,12 @@ sudo tar -C /opt/datadog -xzf datadog-dotnet-apm-<TRACER_VERSION>.arm64.tar.gz &
 {{% /tab %}}
 {{< /tabs >}}
 
+<div class="alert alert-warning">
+  If you are having issues installing the Tracer library check the [Tracer Installation guide][5]
+  *Note on version:* replace *<TRACER_VERSION>* with the latest three component version of the library (ej: 3.21.0)
+</div>
+
+
 {{% collapse-content title="APM Tracing Enabled" level="h4" %}}
 Set the required environment variables and start your .NET application:
 
@@ -121,3 +129,4 @@ If you encounter issues while setting up App and API Protection for your Java ap
 [2]: /agent/?tab=Linux
 [3]: https://github.com/DataDog/dd-trace-dotnet/releases
 [4]: /security/application_security/setup/dotnet/troubleshooting
+[5]: /tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core/?tab=linux

content/en/security/application_security/setup/dotnet/troubleshooting.md

@@ -0,0 +1,46 @@
+---
+title: Troubleshooting .NET App and API Protection
+---
+
+## Common Issues
+
+### No security signals appearing
+
+1. Verify Agent version:
+   - Ensure you're running Datadog Agent v7.41.1 or higher.
+   - Check Agent status: `datadog-agent status`.
+2. Check .NET tracer version:
+   - Confirm you're using .NET tracer v2.42.0 or higher.
+3. Verify environment variables:
+   - Ensure `DD_APPSEC_ENABLED=true` is set.
+   - Check `DD_SERVICE` and `DD_ENV` are properly configured.
+   - Verify `DD_APM_ENABLED=true` if using APM features.
+4. Check file system permissions:
+   - Ensure the application has write access to `/tmp`.
+   - Verify the Java agent JAR is readable.
+
+### Application fails to start
+
+1. Check logs for errors:
+   - Logs are located at `/var/log/datadog/dotnet/`
+
+### Performance impact
+
+1. High latency:
+   - Check Agent resource usage.
+   - Verify network connectivity between Agent and Datadog.
+   - Consider adjusting sampling rates.
+2. High memory usage:
+   - Monitor memory usage.
+   - Adjust Agent resource limits if needed
+
+### Still having issues?
+
+If you're still experiencing problems:
+1. Check the [Application Security Monitoring troubleshooting guide][1]
+2. Review the [Java tracer documentation][2]
+3. Contact [Datadog support][3]
+
+[1]: /security/application_security/troubleshooting
+[2]: /tracing/trace_collection/compatibility/dotnet
+[3]: /help