Configuration de l'agent Dotnet

Paramètres généraux

Section nudgehttp

endpoint

Addresse pour l’envoi des données vers Nudge.

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

pathCollect

Chemin de collecte.

Valeur par défaut : collect/rawdata

method

Méthode de requête HTTP.

Valeur par défaut : PUT

encoding

Valeur par défaut : proto (application/x-protobuf)

correlation_cache

Ce paramètre est utilisé pour l’utilisation du cache de corrélation pour le receiver ULS pour Sharepoint.

Valeur par défaut : true

recordCollecte

Enregistrement du rawdata brut sur disque: OnError = uniquement si le rawadata n’a pas pu être envoyé, None = aucun enregistrement même si le rawdata n’a pas pu être envoyé.

Valeur par défaut : OnError

Configuration de l’application

Pour ajouter une nouvelle application à instrumenter, ajouter le bloc de configuration plus bas.

Remplacer :

• <application_name> : à définir librement
• <app_id> : UUID de l’application sur Nudge
• <service_name> : doit correspondre au service_name fournit lors de l’utilisation de la commande Register-OpenTelemetryForIIS -OTelServiceName <service_name> lors de l’installation

  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"

Remplacer le <application_name> (définit précedemment) dans la section “service” suivante :

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)

Section console

actif

Valeur par défaut : true

level

Valeur par défaut : Warn

Logs (file)

Section file

actif

Valeur par défaut : true

max_size

Valeur par défaut : 10

max_backups

Valeur par défaut : 5

max_age

Valeur par défaut : 1

compress

Valeur par défaut : false

level

Valeur par défaut : Warn

Sharepoint ULS

Section uls

include - uls log path

Section include

Valeur par défaut : %ProgramFiles%\Common Files\Microsoft Shared\Web Server Extensions\16\Logs\

Ne pas oublier de décommenter la fin de ligne de la sections logs pour faire fonctionner le receiver ULS :

logs:
      receivers: [otlpnudge] #, uls]