Paramètres Nudge APM

Vous trouverez dans cette page toute la documentation nécessaires pour comprendre et configurer correctement les paramètres de Nudge APM qui se trouvent dans le fichier nudge-server.properties.

Grafana

tabInfraPosition

Valeur par défaut : 6

Il représente la position du tab, au niveau de l’IHM Nudge, sous lequel on souhaite afficher le dashboard INFRASTRUCUTRE. Le comptage des tab commence par 0.

tabUxPosition

Valeur par défaut : 7

Il représente la position du tab, au niveau de l’IHM Nudge, sous lequel on souhaite afficher le dashboard UX. Le comptage des tab commence par 0.

tabSyntheticPosition{tabSyntheticPosition}

Valeur par défaut : 8

Il représente la position du tab, au niveau de l’IHM Nudge, sous lequel on souhaite afficher le dashboard SYNTHETIC. Le comptage des tab commence par 0.

tabRumPosition

Valeur par défaut : 9

Il représente la position du tab, au niveau de l’IHM Nudge, sous lequel on souhaite afficher le dashboard RUM. Le comptage des tab commence par 0.

tabLoadTestPosition

Valeur par défaut : 10

Il représente la position du tab, au niveau de l’IHM Nudge, sous lequel on souhaite afficher le dashboard LOADTEST ou PERFORMER. Le comptage des tab commence par 0.

number.nudge.tabs

Valeur par défaut : 6

Correspond en valeur absolue au nombre de tab, dans l’IHM Nudge, non affectés à l’intégration des dashboard Grafana. Il s’agit des tab Synthèse PCT95, Vue globale, Map, Transactions, Services, Sessions.

grafana.regex

Valeur par défaut : ^.*atakama-technologies.com.*

Correspond à l’expression régulière que doivent respecter les urls renseigner, au niveau de l’IHM dans la partie INTEGRATION, pour activer l’affcichage des dashboards Grafana

grafana.domain.patterns

Valeur par défaut : atakama-technologies.com

Nudge permet une synchronisation des plages horaires entre les dashboards intégrés Grafana et l’IHM. Ce paramètre gérer les patterns d’url autorisé à contacter Nudge. Par exemple : Si on intègre des dashboards Grafana qui ne respectent pas le grafana.domain.patterns, on pourra les afficher mais sans bénéficier de la synchronisation horaire.

SMTP

smtp.hostname

Valeur par défaut : none

Correspond au nom du serveur SMTP que vous utilisez. Par exemple si c’est un serveur gmail, alors on aura smtp.hostname=smtp.gmail.com.

smtp.auth.user

Valeur par défaut : none

Correspond à l’email expéditeur. Par exemple smtp.auth.user=noreply@gmail.com.

smtp.auth.pwd

Valeur par défaut : none

Correspond au mot de passe de connexion associé à l’email renseigné dans smtp.auth.user.

smtp.ssl

Valeur par défaut : false

Définit le mode de sécurité activé pour l’accès au serveur smtp.

smtp.port

Valeur par défaut : no

Définit le port de connexion au serveur smtp.

Stockage

storage.local.base

Valeur par défaut : <home-directory>/.nudge

Dossier dans lequel Le serveur enregistre les fichiers créés comme la configuration et les logs de l’agent par exemple.

dir.nudge

Valeur par défaut : <storage.local.base>/download/probe

Dossier dans lequel les rawdatas sont stockés.

probe.version

Valeur par défaut : none

L’API du serveur permet, en utilisant le chemin get /install/java/{file}, de télécharger le(s) jar(s) de l’agent. Pour ce faire, il faut préalablement que ce fichier se trouve dans le dossier indiqué sur la propriété dir.nudge. Dans ces conditions, la route mentionnée ci-dessus permettra de télécharger, à partir du dossier dir.nudge, la version de l’agent qu’on aura spécifié dans l’url sinon celle spécifiée avec le paramètre probe.version.

storage.mode

Valeur par défaut : local

Indique le mode de stockage des données qui peut être local ou s3. Ce paramètre est utilisé lors de la configuration du collecteur du serveur Nudge.

storage.local.rawdata

Valeur par défaut : <storage.local.base>/rawdata

