APM Nudge Settings

On this page, you will find all the documentation you need to understand and correctly configure the Nudge APM settings found in the nudge-server.properties.

Grafana

tabInfraPosition

Default value : 6

It represents the position of the tab, at the Nudge HMI level, under which you want to display the INFRASTRUCTURE dashboard. Tab counting starts at 0.

tabUxPosition

Default value : 7

It represents the position of the tab, at the Nudge HMI level, under which you want to display the UX dashboard. Tab counting starts at 0.

tabSyntheticPosition{tabSyntheticPosition}

Default value : 8

It represents the position of the tab, at the Nudge HMI level, under which you want to display the SYNTHETIC dashboard. Tab counting starts at 0.

tabRumPosition

Default value : 9

It represents the position of the tab, at the Nudge HMI level, under which you want to display the RUM dashboard. Tab counting starts at 0.

tabLoadTestPosition

Default value : 10

It represents the position of the tab, at the Nudge HMI level, under which you want to display the LOADTEST or PERFORMER dashboard. Tab counting starts at 0.

number.nudge.tabs

Default value : 6

Corresponds in absolute terms to the number of tabs in the Nudge GUI that are not assigned to Grafana dashboard integration. These are the PCT95 Summary, Global View, Map, Transactions, Services, and Sessions tabs.

grafana.regex

Default value : ^.*atakama-technologies.com.*

Corresponds to the regular expression that the URLs must comply with, at the level of the GUI in the INTEGRATION section, to enable the display of Grafana dashboards.

grafana.domain.patterns

Default value : atakama-technologies.com

Nudge allows time slots to be synchronised between integrated Grafana dashboards and the GUI. This setting manages the URL patterns authorised to contact Nudge. For example: If Grafana dashboards that do not comply with grafana.domain.patterns are integrated, they can be displayed but without the benefit of time synchronisation.

SMTP

smtp.hostname

Default value : none

Corresponds to the name of the SMTP server you are using. For example, if it is a Gmail server, then we will have smtp.hostname=smtp.gmail.com.

smtp.auth.user

Default value : none

Corresponds to the sender’s email address. For example, smtp.auth.user=noreply@gmail.com.

smtp.auth.pwd

Default value : none

Corresponds to the login password associated with the email address entered in smtp.auth.user.

smtp.ssl

Default value : false

Defines the security mode enabled for access to the SMTP server.

smtp.port

Default value : no

Defines the connection port to the SMTP server.

Storage

storage.local.base

Default value : <home-directory>/.nudge

Folder in which the server stores files such as agent configuration and logs.

dir.nudge

Default value : <storage.local.base>/download/probe

Folder in which the raw data is stored.

probe.version

Default value : none

The server API allows you to download the agent jar(s) using the path get /install/java/{file}. To do this, the file must first be located in the folder specified in the dir.nudge property. Under these conditions, the above route will allow you to download the agent version specified in the URL from the dir.nudge folder, otherwise the version specified with the probe.version parameter will be downloaded.

storage.mode

Default value : local

Indicates the data storage mode, which can be local or s3. This parameter is used when configuring the Nudge server collector.

storage.local.rawdata

Default value : <storage.local.base>/rawdata

Allows you to specify the directory where raw data already processed by the collector is stored. This option is managed by the analyzer.keep_file_after_analysis parameter.

storage.local.work

Default value : <storage.local.base>/work

Indicates the directory where raw data awaiting processing by the collector is stored.

storage.local.upload

Default value : <storage.local.base>/upload

