# GitLab data ingestion

Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fintegrations%2Fcontextual-data%2Fgitlab-data-ingestion.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fintegrations%2Fcontextual-data%2Fgitlab-data-ingestion.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

GitLab records what changed and who changed it. Sending those events to Coralogix puts that history next to your runtime telemetry, so a spike in errors can be lined up against the push, merge, or pipeline that preceded it.

The Contextual Data integration generates the webhook URL; GitLab posts to it.

Note

To tag Coralogix version benchmarks from a GitLab pipeline instead, see [GitLab version tags](https://coralogix.com/docs/developer-portal/apis/version-tags/gitlab-version-tags.md).

## What you need [​](#what-you-need- "Direct link to what-you-need-")

* A GitLab project you have permission to configure webhooks on.
* A Coralogix API key. You can create one during setup.
* An [application and subsystem name](https://coralogix.com/docs/user-guides/account-management/account-settings/application-and-subsystem-names.md) to file the events under.

## Generate the URL in Coralogix [​](#generate-the-url-in-coralogix- "Direct link to generate-the-url-in-coralogix-")

1

<!-- -->

.

Open the GitLab integration

Select **Data Flow**, then **Contextual Data**, then **GitLab**, then **Add**, then **Add new**.

2

<!-- -->

.

Enter the integration details

Enter a **Name**. Supply **Your API Key** or select **Create new key**. Enter an **App Name** and **Subsystem Name**.

3

<!-- -->

.

Generate the URL

Select **Generate URL** and copy the result. It has the form `https://integrations.<cluster URL>/v1/gitlab/v1/events/<token>`. You need both the whole URL and its trailing token in the next section.

[![Coralogix GitLab integration details form with name, API key, app name, and subsystem name fields](data:image/webp;base64,UklGRq4YAABXRUJQVlA4IKIYAACwxQCdASr9A5IBPm00l0mkIqIiIPBoWIANiWlu/BV5yOMnf63bKtN4YD+gr9d7GfRp4jHTw8wH8d/1H7R+8x6NfQA80/1IvQA87v1Zf8r+OmZA+bv8h2w/4D+y/jH2eHpT2l5ocTL499m/4/+C9DO+f5KahH4p/Lv8JvWed+YL7AfU/+1/i/Gp+ZvU/80/rn/Y9wD+R/1j/ceqX9w/3XjlfYf83/yPcB/mH9T/4/97/Lj6YP6j/6f5n0B/n3+n/Zj4Bf55/cf/F2UgZeK5AutwMYI/qt43V7AImyZRF0b6moCYxC431NQExiFxvqagJjELjfTfMYw2aBmW02Eupt6QiiY5BZsXmuAW63FBQwbBBS5iTBk7qagJjELjfU1ATGIXG+pqAmMQuN9TT/+IJgi0JewNoxDnq4UlCdg5dYvWOZXnIFKL2IOz4Dm/Trs9TVoekks3oo7vwxceOuz1NWh6SSzeiju/DDIfTqCY6p6ZvGdi0n/0YHrmrIBZNqLQbG5r5iC3lQFImsXl7CRzydx1Gizmn1NJXZ3nUaLOafU0YiIS1cB9G5Jgml4XoETbd3ao/12EiJ9JrwTQkfscAyBYJ+ltGsNmKOO9swveVlOKkazmczmczmczmczmczmczmczmczmcy+YG/tkHnI9g9My/IHa3ZEYXoQ08e/z7zIxt/07StIM3oMf8JFOqF+bG3VoNIMRrBQEgiMTn9TdFnID6QLntB8ldY9wXWPcF1j3BdY9wXWRam1geqGcBxRyQkPkcCgLBwmsoib1WEFtc8QSJfwRdG+pqAmMQuN9TUBMYhccArGXE1HImpaKiCiI4FUFiqoDbviYScx9w+gMN7eU9rJfActIMVv03GLgcvnBkHqQC55t8xnd3cxoXF9mqTbDLRWafCForNPhC0VmnwhaKzT4QtFZp8IWis08CR58Cjp11s7qgEerEKl3HHSy5y7saqRgGBm6RGFZeiForNPhC0VmnwhaKzT4QtFZp8IWis0+ELRWZrUQoVJqwuTFC431S/l/+YPCIUyH/rNQgL0QtFZp8IWis0+ELRWafCForNPhC0VmnwhaKzT4JB6Yw2O5oQ5OCLo4BTcfT4qbV9lb8/LSf41T0KisWQ6FGstFZv+Ocmw7DLRWafCForNPhC0VmnwhaC77tzVYLEPxzRmcijp7uG/4TO6mpZxPPW3K+DZ2HKGQfnP3l3DqvnwfGRgCg0QoifUTxHuLg2r6w8FTAPR2OviKWis3/HOTYdhlorNPhC0VmnwhZ+h01VrjOQK610QGVdR61cHXedfc1bHyPxwGujsv+1VRcma5awfk6dCBXm7oCYxDvHo7B8g4pGSFcrg/3Gg0t23Ha9ovHfq3G+zs+op+UErHZxEKrTJZptrgQGR1W7bEwP21qTPguZBcJjEL1+C53EwbAR63ObSj/5tMkPPO5nM5nM5nM5l886r9Zxbh748wIIBpZU/0sfLtE4r8ruRm3bcdr2jBsgMVWbe5cTUkrrAEyKbnt4KYP5FhI+s7JH2gKdVu247XtF4/H4SDy7eXKvtvX4ruYsxuGxuA4fj8fj8fjz6DMJbn1M/N0zupt/kDLrAExiFxvqa++431NQExiFxvsgo84dbO6moCcbDC46wBMYhcb6moCYxC431NQExiZLc+pn5umd1Nv8bo31NQExiFxvqagJjELjfU1ATIqTYpC8nmLjfZBMxiFxvqagJjELjfU1ATGIXG+pqWhaMuYC4TGIXsD/GSvELjfU1ATGIXG+KFqRX2luujcU4jx2y7rigW6AeaTEoJP/+VMSCkc/DmVx72tu41nJMULjfVMDRiFxvqagJjELjfU1AVKQExg5W9RxxTzuaIgkcaWEov0IFebugJjEO0b5MLkTTUl2/45ybDsMtFZp8IWis0+ELRWafCForNPhC0VmnwhSbv3JLG6xdk8xcb5d7hzeSol23Ha9ovH4/H4/H4/H4/H4/H4/H4/H4/PTZmaa1Thv+EzupqLhpUgXPaD5K6x7guse4LrHuC6x7guse4LrHuC6x7Ni/6F5PMXG+pqAmMQuN9TUBMYhcb6moCYxC431NQTodbO6moCYxC431NQExiFxvqagJjELjfU1ATGIcteAAA/v/Sz/U4vwoXHU3Fpc3EAChX7U17ytg6zO5VHFrmCdE5fJ5eDyZZf3vIwXRkZzx8xV8fnZwxEXp1Arvkd+3CXR7H8E835jTuwhCISaioL9PboQqzYc/9BsFfHRHbKUFcYGUuNw8QyJU5xf8l7wWCLjjlp+Tl5n14dM9FL+WwCVHgKvHPmsHRUnkQvHG+/01/5XjATLHSXYzgAAAAAogRSnxkSSqv/UPX/zvrxYR1bY1EP7W9dPKVJaMHu7g8fuA0fP+A7YI/jYxK5733aL7VwzHOiPfhvm1Z2Amygf+Py1stX7N5btgrnTgpkDiU+iDGt7JPNANMC+J9I3W3Wwi3dpUfxpEsKDcmPnU/kCcBsWR2mwAWTELGfI/nT/q9TJ3/oTvjs5CP6fetB2+JFae+NFrPN5VLp4In7y4dNMfxYLgSYfQ+rf5HRcpSWz31FoO8NfpDYky0ZWGEqf30xsaD+fClIdpWhyrRrnz8Cv7v8caG7P9qzV8+aqpzNBy4Fmbkjt8Y8TNRxA+/fyvxHoPCKYM6wofkqYujQKuy9B2gyWAAAAAAd/KgztbuEhcLCYzrd9IVQ/e4q6+joMqQFPvP/DPCdc69GuOVlXJvqWn6knxKDv7GIXsKUgN37mpnj7PWa2NsfmFIOf3/Ie31iqYGFQvshbAE+1s/KAVCB1SAhzv6OXEs2GLyiyjGB/QZsP8yFUdL3GODqO0iGyrzaxyycAOgmYMzMGNVxf0YCRYtlPxolLFxLoKJT/B2umGkW6YaRbphpFumGkW6YaRbphpFumGkW6YaRbphpFumGkW6YaRbphpFumGkW6YaRbphpFumGkTidWi8viS3Hvqjk0aTaZkwodyLW2b4a2xRPHFy4O5E8x6ea5KzEu3rpzg5Dnt0DqZRMjDHarPgXOgL9Tp++Bu4AZGwF135bcULEC2Imqt0lqM9/kN8nGr9xendyiUTluP3/psoJ/L90aJzxZY19DYYGyyb/Y8WWNfQ2GBssm/2PFljX0NhgbLJv9jxZY19DYYGyyb/Y8WWNfQ2GBssm4nOj6DkfkgjNpCW/ral9kKG/NO7Eu5mBmQuKdC2p1y284ho5nEQf/eVauuCh+lOjHreLYwc/81zyMfUX9avjWHZk3UvUtt6HIjdPK5iW3o4IS/w/OTewu8K1GWFqTImyfaL8gLg7Pm5nj6z1jtciqmu0BA/vb5x7ZblesYFsRxWSpPY26kP1kCekwoItBfZ8dYxCAMR95+GNXPphT915CpVjT8bVwnIVkq9PQPWRCZAUs09NfmbehFN7T548fZEOL6ynBeqDpuHuPnH1+jmKRW4fNZPTu3Z6P5eqpuv47/xrPX7mubt9Rbkpf4RmPmY2/MMPx7IVW93g+6c3ppbPbgqkd0+FdkoeB8hAXE5aK6szyilanG/R4rvO+a9vFbjFuSeJ5o8E580JsnRR/+P9f+VP0zfO/cr0E9V/idElorHGxYGT1Vt+9Vsn+J0SWiscbFgZPVW371Wyf4nRJaKc8XFhP0x5bDR5sqlNK1UNvaXShyo4wuB1fhb4nwsCPHoj4aIpAtyMKckP2XyjiAXZUZ3BfuZpBDwL/ukB03K/lXFWmP6I6DGX5SGq80TQ+U1w4LudOCP6b8XneT+tQTWSgVUDM8k9OXRPPoAwU6OkrC/OzaYbkeZsjJU0H61oQ7+pg3Zc6efFv1CFBtca+A+ePBjO9+rlt38vRlf90Gy3x7QuoZBzOj1HlyFcB/ZHm5fgtw1zXduCYckVu8LrYX5Ob1VaXbnudNGRk+dUAsQsLefE5Pe+hPp1Hwq75pHnoojwoOwYobHEfXuS7uBj3Dk36Hj5NET4Ec/LJ0uoZaPW9ljZFFFwNUjHFNqn7vzWeXHH7zd3o5+OvbDTkGOZAMpuPjAylDxbmD3jeXN0nJ+6v6SCniBSe1SkXtNPR9rS2W650NJA0GPOott1mzjLOAma+8YZSHkYU7MeLP0sgiNeflssn1pNHkNeA2mNhdUYyj2CmsG1A0O11V7uJYoQAAAAARdg445vCaM2FdBriOz48K4oqNR5e4McISFNHU5UU+zgZp2z7hPKRpfVBQUO83p0QxxqplKGTe/Xnpz/1ZeLCJ9mMBaiBPmMsn8r/gF2nron8dIgPZLsUxpt4M/K3++3s22+0nGTZLQhahq2IHwcfkN614YMurpgAAAAAKMRNYDKuS8gNihlMoX1qurwQZbuxUknUVIJyvMeq1Xk/h1KEU25hmT6sND+kyZO4XoUldhYKu3jfhIIBNXp5Fqk60h9FQhvs3mgh7euGbcGLmyGKahYG+fJitPN8JEJuzbbDXhIXCr4PfsH+LU98wMLCHTlEZfAmSBNNe7XkPgpAlMI3RJpaZtDqU8qygCMMmGsEc0pLposM5H/msV6GVUFExwI6TuNmbUV6syvB1V/Z4bz6AXIV3mUQ8wLX7IblP6rcs2I27i1YqLJPlHMgKehYvxnyf992iB5XhWqrdzcFrNFCaaAFv2pHlQlzaCz9j1xgjRC5fovRVTb4ilqDUKwQxYkiMwsBv2bmX99Zkx/SrV2o32bg/L3RLSw8bHDdct8nukXe24ZZ4DKM731WVJ6oVfre6Keozt79zVRJ1CWtqLCw2dgtL0sMhAucgGJ9alL61wKzA6IYgMVhRHzdFcBPCktUmrlXDVClw6qWmEztGnSemr0f+W8b4lZOycSdcGovt7m0kvBtKWePs9/JvrUTbGO9dUHh9gTCWND8ICdkkbSohHmaoTqtuS6VvRep1ute9fIutylXcxEUZwvkdDarj3uFeOWlTvbO9ATzXpnk9fKPRJJxnKQ8DvzMK5CiSli3wgPselb6SZFNSrqVup2vJzBuG1vD909dXqusmnX3KIZlGayC1puFo1szjvhzzfzUUxXYlfbgf94e5jfx86bHMAgFexIEfPWtS4QLZQlJTe6OROvi+Lw75TIU1RVtnhDm+A4NdlU5AW9f9LSc0N7yTFMAQiVJGXBhDXT7wUl+s2gPC09Um/OhAwvDJuI8bUZ5qkjBIWYz5mJsh7Q6j55Z8W8TbySmncMFDBaKBxpzHjMAK2h8prDniT2AVtD5TWHPEoADcV3WoF/F7oWIx5RJI4kSDzpJqQMTv53ycOR1LfVMi6gVoNO/HY4atCx4MPLjPvrbkm5B8W8hnMGb8iLH5JsVK52u2Lais8nnV8eEHHpOrr6TZL8FLCoL98I4HmDJ6+ch7aG5HDtZY7IsGjqYYKIAAw9O5E3AO7wkhycN4tNniKBE9ugbgICnwIDyBNRCGj5ljzY/9nVRxR5sf+zqo4o82P/Z1UcUebH/s6qOKPNj/2dVHE9+oJBCccCHgAxxR05ihosgyRQDFHr23yUmrjr3No74D1TOHw3ugyn757TEwVZkd8v20WxcrbAbLDXhp0ogOivg76wun03q8EXEiAAAAAAJK4jKnGxtVBe4JGvlIizQ7C3B3TtplRKQ9HgSyhLNCA0u5cn1SfuOAM4+iH9QK3pzjx4XR33EwMqZiE2YATYOldCsSFRh/EsUUBIOdeovAvVqP3q8sJpWjxtX45/lboDRlQUHD4B/yhHO3kqh7sAvc50mYfUDi7swCD5nNQgVvdE4hWAQgzzzjtvne+w/YfsP2H7D9h+w/YfsP2H7D9h+w/YfsEBIT7mIJVtcrkjCB775tIFuzaDf77xrgMeers4GAQPCtDHWpyBPAL+SDPATM9iyXEZHGPmP8QpJCj1a4ylszqI2e745JlFbPVm4VzQWLAdANm45Nr2bNVH0WOshM6yYrRwcIJ5Hd7p2e92lK4EMPSNrJGQ31ugQMtHsP5s/6yVY7rbk7cSV38Qc3Bug7qgIEVZeD1RxTC7CbKXp01JimXIgO07vRTxW3J065bKbNtJzA+ccVlWnzJWhMdDqkbRHxY3gjkYBQ2AUg6adZf8p4N88yei2WCIGbDn4zhZx5GlF+W2NmYZYENhjow2tuVb3mvyUT2b1Ie/zt70u4FDd4OKyzktTGqMTyT41FN9wjIkJEaw/nAoBMPFdmTIE+VHI2SjTTs9m+X07xnQAtW+Lsa9bqjxySlp9mD0ON50jIG06sHgFrAhkVmv9yZDLC3fasBitdDieOh9siA/4wcuBAf551Q1PV0qXsIChvaxg5k1lqMIAwzoZOi9Asn3bAPXHUPKTTsaFLKAOa7PYsiLUOUcmRYUmXcddJqeQBcVTWEkLWqT5HFmNWr8yKxIxXW79i9APlhA061OXEL0xNdrKiYiXQ+i7rCWKGKAG9TNv4oFOmpI2HMyj6B5Pq+uVOpzVhBhwCC5UczsoQYaSuuSCsQYVUfKHu9ox1G5OukBwpSUr5unkLh1jzAIAyDWtYy4MdS/tKWU5CZxY6sUU7iSfqwrHMmdsqxTleiQV9RAAAHcrFs1N6LpVrYDxpbGxrxlSmEaoZ9fRg7y37/gKhGqCd9py86B4ur2cAOHYIUYGKel0sH7BTXGqGdmqybnhkh5MU3//eNOrurz4CLa2FpR8qugbPwfvU18y+aZC0xl8MzsC30A3XUEwQpzwwImr7T+E6gc8pHvroo737VjmPaT0P/kJvp5p4TO4KH5s6fhQWStatt7u4/BnId+7j8FOi29hmOW1wamXYqN6158ZBccZmBpH8Vr3KIGrp32pkkQABJv4a0XnwBECbfzqu3BpaCKMVXU0nd2rJ/LUfo1SwckAQ+wMuNBzzWsOpUdqkeKpATg1nrP1ZksjvxjDlu7b0rPy9mCJneRTBUQ4uwpYDpDtfv19Nng6mwmy2NxgT6edv/gka9oJUXjTpS8vN43cUe0r7QbESs0wonQ+/rm68bvW9957cbWO1WuxBbL1HNGK5ybAvTsWAgPU1e/GOO4S8u9Enu7d8POORYegd5jFQ9T3oTGlWfP6HQqvsQpdjoTXxkZ1sYZuL5CUwAAJH3gurshjCU49cB10Vmq+LYneI5iLM4JLvmZyfnbaShVbB06w+wU+pfM2PVWdw89d1dDrHM7MrhB1aIqHT+PZwThecFckydkBH6It45MIQt0Ar7qlBLrcZCgSjwuGWLK12iWl2i+Cq15V2uJvZKi2kynECdJ5OIaGfXHo9FVgXEgRfhscp0WJTGfpKDsZone90JyOJsNFfLaLE2VCR5+7uHNYcs0jkQP4SpoQ//7i3pWHhqbpEIv9wzr3Y8wkapIBcnRGAA2MRpyufv+BIgWAeQy3hI3oFPYUSIQUEss9jNuFoREcp6jAg3f8SlKSWVmbK9WcOtjBD9xizTR0/f6co0j/WXHoVbA7q8S+UjKkEOf3DWpNXg2d8JMm70eRJAcW6iuBeUuF4bZANDpNMXacb2EnhgN0t1toIiKgBuqnTuyI4XkioOBEo+2snHaytWGjlOy7iIl49hxtEhJmHuNkN7gxadM4jYuP1Le8LojnNTcjcBsufLBSFl9jahtEE24HJFQCBbhSAUwZ+UM0TPKMlJKOZOxYb+F44nEsuJmb4np7Gq35nY8+BYFEQkS4Qd3zILbU2+H1DX/du7d6jJ+B82r7OlQOX/W3IZiAymtyaOTRyaOG1NBVCt9T4i0MUkGJDsOL8z+z9Xwh7FMZ2D0yPvszA3yfR5TWBKvl5ampo5NHJo4wMqhnznkW+PhU4C7qogAAAAGx74JhGBAAAABo56MpakAAAAEecYJGvQgAAABAs8Gp+iAADb7rJFP9AeRM06AKuYitl1d4fYZsO1hMpsAq6VnneImutjXiNiQusEmLRejG209bj5qKLPJUFE8J4yiEg9KJ3x+TAHYiPTXNdXcaG1z7IgEUzApk/+opLzn5vzfls/QNf4/weX5N/TyYADp25E7h0qeN+GOxAa4PzeWtsQGbTF0Z6AqBdUDrLnOzm4Yy7b81LD4tUfaGrvUPbQiaqK0aQVsPVIsOtmqwEljplKV54TxebN8JTPEFlaFcwBI1EZjcafvikszuqu3qugEw176QofdmPUYtytsLmZ/pAaA/vQsa5YPNur0bopIsdkh5K0pGuAvsRejWLtjs87lTjZUVUDp7zeKZn7jDxQn/+dwVmlg6RPQRDueEdj8QAAABO2Xspf4YKrLFvOWK7D6ybdS35oAXxFqxAjyTdKUErR85ZxCnmGJe01/T0spi/f1+EabZaUC7jBpNdk4H0MFSCpBUgqQVIKkFSCpBUgqQVIKkFSCpBUgqQVIKkENhUgevZpKiGa6G6b5MG2R/XzKwysMrDKwysMrDKwysMrDKwysMrDKwysMrDKwysMoakIwgAAAAAAL+YnEAAAAAA4bpwEAAAAABtwAAA=)](data:image/webp;base64,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)

Shows the form that produces the webhook URL GitLab posts to.

## Create the webhook in GitLab [​](#create-the-webhook-in-gitlab- "Direct link to create-the-webhook-in-gitlab-")

4

<!-- -->

.

Open the webhook settings

Sign in to GitLab, open the project you want to monitor, then select **Settings**, then **Webhooks**.

5

<!-- -->

.

Enter the URL and token

Paste the generated URL into **URL**, and paste the token from the end of that URL into **Secret token**. GitLab sends the token in the `X-Gitlab-Token` header so Coralogix can validate the payload.

6

<!-- -->

.

Pick the triggers

Select the events you want forwarded under **Trigger**.

[![GitLab webhook settings with the URL and Secret token fields highlighted and the trigger checkboxes below](/docs/assets/images/Screen-Shot-2021-03-01-at-8.50.30-AM-84c05d4d68c5f71dc456e94fda846b35.webp)](https://coralogix.com/docs/assets/images/Screen-Shot-2021-03-01-at-8.50.30-AM-84c05d4d68c5f71dc456e94fda846b35.webp)

Shows the two fields Coralogix supplies and the event types that fire the webhook.

7

<!-- -->

.

Test and save

Optionally select **Test**. Anything other than **200 OK** means the configuration is wrong. Then select **Add webhook**.

## Related resources[​](#related-resources "Direct link to Related resources")

[GitLab version tags](https://coralogix.com/docs/developer-portal/apis/version-tags/gitlab-version-tags.md)[Application and subsystem names](https://coralogix.com/docs/user-guides/account-management/account-settings/application-and-subsystem-names.md)[Generic incoming webhooks](https://coralogix.com/docs/integrations/incoming-webhooks/generic-incoming-webhooks.md)