Skip to main content
Sumo Logic

Install the Jenkins App and view the Dashboards

This page provides instructions for installing the Sumo Logic App for Jenkins, as well as examples and descriptions for each of the app dashboards.

Install the App

Now that you have set up log and metric collection for Amazon Aurora MySQL, you can install the Sumo Logic App for Aurora MySQL ULM, and use its pre-configured searches and dashboards.

To install the app, do the following:

Locate and install the app you need from the App Catalog. If you want to see a preview of the dashboards included with the app before installing, click Preview Dashboards.

  1. From the App Catalog, search for and select the app. 
  2. To install the app, click Add to Library and complete the following fields.
    1. App Name. You can retain the existing name, or enter a name of your choice for the app.

    2. Data Source. Select either of these options for the data source.

      • Choose Source Category, and select a source category from the list.

      • Choose Enter a Custom Data Filter, and enter a custom source category beginning with an underscore. Example: (_sourceCategory=MyCategory).

    3. Advanced. Select the Location in Library (the default is the Personal folder in the library), or click New Folder to add a new folder.
  3. Click Add to Library.

Once an app is installed, it will appear in your Personal folder, or other folder that you specified. From here, you can share it with your organization. 

Panels will start to fill automatically. It's important to note that each panel slowly fills with data matching the time range query and received since the panel was created. Results won't immediately be available, but with a bit of time, you'll see full graphs and maps. 

Dashboard filters

Each dashboard has a set of filters that you can apply to the entire dashboard, as shown in the following example. Click the funnel icon in the top dashboard menu bar to display a scrollable list of filters that are applied across the entire dashboard.

Jenkins_Dashboard_filter.png

Each panel has a set of filters that are applied to the results for that panel only, as shown in the following example. Click the funnel icon in the top panel menu bar to display a list of panel-specific filters.

Jenkins_Panel_filter.png

Jenkins - Overview

The Jenkins - Overview dashboard shows relationships between jobs and executors (worker nodes) on a Jenkins master. This dashboard provides insights into job run durations, status, physical memory, disk memory, and unused machines.

Use this dashboard to:

  • Correlate job builds with Jenkins executors (worker nodes), physical memory utilization, disk space utilization, console logs, the number of executors used by jobs, and the number of unused (free) worker nodes.
  • Identify worker nodes not used by Jenkins master jobs to understand worker node usage.
  • Analyze job health by filtering data for a specific job to identify the console log errors, system errors, number of executors used, disk space utilization, physical memory utilization.
  • Identify Jenkins master shutdown events.
  • Analyze the jobs in the queue with job queue duration, reason, job URL.
  • Generate alerts based on shutdown events, job run duration, physical memory utilization, disk space utilization, and more. 

Jenkins_Overview.png

System Monitoring Dashboards

System Monitoring Dashboards provide information on system activities related to master node metrics, job metrics, worker nodes, and audit activities. System Monitoring dashboards help you to monitor changes related to the Jenkins configuration, job configuration, the health of the Jenkins master, performance of the job queue and run duration, as well as the health of all worker nodes available to the Jenkins master node.

Jenkins - Audit Dashboard

The Jenkins - Audit dashboard provides insight into user events, including configuration changes, authentication events, and job activities.

Use this dashboard to:

  • Ensure only authorized users are accessing the Jenkins System and are modifying Jenkins system and job configurations
  • Keep track of the job configuration changes
  • Compare old and new Jenkins system and job configuration settings
  • View trends for Jenkins job start and finish events

Jenkins_Audit.png

Jenkins - Master Health Dashboard

The Jenkins - Master Health dashboard provides insight into the health of Jenkins master nodes with information on shutdown events, Jenkins system logs, and metrics events such as CPU, memory, job duration,  threads, and executors.

Executors are similar to threads that run jobs, so they are indicators of the load placed on Jenkins. If the executors are full, it means there are a lot of jobs running on the system and more executors may be needed to balance the load.

