Monitoring Jenkins health - Mini Project: Build & Apply

Monitoring Jenkins Health

📖 Scenario: You are a DevOps engineer responsible for ensuring the Jenkins server is running smoothly. Monitoring Jenkins health helps catch problems early and keeps your automation pipelines reliable.

🎯 Goal: Build a simple Jenkins pipeline script that checks the health of the Jenkins server by retrieving the system load and disk space usage, then prints a health summary.

📋 What You'll Learn

Create a Jenkins pipeline script with agent any

Add variables to store system load and disk space usage

Use Jenkins environment variables and shell commands to get health data

Print a clear health summary message

💡 Why This Matters

🌍 Real World

Monitoring Jenkins health helps prevent build failures and downtime by catching resource issues early.

💼 Career

DevOps engineers often write Jenkins pipelines to automate monitoring and alerting for CI/CD infrastructure.

1

Set up Jenkins pipeline skeleton

Create a Jenkins pipeline script starting with pipeline and agent any. Inside the stages block, add an empty stage named "Health Check".

Jenkins

pipeline {
    agent any
    stages {
        stage('Health Check') {
            steps {
                // Your code here
            }
        }
    }
}

Need a hint?

Start with the basic Jenkins pipeline structure using pipeline, agent any, and a stage named Health Check.

2

Add variables for system load and disk space

Inside the steps block of the Health Check stage, add two variables: systemLoad and diskSpace. Use the sh step with returnStdout: true to run the shell commands uptime for system load and df -h / for disk space, and assign their outputs to these variables.

Jenkins

pipeline {
    agent any
    stages {
        stage('Health Check') {
            steps {
                script {
                    // Your code here
                }
            }
        }
    }
}

Need a hint?

Use def to declare variables inside a script block. Use sh with returnStdout: true to capture command output.

3

Create health summary message

Still inside the script block, create a variable called healthSummary that combines the systemLoad and diskSpace variables into a single string message. Use a multi-line string with """ to format the message clearly.

Jenkins

pipeline {
    agent any
    stages {
        stage('Health Check') {
            steps {
                script {
                    def systemLoad = sh(script: 'uptime', returnStdout: true).trim()
                    def diskSpace = sh(script: 'df -h /', returnStdout: true).trim()
                    // Your code here
                }
            }
        }
    }
}

Need a hint?

Use triple quotes """ to create a multi-line string. Use ${variable} to insert variable values inside the string.

4

Print the health summary

Add a println statement inside the script block to print the healthSummary variable to the Jenkins console output.

Jenkins

pipeline {
    agent any
    stages {
        stage('Health Check') {
            steps {
                script {
                    def systemLoad = sh(script: 'uptime', returnStdout: true).trim()
                    def diskSpace = sh(script: 'df -h /', returnStdout: true).trim()
                    def healthSummary = """
Jenkins Health Summary:
System Load: ${systemLoad}
Disk Space Usage:
${diskSpace}
"""
                    // Print the health summary below
                }
            }
        }
    }
}

Need a hint?

Use println(healthSummary) to show the health summary in the Jenkins console output.