Skip to content
Exlogare
Exlogare / Documentation

Getting started

Sign up, connect GitLab, GitHub or Bitbucket, and see your first RCA in an MR or PR in under five minutes.

This guide takes you from zero to a first RCA comment in a merge request or pull request in under five minutes.

1. Create an account

Open app.exlogare.net/login and enter a work email. We send a magic link — clicking it opens the onboarding wizard and creates your tenant. No password required.

The Free tier ships with up to 20 lifetime analyses and up to 10 connected projects — enough to walk through the full path and verify that the RCA output fits your pipelines. Your plan and remaining balance are always visible in Settings → Billing.

2. Connect your CI (GitLab, GitHub or Bitbucket)

GitLab

The wizard offers three connection modes:

  1. OAuth Connect — one click, GitLab authorization, auto project discovery, the webhook is registered for you.
  2. Webhook-only — use this when OAuth is blocked by policy. Either copy-paste the URL and secret into the project webhook settings yourself, or hand the wizard a short-lived Personal Access Token (PAT) and it will register the webhook for you.
  3. Hybrid (webhook + polling) — webhook for real-time plus periodic polling as a safety net in case a hook is dropped. Available on paid plans.

For gitlab.com you do not need to register an OAuth application — Exlogare uses a platform application. For self-hosted GitLab you’ll register an OAuth application.

GitHub Actions

  • In the onboarding wizard, choose GitHub Actions and sign in with OAuth. Exlogare then lists your repositories, registers a workflow_run webhook on each one you select, and analyses failures the same way as for GitLab.
  • For github.com, the operator can supply platform OAuth credentials (GitHub OAuth App) so you do not have to create your own. For GitHub Enterprise you register an OAuth App in your org and paste Client ID and Client secret in the self-hosted path — see GitHub OAuth setup.
  • Modes and quotas (webhook, OAuth polling, hybrid) follow your plan the same way as for GitLab; the dashboard shows per-provider limits under Integrations and plan capabilities.

Bitbucket Pipelines

Exlogare supports both Bitbucket Cloud (bitbucket.org) and Bitbucket Data Center / Server.

  • Bitbucket Cloud — choose Bitbucket Pipelines → Cloud in the wizard and sign in with OAuth. Exlogare lists your workspaces and repos, then registers a repo:commit_status_updated webhook on each repo you watch and analyses failed pipeline runs. Modes (webhook, OAuth polling, hybrid) follow your plan, same as GitLab/GitHub.
  • Bitbucket Data Center / Server — choose Bitbucket Pipelines → Self-hosted. There is no OAuth path on DC; you paste the base URL plus the project key and repo slug, and the wizard returns a webhook URL and a shared secret. Either paste them into Repository settings → Webhooks by hand, or hand the wizard a Personal Access Token and we will register the hook for you. The DC integration listens to repo:build_status_updated, which is shipped by your external CI (Jenkins / Bamboo / TeamCity) via Bitbucket’s Build Status REST API. DC < 7.4 does not ship the build_status webhook event — upgrade to 7.4+ or use POST /api/analyze for manual ingestion.

For both flavours we keep the same RCA-feedback cascade as GitLab/GitHub: PR comment → commit comment, falling back depending on what is available on the failing run. See Bitbucket OAuth setup for client_id / client_secret registration on Cloud.

3. Break a pipeline on purpose

Push a commit to a branch that is guaranteed to fail. Within 60 seconds, an RCA comment appears on the linked merge request (GitLab) or pull request (GitHub). If it doesn’t — check Dashboard → Events: you’ll see whether the webhook arrived and what the response was.

4. (Optional) Create an API token

If you want to POST Jenkins build logs or script Exlogare from your CI, open Settings → API tokens in the dashboard (admin role required) and create a token with ingest and/or read scopes. The exl_… secret is shown only once — copy it into your secret manager before closing the dialog. API tokens are available starting from the Startup plan.

Need help?

There’s a support button in the bottom-left sidebar of the dashboard — it opens a modal where you can file a ticket (technical question, or a sales enquiry for an Enterprise upgrade). We reply on business days.

Next