Permet d’indiquer le répertoire dans lequel sont stockés les rawdatas déjà traités par le collecteur. Cette option est gérée par le paramètre analyzer.keep_file_after_analysis.

storage.local.work

Valeur par défaut : <storage.local.base>/work

Indique le répertoire dans lequel sont stockés les rawdatas en attente de traitement par le collecteur.

storage.local.upload

Valeur par défaut : <storage.local.base>/upload

Indique le dossier ou le serveur stocke les fichiers de configuration et de logs envoyés par l’agent java. En effet, les clients qui le souhaitent, peuvent configurer au niveau de leur agent java le paramètre upload_config (https://nudge-apm.com/config-probe-java_fr/#upload_config) pour transférer et stocker leur configuration vers le répertoire indiqué. Ceci dans le but de mieux permettre à nos équipes d’accéder directement à leur configuration en cas de problème

Authentification

license.filename

Valeur par défaut : /etc/nudge/PH_Atakama.lic

Indique l’emplacement di fichier de licence qui est fourni par nos équipes.

auth.pass.min_length

Valeur par défaut : 5

Indique le nombre minimum de caractères imposés pour le mot de passe.

auth.pass.min_char_types

Valeur par défaut : 1

Indique le nombre minimum de types de caractère différents dans un mot de passe valide. On a 4 catégories de types : les majuscules, les minuscules, les chiffres et tous les autres types de caractère. Par exemple auth.pass.min_char_types=3 signifie que le mot de passe devra au moins contenir 3 des 4 types de caractère définis pour être valide.

Collecteur

instance.name

Valeur par défaut : none

Indique le nom de l’instance JMX.

instance.type

Valeur par défaut : SAAS

Indique le type de service utilisé pour déployer Nudge. On a deux valeur SAAS ou on-premise. Cette information peut apparaitre dans la configuration du système de mailing par exemple.

instance.url

Valeur par défaut : https://www.nudge-apm.com

C’est l’url du serveur. Entrement dit, l’url qui permet d’accéder à la page de connexion sur le navigateur.

service.url

Valeur par défaut : valeur du paramètre instance.url

timout

Valeur par défaut : 60

Timeout établi pour toutes les opérations de lecture depuis la BDD (collecteur + autres services front et back).

collector.fetch.timeout

Valeur par défaut : 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

Valeur par défaut : 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

Valeur par défaut : true

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

thread.rawdata

Valeur par défaut : 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

Valeur par défaut : true

Autorise ou non le suivi des alertes.

Cassandra

cassandra.nodes

Valeur par défaut : none

URL de la BDD.

cassandra.port

Valeur par défaut : 9042

Port d’accès à la BDD.

cassandra.dc

Valeur par défaut : none

Nom du data center.

cassandra.replication.main

Valeur par défaut : none

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

cassandra.replication.temp

Valeur par défaut : none

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

cassandra.socket.timeout

Valeur par défaut : 12000

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

cassandra.pooling.timeout

Valeur par défaut : 5000

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

cassandra.pooling.requests

Valeur par défaut : 1024

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

cassandra.pooling.reconnect

Valeur par défaut : 2500

Délai en ms de reconnexion à la BDD.

cassandra.pooling.chaining.threads

Valeur par défaut : 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

Valeur par défaut : DOWNGRADING

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

cassandra.policy.remote_hosts

Valeur par défaut : 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

Valeur par défaut : 5000

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

table.time_to_live

Valeur par défaut : 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

Valeur par défaut : 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

Valeur par défaut : true

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

analyzer.batchanalysis.threads

Valeur par défaut : 2

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

analyzer.delay

Valeur par défaut : 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

Valeur par défaut : 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

Valeur par défaut : 500_000

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

analyzer.limitfiles

Valeur par défaut : 5_000_000

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

analyzer.dont_notify_after_millis

Valeur par défaut : 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

Valeur par défaut : 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

Valeur par défaut : 10

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

analyzer.lock.timeout

Valeur par défaut : 3

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

Autres

email.sender

Valeur par défaut : valeur du parmètre bill.email.sender

bill.email.sender

Valeur par défaut : helpdesk@nudge.org

tab.service.timeout

Valeur par défaut : 10000

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

administrators

Valeur par défaut : 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.