PHP agent configuration

Introduction

Those parameters are defined in the config.cfg file and logger.properties which are part of the Nudge-PHP bundle.

This bundle is available on the Atakama support :

Download Nudge-PHP Bundle

Once the bundle is downloaded and unzipped, you will find both files in the agent/vx.x.x/conf folder.

Global parameters

Those parameters are defined in the /etc/nudge/config.cfg file.

agent_port

Type Integer
Default value 1025

Port used by the agent to communicate with Nudge PHP extensions.

offline

Type Integer
Default value 0

Write the collected data on disk with valued setted to 1.
With the 0 value, the data are sent to the Nudge APM collector defined with url parameter.

offline_log_dir

Type String (surrounded by quotes)
Default value “/tmp/nudge/offline/”

Folder path for the logging files. Only active if offligne param equals 1.

port

Type String
Default value : 443

Listening port of Nudge APM service.
Should not be changed in SaaS service, otherwise for on premise service is at your convenience.

protocol

Type String (surrounded by quotes)
Default value : “https”

Used protocol for establishing a connection to Nudge APM service.

url

Type String (surrounded by quotes)
Default value : “collector.nudge-apm.com”

Hostname to Nudge APM service.
Should not be changed for a SaaS, and must be configured for on premise use.

service

Type String (surrounded by quotes)
Default value : “/collect/rawdata/”

URL path of Nudge APM collect. Should not be changed.

Proxy

proxy_host

Type String (surrounded by quotes)
Default value [none]

URL of your proxy.

proxy_port

Type Integer
Default value 8080

Port of your proxy.

proxy_user

Type String (surrounded by quotes)
Default value [none]

Username for a HTTP Basic authentication.

proxy_password

Type String (surrounded by quotes)
Default value [none]

Password for a HTTP Basic authentication.

SSL/TLS

The following parameters are useful for configuring your access to the Nudge APM, especially if you are facing SSL validation problem.

ssl_tls_ca_bundle

Type String (surrounded by quotes)
Default value [none]

Path to the SSL/TLS certfication chain bundle, for example :

ssl_tls_insecure

Type Integer
Default value 0

Deactivate the chain certificate validation with a value to 1. Only for a testing purpose !

Logging

The etc/nudge/logger.properties file handle the logging configuration for the Agent.

log4cpp.appender.nudge-rfa.fileName

Type String
Default value /var/log/nudge/nudge-agent.log

Path to the agent logging file.

log4cpp.appender.nudge-rfa.maxFileSize

Type Integer
Default value 50000000 (= 50Mo)

Maximum sized of logging file.

log4cpp.appender.nudge-rfa.maxBackupIndex

Type Integer
Default value 5

Maximum rotation number of logging files.