Jenkins

Configuration

To enable jobs monitoring, the Agent requires the credentials to access monitoring information. You can configure it in the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.jenkins:
  user: ''     #default is 'user'
  password: '' #default is 'user'

Metrics collection

Configuration data

Configuration Description
Node name The Jenkins node name.
Node description The Jenkins node description.
Port The Jenkins port.
Version The Jenkins version.
Start time The Jenkins start time.
Mode The Jenkins node mode (normal, exclusive).
Executors Number of executors.
Security mode Security mode enabled.
Total jobs The total number of monitored Jenkins jobs.
Job name The Jenkins job name.
Job type The Jenkins job type.

The list of Jenkins jobs is refreshed every 3 minutes.

Performance metrics

Using the Jenkins API, the performance metrics are returned from the /api/ endpoint. The performance metrics are collected every second for each job’s last build (up to 400 jobs).

Last build number

Number of the last build.

Data point: value is collected from the number key returned in the lastBuild object.

Last build status

Status of the last build (Failed, Success),

Data point: value is collected from the color key returned in the lastBuild object.

Last build duration

Duration of the last build.

Data point: value is collected from the duration key returned in the lastBuild object.

Last build estimated duration

Estimated duration for the last build.

Data point: value is collected from the estimatedDuration key returned in the lastBuild object.

Last build started at

Start time of the last build.

Data point: value is collected from the timestamp key returned in the lastBuild object.

Health score

Health status of recent builds (success percentage).

Data point: value is collected from the score key returned in the healthReport object.