- AppSignal mit Ihrem GitLab-Repository verknüpfen, damit AppSignal weiß, wo sich Ihr Code befindet.
- Backtraces mit Revisionen und Zeilen verknüpfen, damit jede Backtrace-Zeile den Code öffnet, der ausgeliefert wurde.
- GitLab-Issues für Vorfälle erstellen, direkt vom Detailbildschirm eines Vorfalls aus.
- Verknüpfte Issues vom Vorfall aus verfolgen, damit Sie ihren GitLab-Status sehen, ohne AppSignal zu verlassen. Diese Funktion ist in der Beta.
- Ein vorhandenes GitLab-Issue verknüpfen, über eine Notiz zum Vorfall. Diese Funktion ist in der Beta.
GitLab bietet mehrere Möglichkeiten, sich mit Tools von Drittanbietern zu
verbinden. AppSignal stellt die Verbindung über ein persönliches
GitLab-Zugriffstoken und Ihre Projekt-URL her, was auf GitLab.com, GitLab
Self-Managed und GitLab Dedicated unterstützt wird. GitLab bietet auch
OAuth-Anwendungen an, aber AppSignal unterstützt die Verbindung zu GitLab über
OAuth noch nicht.
AppSignal mit Ihrem GitLab-Repository verknüpfen
Schritt 1. Ein persönliches GitLab-Zugriffstoken erstellen
- Melden Sie sich bei GitLab an und gehen Sie zu Ihren Benutzer-Einstellungen.
- Wählen Sie in der linken Seitenleiste Access tokens aus und öffnen Sie dann Personal access tokens (
https://gitlab.com/-/user_settings/personal_access_tokensauf GitLab.com). - Wählen Sie Add new token. GitLab lässt Sie entweder ein fine-grained oder ein legacy personal access token erstellen. Wählen Sie legacy, da dessen Scopes direkt den Anforderungen von AppSignal entsprechen.
- Füllen Sie aus:
- Token name:
AppSignal - Expiration date: Wählen Sie ein Datum, das den Richtlinien Ihrer Organisation entspricht.
- Scopes: Wählen Sie
read_api,read_repositoryundapiaus. AppSignal benötigt alle drei.
- Token name:
- Wählen Sie Create personal access token und kopieren Sie das Token sofort. GitLab zeigt es nur einmal an.
Fine-grained Tokens funktionieren möglicherweise ebenfalls, aber ihre
Ressourcenberechtigungen sind weitaus granularer, und es ist nicht
offensichtlich, welche Kombination Sie wählen sollten. Wir planen, diese
Integration auf GitLab-OAuth-Anwendungen umzustellen, die neuere Art, Tools
von Drittanbietern mit GitLab zu verbinden.
Schritt 2. Die Integration in AppSignal hinzufügen
- Öffnen Sie in AppSignal die App, die Sie verbinden möchten.
- Gehen Sie zu App settings → Integrations. Wählen Sie unter Personal issue tracker integrations die Option Configure neben GitLab.
- Füllen Sie das Formular aus:
- Token: Fügen Sie das persönliche Zugriffstoken ein, das Sie in Schritt 1 erstellt haben. Der Hinweis am Feld nennt den Scope, den AppSignal benötigt.
- GitLab-URL: Die vollständige URL zum GitLab-Projekt, zum Beispiel
https://gitlab.com/your-namespace/your-project. Für GitLab Self-Managed verwenden Sie den Hostnamen Ihrer Instanz, z. B.https://gitlab.example.com/your-group/your-project.
- Wählen Sie Create integration.
Schritt 3. Für jeden Benutzer wiederholen
Da dies eine persönliche Integration ist, muss jedes Teammitglied, bei dem Quell-Links, Backtrace-Links oder die Erstellung von Issues im eigenen AppSignal-Account funktionieren sollen, die Schritte 1 und 2 mit dem eigenen GitLab-Token wiederholen.Backtraces mit Revisionen und Zeilen verknüpfen
Codebasen ändern sich ständig, daher ist ein Backtrace am nützlichsten, wenn er auf die Revision verweist, die zum Zeitpunkt des Fehlers deployt war. Das Verbinden von GitLab füllt die Repo URL Ihrer App automatisch aus, sodass Sie sie nicht von Hand eingeben müssen. Sie können sie unter App-Einstellungen → Allgemein bestätigen, wo das Feld die URL Ihres GitLab-Projekts enthält. AppSignal erkennt den Anbieter anhand dieser URL und erstellt die passenden Backtrace- und Vergleichslinks. Sobald Deploy-Marker die deployterevision melden, verknüpft AppSignal jede Backtrace-Zeile mit der passenden Revision, dem Pfad und der Zeile in Ihrem GitLab-Repository, sodass Sie von einem Fehler direkt zum ausgelieferten Code gelangen. Die vollständige Einrichtung finden Sie in der Dokumentation zu Backtrace-Links.
GitLab-Issues für Vorfälle erstellen
AppSignal erstellt keine GitLab-Issues automatisch, um eine Überflutung mit Stories zu vermeiden. So erstellen Sie eines für einen Fehler-Vorfall:- Öffnen Sie den Detailbildschirm des Fehler-Vorfalls.
- Wählen Sie im Panel Actions die Option Send to GitLab.
api-Scope zusätzlich zu den Lese-Scopes, die in Schritt 1 beschrieben sind.
Verknüpfte Issues vom Vorfall aus verfolgen
Diese Funktion ist in der Beta, als Teil von AppSignal Labs. Bitten Sie
den Support, sie für Ihre Organisation zu aktivieren.
- Premium und Ultimate: der Status so, wie GitLab ihn benennt, etwa To do oder ein benutzerdefinierter Status wie In review.
- Free: Open oder Closed.

- Ein neues Issue erhält sein Badge kurz nachdem Sie es an GitLab gesendet haben, sobald GitLab AppSignal darüber informiert.
- Issues, die vor dieser Funktion an GitLab gesendet wurden, zeigen kein Badge, bis sie sich das nächste Mal in GitLab ändern.
- Das Logbook zeigt nicht den ersten Status eines Issues, da es keinen früheren Status gibt, mit dem er verglichen werden kann.
- Badges funktionieren für ein GitLab-Projekt pro App. Wenn Sie und Ihre Teammitglieder unterschiedliche Projekte verbinden, zeigen nur Issues im zuletzt gespeicherten Projekt ein Badge.
Statusaktualisierungen aktivieren
GitLab sendet Statusänderungen über einen Webhook in Ihrem GitLab-Projekt an AppSignal. AppSignal fügt ihn hinzu, wenn Sie die Integration speichern:- Gehen Sie zu App settings → Integrations und wählen Sie Configure neben GitLab.
- Wählen Sie Update integration. Wenn die Integration neu ist, wählen Sie Create integration.
Ein vorhandenes GitLab-Issue verknüpfen
Um ein bereits vorhandenes GitLab-Issue zu verknüpfen, öffnen Sie den Tab Summary des Vorfalls. Schreiben Sie eine Notiz mit der URL des Issues in das Feld Logbook, zum Beispielhttps://gitlab.com/your-namespace/your-project/-/issues/42, und wählen Sie Post note.
Das Logbook verzeichnet Linked #42 on GitLab, und das Issue erscheint im Panel Actions. Sein Status-Badge erscheint, sobald sich das Issue das nächste Mal in GitLab ändert. Ein Kommentar allein zählt nicht.
Der AppSignal MCP-Server verknüpft Issues auf dieselbe Weise, wenn ein KI-Agent eine Notiz zu einem Vorfall schreibt.
AppSignal verknüpft ein Issue nur, wenn alle folgenden Bedingungen erfüllt sind. Andernfalls überspringt es die URL, und die Notiz wird trotzdem gepostet.
- Sie haben die GitLab-Integration selbst zur App hinzugefügt. AppSignal sucht das Issue mit Ihrem Token.
- Das Issue liegt in dem GitLab-Projekt, das Sie mit der App verbunden haben, und Ihr Token kann es lesen.
- Die Notiz enthält die vollständige URL des Issues, mit
/-/issues/oder/-/work_items/darin. Referenzen wie#42oderyour-group/your-project#42werden nicht verknüpft, ebenso wenig URLs von Merge Requests. - Das Issue ist noch nicht mit dem Vorfall verknüpft. Das Bearbeiten der Notiz erzeugt keine Duplikate.
Projekt wechseln oder die Integration entfernen
- Zu einem anderen GitLab-Projekt wechseln: Speichern Sie die Integration mit der URL des neuen Projekts. AppSignal verschiebt seinen Webhook in das neue Projekt. Sie benötigen die Rolle Maintainer oder Owner im neuen Projekt.
- Die Integration entfernen: AppSignal behält den Webhook, solange noch jemand anderes in der App die Integration verwendet. Es entfernt den Webhook, wenn die letzte Person sie entfernt.
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 derrevision-Konfigurationsoption oder das Markers-API-Beispiel, falls Ihr Stack keine AppSignal-Integration enthält.
Fehlerbehebung
AppSignal meldet, dass das Token nicht den api-Scope hat. AppSignal benötigtapi, um Issues zu erstellen. GitLab lässt Sie die Scopes eines Tokens nicht bearbeiten. Erstellen Sie ein neues legacy Token mit read_api, read_repository und api und speichern Sie es in AppSignal.
Das Senden eines Vorfalls an GitLab schlägt fehl.
Möglicherweise hat das Token nicht den api-Scope. AppSignal kann dies nicht prüfen bei Tokens, die gespeichert wurden, bevor AppSignal mit der Prüfung von Scopes begann, oder bei GitLab vor Version 15.5. Erstellen Sie ein neues Token mit allen drei Scopes und aktualisieren Sie die Integration in AppSignal.
Verknüpfte Issues zeigen kein Status-Badge.
Bestätigen Sie, dass das GitLab-Projekt den AppSignal-Webhook unter Settings → Webhooks in GitLab hat. Fehlt er, speichert ein Maintainer die Integration erneut, wie unter Statusaktualisierungen aktivieren beschrieben.
AppSignal konnte seinen Webhook nicht entfernen.
Ein Maintainer des GitLab-Projekts kann ihn unter Settings → Webhooks in GitLab löschen.
AppSignal meldet die GitLab-Integration als ungültig.
Prüfen Sie, welche Scopes das Token tatsächlich hat. read_registry und read_repository stehen in GitLabs Scope-Liste direkt nebeneinander, und ein Token, das read_registry statt read_api gewährt, kann Ihr Projekt nicht lesen.
Quell-Links in AppSignal öffnen nicht die richtige Datei.
Gehen Sie in AppSignal zu App settings → Integrations und wählen Sie Configure neben GitLab. Bestätigen Sie, dass die GitLab-URL auf das Projektstammverzeichnis verweist (z. B. https://gitlab.com/namespace/project), nicht auf einen Unterpfad, einen Branch oder eine .git-URL.