{"id":14984763,"url":"https://github.com/jenkinsci/plot-plugin","last_synced_at":"2025-04-04T15:07:18.013Z","repository":{"id":546753,"uuid":"1163695","full_name":"jenkinsci/plot-plugin","owner":"jenkinsci","description":"Jenkins plot plugin","archived":false,"fork":false,"pushed_at":"2025-03-05T06:31:19.000Z","size":818,"stargazers_count":59,"open_issues_count":0,"forks_count":92,"subscribers_count":104,"default_branch":"master","last_synced_at":"2025-03-28T14:06:08.801Z","etag":null,"topics":["java","jenkins","jenkins-pipeline","maven"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/plot/","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-12-13T05:48:36.000Z","updated_at":"2025-03-05T06:31:23.000Z","dependencies_parsed_at":"2023-02-17T01:46:30.843Z","dependency_job_id":"e4719e36-e877-4222-bab7-f69f1a3b3fd6","html_url":"https://github.com/jenkinsci/plot-plugin","commit_stats":{"total_commits":570,"total_committers":61,"mean_commits":9.344262295081966,"dds":0.6421052631578947,"last_synced_commit":"b2a858f08a9eb1d0573bb1b70c40dc9100b16a6f"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplot-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplot-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplot-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplot-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/plot-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247198450,"owners_count":20900080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","jenkins","jenkins-pipeline","maven"],"created_at":"2024-09-24T14:09:38.280Z","updated_at":"2025-04-04T15:07:17.991Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Plot plugin\n\nThis plugin provides generic plotting (or graphing) capabilities in Jenkins.\n\nThis plugin will **plot** one or more **single values variations across builds** in one or more plots.\nPlots for a particular job (or project) are configured in the job configuration screen,\nwhere each field has additional **help information**. Each plot can have one or more lines (called data series).\nAfter each build completes, the latest values are pulled\nfrom **Java properties file(s), CSV file(s), or XML file(s)** via an XPath (which you should have generated during the build) somewhere below your workspace.\nData for each plot is stored in a CSV file within the job's root project directory.\n\nIt can generate various kind of plots, including `Area`, `Bar`, `Line`, `Stacked Bar`, `Waterfall`, etc.\n\nHere is an example of the plots generated by this plugin:\n\n![plot-example](./screenshots/plot-example.png)\n\n## Configuration\n\n### Currently supported parameters\n\nThe currently supported parameters are:\n\n- **`width (int, default: 750)`** The width of the plot in pixels.\n- **`height (int, default: 450)`** The height of the plot in pixels.\n- **`rightBuildNum (int, default: 2^38 - 1)`** The right-most build number on the plot.\n- **`hasLegend (boolean, default: true)`** Whether or not the plot has a legend.\n- **`urlNumBuilds (string, default: 2^38 - 1)`** Number of builds back to show on this plot from URL.\n- **`urlTitle (string, default: \"\")`** Title of plot from URL.\n- **`urlStyle (string, default: \"\")`** Style of plot from URL.\n- **`urlUseDescr (boolean, default: false)`** Use description flag from URL.\n- **`title (string, default: \"\")`** Title of plot.\n- **`yaxis (string, default: \"\")`** Y-axis label.\n- **`series (list)`** List of data series.\n- **`group (string)`** Group name that this plot belongs to.\n- **`numBuilds (string, default:\"\")`**\nNumber of builds back to show on this plot. An empty string means all builds. Must not be \"0\".\n- **`csvFileName (string, default: \"$ROOT_DIR/plot-XXXX.csv\")`**\nThe name of the CSV file that persists the plots data. The CSV file is stored in the projects root directory.\nThis is different from the source CSV that can be used as a source for the plot.\n- **`csvLastModification (long, default: \"last modified date\")`** The date of the last change to the CSV file.\n- **`style (string, default: \"line\")`** Style of plot: line, line3d, stackedArea, stackedBar, etc.\n- **`useDescr (boolean, default: false)`** Whether or not to use build descriptions as X-axis labels.\n- **`keepRecords (boolean, default: false)`** Keep records for builds that were deleted.\n- **`exclZero (boolean, default: false)`** Whether or not to exclude zero as default Y-axis value.\n- **`logarithmic (boolean, default: false)`** Use a logarithmic Y-axis.\n- **`yaxisMinimum (string, default: \"\")`** Minimum y-axis value.\n- **`yaxisMaximum (string, default: \"\")`** Maximum y-axis value.\n\nFor a full list of parameters the best place to view is [Plot.java](./src/main/java/hudson/plugins/plot/Plot.java) class.\n\n#### Pipeline job configuration\n\nYou can generate the required [Scripted Pipeline](https://jenkins.io/doc/book/pipeline/syntax/#scripted-pipeline)\nsyntax via the [Snippet Generator](https://jenkins.io/blog/2016/05/31/pipeline-snippetizer/) by choosing the `\"plot: Plot build data\"` step.\n\nBelow you can find sample configuration which is auto-generated using [Snippet Generator](https://jenkins.io/blog/2016/05/31/pipeline-snippetizer/).\n\n```groovy\nplot csvFileName: 'plot-8e54e334-ab7b-4c9f-94f7-b9d8965723df.csv',\n        csvSeries: [[\n                            file: 'data.csv',\n                            exclusionValues: '',\n                            displayTableFlag: false,\n                            inclusionFlag: 'OFF',\n                            url: '']],\n        group: 'Plot Group',\n        title: 'Plot Title',\n        style: 'line',\n        exclZero: false,\n        keepRecords: false,\n        logarithmic: false,\n        numBuilds: '',\n        useDescr: false,\n        yaxis: '',\n        yaxisMaximum: '',\n        yaxisMinimum: ''\n```\n\n- **csvFileName** - autogenerated value, but you might want to change it to something more descriptive for your case.\n- **file** - source file for plot generation (relative to workspace)\n\n## JIRA issues\n\nIf you have any proposals/bug reports, please create an issue on Jenkins [JIRA](https://www.jenkins.io/participate/report-issue/redirect/#15564).\n\n## Changelog\n\nRelease notes for current releases are in the [Github releases page](https://github.com/jenkinsci/plot-plugin/releases).\nReleases notes prior to June 2019 are available in the [historical archive](https://github.com/jenkinsci/plot-plugin/tree/plot-2.2.0?tab=readme-ov-file#old-release-notes).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fplot-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Fplot-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fplot-plugin/lists"}