Zum Hauptinhalt springen
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.
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.
Website: 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.
Verwenden Sie read_api + read_repository anstelle des umfassenden api-Scopes. AppSignal muss nur Projektinformationen lesen, nicht in das Projekt schreiben.

​
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 für den empfohlenen Ansatz mit der revision-Konfigurationsoption oder das Markers-API-Beispiel, 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.

​
Liste der Integrationen