Indicates the folder or server where the configuration and log files sent by the Java agent are stored. Customers who wish to do so can configure the upload_config parameter (https://nudge-apm.com/config-probe-java_fr/#upload_config) in their Java agent to transfer and store their configuration in the specified directory. This is to enable our teams to access their configuration directly in the event of a problem.

Authentication

license.filename

Default value : /etc/nudge/PH_Atakama.lic

Indicates the location of the licence file provided by our teams.

auth.pass.min_length

Default value : 5

Indicates the minimum number of characters required for the password.

auth.pass.min_char_types

Default value : 1

Specifies the minimum number of different character types in a valid password. There are four categories of characters: uppercase letters, lowercase letters, numbers, and all other character types. For example, auth.pass.min_char_types=3 means that the password must contain at least three of the four defined character types to be valid.

Collector

instance.name

Default value : none

Specifies the name of the JMX instance.

instance.type

Default value : SAAS

Indicates the type of service used to deploy Nudge. There are two values: SAAS or on-premise. This information may appear in the mailing system configuration, for example.

instance.url

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

This is the server URL. In other words, the URL that allows you to access the login page in your browser.

service.url

Default value : valeur du paramètre instance.url

timout

Default value : 60

Timeout set for all read operations from the database (collector + other front-end and back-end services).

collector.fetch.timeout

Default value : valeur du paramètre timout

Timeout établi pour les opérations de lecture sur la BDD spécifiquement par le collecteur lors du traitement des rawdatas.

collector.url

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

Indique l’url du collecteur Nudge. Il est utilisé dans le cadre de la gestion des alertes pour tester l’état du collecteur Nudge.

collector

Default value : true

Autorise ou non le collecteur à recevoir et traiter des rawdatas. On a deux valeurs : true ou false.

thread.rawdata

Default value : true

Autorise ou non le collecteur à recevoir et traiter des rawdatas dans le cas ou le paramètre collector n’est pas renseigné. On a deux valeurs : true ou false.

thread.sla

Default value : true

Autorise ou non le suivi des alertes.

Cassandra

cassandra.nodes

Default value : none

URL de la BDD.

cassandra.port

Default value : 9042

Port d’accès à la BDD.

cassandra.dc

Default value : none

Nom du data center.

cassandra.replication.main

Default value : none

Facteur de réplication du keyspace main de la BDD.

cassandra.replication.temp

Default value : none

Facteur de réplication du keyspace temp de la BDD.

cassandra.socket.timeout

Default value : 12000

Délai de lecture en ms de toutes les requêtes vers la BDD.

cassandra.pooling.timeout

Default value : 5000

Délai de connexion en ms d’une session vers la BDD.

cassandra.pooling.requests

Default value : 1024

Le nombre maximum de requêtes simultanées vers la BDD.

cassandra.pooling.reconnect

Default value : 2500

Délai en ms de reconnexion à la BDD.

cassandra.pooling.chaining.threads

Default value : le nombre de processeurs disponibles pour la machine virtuelle Java

Le nombre de threads alloués aux requêtes exécutés en arrière-plan.

cassandra.policy.retry

Default value : DOWNGRADING

Définit la politique à mettre en œuvre en cas d’échec des requêtes CQL. On a plusieurs options :

cassandra.policy.remote_hosts

Default value : 0

Définit le nombre de nœuds distants vers lesquels les requêtes sont redirigées en cas d’indisponibilité du nœud local.

cassandra.query.fetch_size

Default value : 5000

Définit le nombre maximum de résultats (lignes) par page dans une réponse à une requête.

table.time_to_live

Default value : 7776000

Définit le temps de vie en secondes (Default_time_to_live) d’une enregistrement dans la BDD. Ces derniers enregistrements sont effacées automatiquement après le temps défini. Ce paramètre ne s’applique qu’à une liste restreinte de tables dans la BDD.

Analyseur

analyzer.threads

Default value : 1

Le nombre de theads applicatifs définis pour traiter les rawdatas pour chaque application. Exemple : si on a 10 applications et qu’on définit ce paramètre à 5. Cela veut dire que, dans un cas ou toutes les applications reçoivent des données en même temps, le collecteur ne pourra traiter que 5 applications à la fois. Noter que pour des raisons d’efficacité, ce paramètre doit être au moins égal au nombre d’applications. Aussi, en cas d’activation du analyzer.batchanalysis=true, le paramètre doit être au moins ègal à analyzer.batchanalysis.threads * nombre d’applications.

analyzer.batchanalysis

Default value : true

Permet de gérer l’activation du traitement parallelisé (multithreading) des rawadatas pour chaque application.

analyzer.batchanalysis.threads

Default value : 2

Nombre de threads applicatifs définis pour le traitement parallèlisé des rawdatas de chaque application.

analyzer.delay

Default value : 10

Définit le délai entre deux tentatives de récupération des rawdatas pour traitement par le collecteur. Autrement dit, par défaut, le collecteur cherche toutes les 10 secondes se de nouveaux rawdatas n’ont pas été envoyés par l’agent, pour les traiter ou les mettre dans la file d’attente.

analyzer.limit.filesize

Default value : 64_000_000

Taille en byte maximum admise pour un fichier rawdata pour être traité par le collecteur. Dans ce cas le fichier rawdata est converti en format avec l’extension .toobig et placé dans le dossier rawdata.

analyzer.limit.count

Default value : 500_000

Nombre maximum de fichiers rawdata que le collecteur peut traiter en une session.

analyzer.limitfiles

Default value : 5_000_000

Taille maximum en byte de tous les fichiers rawdata traité dans une session par le collecteur.

analyzer.dont_notify_after_millis

Default value : true

Définit en ms le temps l’intervalle de temps par rapport à l’instant t dans lequel doit subvenir une alerte pour que celle-ci soit prise en compte. La veleur par défaut -1 signifie qu’il n’y a aucune limite définie. Définissons pour exemple une valeur de 100 ms. Dans ce cas, toutes les alertes qui se sont produites dans l’intervalle instant t et instant t - 100 ms ne seront pas prises en compte.

analyzer.recycle_threadinfo

Default value : false

Définit si on recycle les informations de profilage des threads. Une valeur fausse améliore les performances mais réduit la qualité du profilage.

analyzer.fetch.timeout

Default value : 10

Définit le temps de suppression en ms des threads créés pour les différents types d’alertes.

analyzer.lock.timeout

Default value : 3

Temps en ms dédié pour l’analyse des alertes de chaque application.

Autres

email.sender

Default value : valeur du parmètre bill.email.sender

bill.email.sender

Default value : helpdesk@nudge.org

tab.service.timeout

Default value : 10000

Correspond au timeout de fetch des données sur l’onglet Services dans L’IHM.

administrators

Default value : none

Correspond à la liste des emails séparés par un “;” des utilisateurs avec le rôle admin. Ces derniers ont par exemple le droit d’update des mots de passe ou de se connecter par substitution à un autre utilisateur.