> ## 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

> Verbinden Sie AppSignal mit Ihrem GitLab-Projekt, um Quelle und verknüpfte Revisionen anzuzeigen und Deploys aus GitLab CI/CD zu melden.

Tools für moderne Entwickler.

GitLab vereint Issues, Code-Reviews, CI und CD in einer einzigen UI.

Die GitLab-Integration verknüpft AppSignal zurück mit Ihrem GitLab-Repository (Quelle für eine Ausnahme anzeigen, einen Commit öffnen usw.). Es handelt sich um eine **persönliche Integration**: Jeder Benutzer, der sie nutzen möchte, muss diese Schritte für sich selbst in jeder AppSignal-App durchführen.

<Tip>
  GitLab hat keine Ein-Klick-AppSignal-Integration auf GitLab-Seite. Die nachfolgende
  Einrichtung verwendet ein persönliches GitLab-Zugriffstoken, das offiziell auf
  GitLab.com, GitLab Self-Managed und GitLab Dedicated unterstützt wird. Diese Integration
  **erstellt keine Issues automatisch in GitLab**, um eine Überflutung mit Stories zu vermeiden.
</Tip>

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

## Schritt 1. Ein persönliches GitLab-Zugriffstoken erstellen

1. Melden Sie sich bei GitLab an und gehen Sie zu Ihren Benutzer-**Einstellungen**.
2. Wählen Sie in der linken Seitenleiste **Access tokens** aus (`https://gitlab.com/-/user_settings/personal_access_tokens` auf GitLab.com).
3. Wählen Sie **Add new token** und füllen Sie aus:
   * **Token name**: `AppSignal`
   * **Expiration date**: Wählen Sie ein Datum, das den Richtlinien Ihrer Organisation entspricht.
   * **Scopes**: Wählen Sie die minimalen Scopes aus, die AppSignal benötigt, um Ihr Projekt zu lesen:
     * `read_api` — schreibgeschützter Zugriff auf die GitLab-API (Projekt-Metadaten, Commits, Dateien).
     * `read_repository` — schreibgeschützter Zugriff auf Repository-Inhalte über Git/HTTP.
4. Wählen Sie **Create personal access token** und **kopieren Sie das Token sofort**. GitLab zeigt es nur einmal an.

<Tip>
  Verwenden Sie `read_api` + `read_repository` anstelle des umfassenden `api`-Scopes.
  AppSignal muss nur Projektinformationen lesen, nicht in das Projekt schreiben.
</Tip>

## Schritt 2. Die Integration in AppSignal hinzufügen

1. Öffnen Sie in AppSignal die App, die Sie verbinden möchten.
2. Gehen Sie zu **App-Einstellungen → Integrationen → GitLab**.
3. Füllen Sie das Formular aus:
   * **Token**: Fügen Sie das persönliche Zugriffstoken ein, das Sie in Schritt 1 erstellt haben.
   * **GitLab-URL**: Die vollständige URL zum GitLab-Projekt, zum Beispiel `https://gitlab.com/your-namespace/your-project`. Für selbstverwaltetes GitLab verwenden Sie den Hostnamen Ihrer Instanz, z. B. `https://gitlab.example.com/your-group/your-project`.
4. Wählen Sie **Integration erstellen**.

Sie können jederzeit zu dieser Seite zurückkehren, um die **Integration zu aktualisieren** oder die **Integration zu entfernen**.

## Schritt 3. Pro Benutzer wiederholen

Da es sich um eine persönliche Integration handelt, muss jedes Teammitglied, dessen Quell-Links in seinem AppSignal-Account aufgelöst werden sollen, die Schritte 1–2 mit seinem eigenen GitLab-Token wiederholen.

## Deploy-Marker aus GitLab CI/CD

Um Deployments aus einer GitLab CI/CD-Pipeline an AppSignal zu melden, lesen Sie die [Deploy-Marker-Dokumentation](/application/markers/deploy-markers#gitlab-support) für den empfohlenen Ansatz mit der `revision`-Konfigurationsoption oder das [Markers-API-Beispiel](/application/markers/deploy-markers#gitlab-cicd-example), falls Ihr Stack keine AppSignal-Integration enthält.

## Fehlerbehebung

**Quell-Links in AppSignal öffnen nicht die richtige Datei.**
Öffnen Sie erneut **App-Einstellungen → Integrationen → GitLab** in AppSignal und bestätigen Sie, dass die GitLab-URL auf das Projektstammverzeichnis verweist (z. B. `https://gitlab.com/namespace/project`) und nicht auf einen Unterpfad, einen Branch oder eine `.git`-URL.

<hr />

### Liste der Integrationen

* [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)