> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Conecte o AppSignal ao seu projeto no GitLab para visualizar a fonte e vincular revisões, e reportar deploys do GitLab CI/CD.

Ferramentas para desenvolvedores modernos.

O GitLab unifica issues, code review, CI e CD em uma única interface.

A integração com o GitLab vincula o AppSignal de volta ao seu repositório no GitLab (visualizar a fonte de uma exceção, abrir um commit, etc.). É uma **integração pessoal**: cada usuário que quiser usá-la deve concluir esses passos por conta própria em cada app do AppSignal.

<Tip>
  O GitLab não tem uma integração com AppSignal de um clique do lado do GitLab. A
  configuração abaixo usa um personal access token do GitLab, que é oficialmente suportado
  no GitLab.com, no GitLab Self-Managed e no GitLab Dedicated. Esta integração
  **não cria issues automaticamente no GitLab**, para evitar sobrecarga de stories.
</Tip>

Site: [https://gitlab.com](https://gitlab.com)

## Passo 1. Crie um personal access token do GitLab

1. Faça login no GitLab e vá para suas **Settings** de usuário.
2. Na barra lateral esquerda, selecione **Access tokens** (`https://gitlab.com/-/user_settings/personal_access_tokens` no GitLab.com).
3. Selecione **Add new token** e preencha:
   * **Token name**: `AppSignal`
   * **Expiration date**: escolha uma data que esteja de acordo com a política da sua organização.
   * **Scopes**: selecione os escopos mínimos que o AppSignal precisa para ler seu projeto:
     * `read_api` — acesso somente leitura à API do GitLab (metadados do projeto, commits, arquivos).
     * `read_repository` — acesso somente leitura ao conteúdo do repositório via Git/HTTP.
4. Selecione **Create personal access token** e **copie o token imediatamente**. O GitLab mostra apenas uma vez.

<Tip>
  Use `read_api` + `read_repository` em vez do escopo amplo `api`.
  O AppSignal só precisa ler informações do projeto, não escrever nele.
</Tip>

## Passo 2. Adicione a integração no AppSignal

1. No AppSignal, abra o app que você deseja conectar.
2. Vá para **App settings → Integrations → GitLab**.
3. Preencha o formulário:
   * **Token**: cole o personal access token que você criou no Passo 1.
   * **GitLab URL**: a URL completa do projeto GitLab, por exemplo `https://gitlab.com/your-namespace/your-project`. Para GitLab self-managed, use o hostname da sua instância, ex. `https://gitlab.example.com/your-group/your-project`.
4. Selecione **create integration**.

Você pode retornar a esta página a qualquer momento para **update integration** ou **remove integration**.

## Passo 3. Repita por usuário

Como esta é uma integração pessoal, cada colega de equipe que quiser que os links de fonte sejam resolvidos em sua conta AppSignal deve repetir os Passos 1–2 com seu próprio token do GitLab.

## Marcadores de deploy do GitLab CI/CD

Para reportar deploys ao AppSignal a partir de um pipeline do GitLab CI/CD, veja a [documentação de marcadores de deploy](/application/markers/deploy-markers#gitlab-support) para a abordagem recomendada da opção de configuração `revision`, ou o [exemplo da Markers API](/application/markers/deploy-markers#gitlab-cicd-example) se sua stack não incluir uma integração do AppSignal.

## Solução de problemas

**Os links de fonte no AppSignal não abrem o arquivo correto.**
Reabra **App settings → Integrations → GitLab** no AppSignal e confirme que a GitLab URL aponta para a raiz do projeto (ex. `https://gitlab.com/namespace/project`) e não para um subpath, branch ou URL `.git`.

<hr />

### Lista de integrações

* [Asana](/application/integrations/asana)
* [Discord](/application/integrations/discord)
* [Geckoboard](/application/integrations/geckoboard)
* [GitLab](/application/integrations/gitlab)
* [Google Hangouts Chat](/application/integrations/hangouts)
* [Jira](/application/integrations/jira)
* [Linear](/application/integrations/linear)
* [Microsoft Teams](/application/integrations/teams)
* [OpsGenie](/application/integrations/opsgenie)
* [PagerDuty](/application/integrations/pagerduty)
* [Shortcut](/application/integrations/shortcut)
* [Slack](/application/integrations/slack)
* [Squadcast](/application/integrations/squadcast)
* [Trello](/application/integrations/trello)
* [Webhooks](/application/integrations/webhooks)