Skip to main content

Set up a Gitlab Issue integration

  • Updated

To start collecting data for the Process Axis, you must configure an integration and link it to the project. You only need to add the integration once to connect it to multiple projects, allowing you to evaluate different teams.

 

Available integrations

 

Note that Gitlab can be configured as an integration for both the Process Axis and the Technical Axis. If you are using this tool to track the management of your projects and code, you will need to perform both configurations in Axify.

 

To set up a Gitlab Issue integration

  1. Select the project for which you want to start collecting data.
    Psst! If you haven't added your project yet, do that first!
  2. Access the Process section, and click on Link an integration.

    EN_-_Axe_processus_et_technique_-_New_integration.png


  3. In the window that opens, click Add an integration.

    EN_-_Choose_integration.png


  4. Select the Gitlab option, then click Next.

    EN_-_Ajouter_inte_gration_Gitlab_Issue.png

  5. A window will open. Complete the fields.

    • The Integration name helps you recognize this integration later. This name will only be displayed on the Settings page.
    • The Personal Access Token must be generated beforehand directly in GitLab settings. You can refer to this official GitLab help article for more information on this subject. This article is also available in the configuration window.
    • The API Key is a key created in the settings of the Jira user profile.
      To do this:
      • Go to GitLab
      • Access your user settings (your avatar in the upper right corner)
      • In the vertical menu on the left, select Access tokens
      • Name the new token and, if necessary, determine its expiration date
      • Select the scopes to include.
        Psst! The projects accessible through the integration are only those the token holder is a member of.
        read_user
        read_api
        read_repository
      • Enter the generated token in the API Key field.
        Psst! It is impossible to display an existing PAT. Therefore, if you have private internal documentation the PAT can be stored, it may make sense to add this data.
      • The URL is the base Jira site we want to connect to. So, for example, we could have https://gitlab.myserver.com. Note that in some cases, the server is simply the main GitLab URL, with no extension.

        Once the fields are completed, click on Add integration.

        EN_-_GitLab_-_Creds.png

 

That's it! Your GitLab integration is set up and ready to be linked to your project to start collecting data!

Psst! Depending on the volume of data, the synchronization of the Process Axis can take several minutes or even several hours in the most extreme cases. Also, note that the deletion of data (items or columns) results in the loss of this data in Axify, i.e. this element will no longer be considered in the various metrics of the Process Axis.

Related articles