Reporting plugin concepts

The prerequisite for this section is a basic understanding of CloudBees Analytics].

Terminology

Release command center (RCC)

Refers to a CloudBees Analytics dashboard meant for releases. Refer to Release Command Center dashboard for details.

Release activities

Type of software development related activities that happen in a release such as user stories, continuous integration, testing, deployment.

Stages

The stages of a release for example planning, dev, build, test.

Activity metrics

Measurements that pertain to a stage of a release activity.

Data providers

Third party products that provide the core functionality required to perform a release activity and the data associated with that activity.

Data source

Representation of the data provider based on the release activity.

Object type

Represents a type of release object in CloudBees CD/RO. Refer to Understand the CloudBees Analytics data model for the list of currently supported objects.

Report object

Represents the report generated corresponding to a release object. Refer to Understand the CloudBees Analytics data model for the list of currently supported report types.

Usage of plugins in RCC

Plugins can be used to report data from data providers to CloudBees Analytics by virtue of implementing certain procedure interfaces. For example, a plugin can report user story data to CloudBees Analytics by running a JQL on a regular basis, which in turn can be used by the user story widget to display user story metrics in the planning stage.

Usage of reporting in `pluginspec.yaml`

The key features here represent a dictionary of fields required to create the RCC procedure interface in the plugin. Salient fields are described below.

datasourceName represents the data source. For example Jira.
reportObjectType represents the release object section. In the snippet below the release object is build.
parameters represent the collect reporting procedure interface. This procedure implements the logic to collect data from the data provider and report it to CloudBees Analytics.

devOpsInsight:
    datasourceName: 'Sample Reporting Source'
    supportedReports:
    - reportObjectType: build
      parameters:
        - name: ReportParam1
          documentation: Sample reporting parameter
          type: entry
          required: true
          label: Test 1
        - name: ReportParam2
          documentation: Sample reporting parameter
          type: entry
          required: true
          label: Test 2▼