Opsera Github Integration using Webhook

Owned by Aruna Pattabiraman (Unlicensed)
Last updated: Jan 20, 2022 by Hemalatha
4 min read

Scope :

  1. Create a webhook in Github Repository

  2. Register the Github account in Opsera Portal

  3. Create Data Mappings in Opsera Portal

  4. Build Dashboard with KPIs

 

Section 1: Github

Navigate to the repository which needs to be configured.

Settings → Webhooks → Add Webhook

 

Enter the payload URL provided by Opsera.

The Content Type needs to be application/json.

It is always recommended to ‘Enable SSL verification’ for security reasons.

User may select the list of events that needs to be delivered to the payload URL mentioned.

To start with, we have selected Pull Requests and Pushes as these are the events that are currently supported by Opsera.

 

Add the Webhook.

Once the Webhook is added, click on the webhook and navigate to ‘Recent Deliveries’.

There will be one recent delivery which happened as a part of testing the payload activation.

In order to configure this repository in Opsera Portal, user will need to generate a secret token in Github. Go to Account Settings → Developer Settings → Personal access tokens

Create a new token and provide a name as identifier. Copy the secret token that Github provides and store it securely to make use of it in Opsera Portal.

 

Once this is set, move on to Opsera Portal to configure Tool Registry entry and Data Mappings.

 

Section 2: Opsera Tool Registry

Login to Opsera, and navigate to Tool Registry. Tool Registry in Opsera is a central library where all customers' tools are being configured and connections ensured.

Click on New Tool and select Github from the list.

 

Fill in the necessary details, such as Tool Name (an identifier for the tool entry), and apply some tags. Tags can be applied at a later stage, during Data Mapping too.

Once the tool entry is created, navigate to ‘Connections’.

Provide Github repository username and the Personal Access Token that was copied as a part of last step in Section 1

Click on ‘Test Connection’ to make sure that the connection between Opsera and Github is established successfully.

Next, user can create Data Mappings, and configure tags to associate with each individual repository.

 

Section 3: Opsera Data Mappings

Data mappings allow users to configure tags to each repository in Github. These tags will be essential when configuring pipelines and insight.

Settings → Data Mappings → New Project Tag

Select the Tool Github. All the accessible repositories will be listed in the repositories drop down. Select a Repository.

Provide a Project Name and apply various tags required for this repository and Save. User can always add new tags to this entry at a later time, but Insights will start reflecting data for this new tag from the point it was applied to this entry.

Section 4: Opsera Dashboard

Insights → Dashboard → New Dashboard

Provide a name for the dashboard, and apply the tags that were created while configuring the Data Mappings. These tags can also be applied later, after adding the KPIs.

Open the created dashboard and click on ‘Add KPI’.

Page redirects to the Marketplace, which is a library of 100+ KPIs specific to each tool.

In Filter by Tool → choose Github

Marketplace displays the list of KPIs which are specific to Github.

Add each KPI to the dashboard in the necessary order.

User may apply tags to see data more specific to each repository.