Pular para o conteúdo principal
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.
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.
Site: 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.
Use read_api + read_repository em vez do escopo amplo api. O AppSignal só precisa ler informações do projeto, não escrever nele.

​
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 para a abordagem recomendada da opção de configuração revision, ou o exemplo da Markers API 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.

​
Lista de integrações