From 305765c0ad3b7fa42485e885a735a619a1854b31 Mon Sep 17 00:00:00 2001 From: Bertrand Mermet Date: Fri, 3 Nov 2017 13:35:14 +0100 Subject: [PATCH 1/2] Change instructions to reference agent 5.19.0 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7894eff76134..f5bf8e9e63f5 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ This repository contains what you need to trace C# applications. Some quick note ## Getting Started -Before instrumenting your code, [install the Datadog Agent](https://app.datadoghq.com/account/settings#agent) on your application servers (or locally, if you're just trying out C# APM) and enable the APM Agent. On Windows, the trace agent is not yet shipped together with the Datadog Agent so it must be installed separately, see [instructions](https://github.com/DataDog/datadog-trace-agent#run-on-windows). See special instructions for [Docker](https://github.com/DataDog/docker-dd-agent#tracing--apm) if you're using it. +Before instrumenting your code, [install the Datadog Agent](https://app.datadoghq.com/account/settings#agent) on your application servers (or locally, if you're just trying out C# APM) and enable the APM Agent. On Windows, the trace agent is shipped together with the Datadog Agent only since version 5.19.0, so users must update to 5.19.0 or above. See special instructions for [Docker](https://github.com/DataDog/docker-dd-agent#tracing--apm) if you're using it. ### Manual Instrumentation From 8084dd5b1ec497812c54aa0f468cf274b8b2f055 Mon Sep 17 00:00:00 2001 From: Bertrand Mermet Date: Fri, 3 Nov 2017 17:02:43 +0100 Subject: [PATCH 2/2] Add detailed info on running trace-agent on Windows --- README.md | 34 +++++++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f5bf8e9e63f5..6a341622eb6c 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,39 @@ This repository contains what you need to trace C# applications. Some quick note ## Getting Started -Before instrumenting your code, [install the Datadog Agent](https://app.datadoghq.com/account/settings#agent) on your application servers (or locally, if you're just trying out C# APM) and enable the APM Agent. On Windows, the trace agent is shipped together with the Datadog Agent only since version 5.19.0, so users must update to 5.19.0 or above. See special instructions for [Docker](https://github.com/DataDog/docker-dd-agent#tracing--apm) if you're using it. +Before instrumenting your code, [install the Datadog Agent](https://app.datadoghq.com/account/settings#agent) on your application servers (or locally, if you're just trying out C# APM) and enable the APM Agent. On Windows, please see the instructions below. See special instructions for [Docker](https://github.com/DataDog/docker-dd-agent#tracing--apm) if you're using it. + +### Windows + +On Windows, the trace agent is shipped together with the Datadog Agent only since version 5.19.0, so users must update to 5.19.0 or above. However the Windows trace agent is in beta and some manual steps are required. + +Update your config file to include: + +``` +[Main] +apm_enabled: yes +[trace.config] +log_file = C:\ProgramData\Datadog\logs\trace-agent.log +``` + +Restart the datadogagent service: + +``` +net stop datadogagent +net start datadogagent +``` + +For this beta the trace agent status and logs are not displayed in the Agent Manager GUI. + +To see the trace agent status either use the Service tab of the Task Manager or run: + +``` +sc.exe query datadog-trace-agent +``` + +And check that the status is "running". + +The logs are available at the path you configured in `trace.config` `log_file` above. ### Manual Instrumentation