DotNet agent configuration

This documents describes the configuration of .NET agent.
The agent gets its configuration from the file nudge.config that must be in the same directory as the agent executable.

The file nudge.config has an xml format with nudge-configuration as root element.

<nudge-configuration>
  <item1> ... </item1>
  <item2> ... </item2>
  ...
</nudge-configuration>`

Général

app_id

Mandatory: this identifier is the same as the correspondign app ID inside Nudge controller.

When downloading the agent from the application settings, you get a zip file containing the file nudge-agent.config inside which this parameter is already filled.
If you use this same file to monitor another application, you should change this parameter with the code of the other corresponding application.

server_url

Default value: https://collector.nudge-apm.com

Defines the controller URL.

tracer_host

Default value: localhost:8090

Defines how the agent should listen to Tracer data. At the moment, there is no similar configuration for the Tracer. So this parameter shouldn’t be changed.

handlers

Default value: http

Defines how the agent should export raw data. Available values are http and file.

Usage Disque

disk_dump_directory

Default value: executable location

Defines where data should be stored when handlers value is file.

Systeme

system_sample_enable

Default value : false

Enable or disable the system monitoring.

Network

proxy_host

Proxy server hostname or IP

proxy_port

Proxy server port

proxy_user

Proxy user, leave blank or omit parameter to bypass authentication.

proxy_password

Proxy password

Log

Log4net

Logging uses log4net library.

Example of configuration:

<log4net>
  <appender name="nudge" type="log4net.Appender.FileAppender">
    <file value="nudge-agent.log" />
    <appendToFile value="true" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="[%t] %level %d [%logger] - %m%n" />
    </layout>
  </appender>
  <root>
    <level value="WARN" />
    <appender-ref ref="nudge" />
  </root>
</log4net>