DotNet agent configuration

This documents describes the configuration of the .NET agent.\

Global parameters

In the nudgehttp section

endpoint

Address for sending data to Nudge.

Example : https://apm.atakama-technologies.com/

pathCollect

Collection path.

Default value: collect/rawdata

method

HTTP request method.

Default value: PUT

encoding

Default value: proto (application/x-protobuf)

correlation_cache

This parameter is used to enable the correlation cache for the ULS receiver for SharePoint.

Default value: true

recordCollecte

Recording of rawdata to disk: OnError = only if the rawdata could not be sent; None = no recording even if the rawdata could not be sent.

Default value: OnError

Application Configuration

To add a new application to instrument, add the configuration block below.

Replace :

  attributes/<application_name>:
    actions:
      - action: insert
        key: nudge_application_id
        value: <app_id>
    include:
      match_type: strict
      resources:
        - key: service.name
          value: <service_name>
        - key: telemetry.sdk.language
          value: dotnet

  transform/<application_name>:
    error_mode: ignore
    metric_statements:
      - context: datapoint
        statements:
          - set(attributes["nudge_application_id"], "<app_id>")
            where resource.attributes["service.name"] == <service_name>" and resource.attributes["telemetry.sdk.language"] == "dotnet"

Replace <application_name> (defined above) in the following “service” section :

service:
  pipelines:
    # Logs pipeline
    # Le pipeline logs (exceptions, errors ...) permet de traiter les logs envoyés par les applications.
    logs:
      receivers: [otlpnudge] #, uls]
      processors: [memory_limiter, insert_schema, attributes/<application_name>, logs_traces_merge, schema, batch]
      exporters: [nudgehttp] #, nudgedebug]

    # Traces pipeline
    # Le pipeline traces permet de traiter les traces HTTP, SQL, CQL ... envoyées par les applications.
    traces:
      receivers: [otlpnudge]
      processors: [memory_limiter, insert_schema, attributes/<application_name>, logs_traces_merge, schema, batch]
      exporters: [nudgehttp] #, nudgedebug]

    # Metrics pipeline
    # Le pipeline metrics permet de traiter les métriques disques, cpus, memoire ... envoyées par les applications.
    metrics:
      receivers: [otlpnudge]
      processors: [memory_limiter, insert_schema, transform/javaapp, transform/dotnetapp, attributes/<application_name>, schema, batch]
      exporters: [nudgehttp] #, nudgedebug]

Logs (console)

In the console section

enabled

Default value: true

level

Default value: Warn

Logs (file)

In the file section

enabled

Default value: true

max_size

Default value: 10

max_backups

Default value: 5

max_age

Default value: 1

compress

Default value: false

level

Default value: Warn

SharePoint ULS

In the uls section

include - uls log path

In the include section

Default value: %ProgramFiles%\Common Files\Microsoft Shared\Web Server Extensions\16\Logs\

Don’t forget to uncomment the last line of the logs section to enable the ULS receiver:

logs:
      receivers: [otlpnudge] #, uls]