Monitoring Jenkins
The Jenkins sensor is automatically deployed and installed after you install the Instana agent.
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
To view the metrics, select Infrastructure in the sidebar of the Instana User interface, click a specific monitored host, and then you can see a host dashboard with all the collected metrics and monitored processes.
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.