Use this dashboard to:

  • Monitor shutdown events for Jenkins master nodes
  • Monitor Jenkins system sogs to determine the root cause of system issues
  • Monitor Jenkins master CPU usage and memory usage to allocate additional resources if neededMonitor free executors and busy executors on Jenkins master

Jenkins_Master_Health.png

Jenkins - Job Health Dashboard

The Jenkins - Job Health dashboard provides insight into the health of Jenkins jobs across various master nodes with information on job counts, job run duration, queue information, and garbage collection metrics.

Use this dashboard to:

  • Monitor jobs in the queue, blocked and pending jobs to make sure your continuous integrations are running as expected 
  • Monitor garbage collection statistics  on the Jenkins master to understand how to improve performance and allocate additional resources if necessary 

Jenkins_Job_Health.png

Jenkins - Node Health Dashboard

The Jenkins - Node Health dashboard provides insights into the health of all Jenkins master and worker nodes, with information on node details, recent builds, resource consumption, and node events.

Use this dashboard to:

  • Monitor the health of all Jenkins nodes to understand and resolve potential bottlenecks
  • Monitor  node resource utilization and resize if necessary
  • Monitor removed nodes and node offline and launch failure events to ensure intended operations are being performed

Jenkins_Node_Health.png

Job Monitoring Dashboards

Job Monitoring Dashboards provide information on job activities like job run duration, job status, test results, pipeline stages and console Logs. Job monitoring dashboards help you monitor job duration, status, failed jobs and test cases. You can determine stack trace failures, failed stages details, source control management details, job configuration changes, and stage wise console logs.

Jenkins - Job Overview Dashboard

The Jenkins - Job Overview dashboard provides a high-level view of job and build status, trends, comparisons, and results.

Use this dashboard to:

  • Monitor the total number of builds, successful and failed builds.
  • Monitor recent builds and view detailed information in  the Jenkins console 
  • Monitor  job duration trends to understand how to improve the execution of various stages in the pipeline
  • Monitor  jobs in progress, and in queue to determine how the pipelines are performing and make adjustments to the build process if needed 
  • Identify the slowest failed builds
  • View trends for job results and use that information to identify source code components and teams that need the most improvements

Jenkins_Job_Overview.png

Jenkins - Job Information Dashboard

The Jenkins - Job Information dashboard provides detailed information about a specific job. Panels show information on job URLs, duration trends, execution results, test case trends, slowest stages for pipeline jobs, console logs, and common errors.

To use this dashboard, in the dashboard filters, enter in the master node name and the job name as shown in the following example.

Jenkins_Job_Information_filters.png

Use this dashboard to:

  • Monitor the total number of builds, successful builds, duration and failed builds for the job in question to understand how to best improve its execution going forward
  •  Drilldown to Jenkins build information as needed
  • Investigate common errors using console logs
  • Investigate common stage failures
  • Monitor recent configuration changes and commits to identify potential causes of failure

Jenkins_Job_Information.png

Jenkins - Build Information Dashboard

The Jenkins - Build Information dashboard provides detailed information about a specific build. Panels show information on build parameters, source control management, commit details, test cases, pipeline stages, console logs, and configuration changes prior to a build.

To use this dashboard, in the dashboard filters, enter in the master node name, job name and the build number as shown in the following example.

Jenkins_Build_Information_filters.png

Use this dashboard to:

  • Monitor parameters used for the build and source control management, such as Github Repository, to understand recent commits that have been added to the build.
  • Investigate possible causes for build failure using configuration change before build details, test case failure, commit changes, pipeline stage failure, and console logs.
  • Investigate the cause for failed test cases by analyzing stack traces.
  • Investigate configuration changes before the build by comparing the old configuration and current configurations.
  • Identify command failure for pipeline jobs using stage and stack trace information.

Jenkins_Build_Information.png