Configuration de l'extension PHP

• Introduction
• Paramètres généraux
  • extension
  • nudge.apps
  • nudge.agent_address
  • nudge.agent_port
• Paramètres de log
  • nudge.log_level
  • nudge.log_filepath
• Traces de fonctions
  • nudge.trace_functions

Introduction

Ces paramètres sont définis dans le fichier nudge.ini qui est intégré dans le bundle Nudge-PHP.

Pour récupérer ce bundle, connectez vous sur le support Atakama :

Accès à la page de téléchargement du bundle Nudge-PHP

Une fois le bundle téléchargé et décompressé, vous y trouverez le fichier dans le dossier extension/vx.x.x/conf.

Paramètres généraux

extension

Type	String
Valeur par défaut	[aucun]
Obligatoire	Oui

Chemin du fichier d’extension PHP de Nudge APM.

nudge.apps

Type	String
Valeur par défaut	[aucun]
Obligatoire	Oui
Format du paramètre	répertoire:clé-nudge-de-votre-application

Attribution d’une clé d’application de Nudge APM à un de vos répertoires servis par Apache.
Vous pouvez définir plusieurs répertoires monitorés, les couples clé-répertoire doivent séparés par une virgule.

La clé de l’application peut être récupéré dans les paramètres de votre application sur Nudge APM.

Voici quelques exemples pour déclarer des répertoires à monitorer :

• Exemple 1 - un seul répertoire monitoré :
  nudge.apps=/var/www/:00000000-0000-0000-0000-000000000000
• Exemple 2 - deux répertoires monitorés :
  nudge.apps=/var/www/appli1:00000000-0000-0000-0000-000000000001,/var/www/appli2:00000000-0000-0000-0000-000000000002

nudge.agent_address

Type	String
Valeur par défaut	127.0.0.1
Obligatoire	Non

Nom de domaine ou adresse IP de votre Agent Nudge APM.

nudge.agent_port

Type	String
Valeur par défaut	1025
Obligatoire	Non

Port d’écoute de l’agent Nudge APM.

Paramètres de log

nudge.log_level

Type	String
Valeur par défault	error
Obligatoire	Non

Niveau d’affichage des messages de journalisation.
Valeurs possibles :

• debug
• debugtimer
• infotimer
• info
• warn
• error
• none

nudge.log_filepath

Type	String
Valeur par défaut	/var/log/nudge/nudge-extension.log
Obligatoire	Non

Chemin du fichier de journalisation de l’extension.

Traces de fonctions

nudge.trace_functions

Type	String
Valeur par défaut	[aucun]
Obligatoire	Non
Format du paramètre	{class_name}:{function_name}.{layer}.{function_param}

Avec ce paramètre vous pouvez instrumenter des classes et des fonctions spécifiques de votre code, et les regrouper dans Nudge sous une couche dédiée (SQL, WS, Elasticsearch, REST, RabbitMQ, business layer, …).

Le format répond aux arguments suivants :

• class_name (optionnel) : nom complet de la classe avec son namespace. Attention, la classe et la fonction doivent être séparées par :.
• function_name (obligatoire) : nom de la fonction à observer
• layer (obligatoire) : couche [sql|ws] ou une couche définit par l’utilisateur
• function_param (optionnel) : numéro du paramètres de la fonction à utiliser comme nom de la transaction, doit commencer par #

Voici un exemple avec une fonction appelée sayHello, d’une classe Hello et qui sera représentée dans Nudge sous une couche nommée user : nudge.trace_functions=AppBundle\Utils\Hello:sayHello.user

Pour spécifier plusieurs fonctions à analyser, utiliser le séparateur , :
nudge.trace_functions=functionOne.user,functionTwo.user