

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Stellen Sie eine Connect zu einer GitLab Datenquelle her
<a name="gitlab-AMG-datasource"></a>

Mit der GitLab Datenquelle können Sie detaillierte GitLab Statistiken verfolgen, z. B. zu den wichtigsten Mitwirkenden, Commits pro Tag oder Deployments pro Tag. Sie können auch Vorlagenvariablen wie Projekte verwenden, um Filter für Ihre Dashboards einzurichten. Sie können Daten aus der GitLab API mit Daten aus anderen Quellen kombinieren.

**Anmerkung**  
Diese Datenquelle ist nur für Grafana Enterprise bestimmt. Weitere Informationen finden Sie unter [Zugriff auf Enterprise-Plugins verwalten](upgrade-to-enterprise-plugins.md).  
In Workspaces, die Version 9 oder neuer unterstützen, müssen Sie für diese Datenquelle möglicherweise außerdem das entsprechende Plugin installieren. Weitere Informationen finden Sie unter [Erweitere deinen Workspace mit Plugins](grafana-plugins.md).

## Bekannte Beschränkungen
<a name="gitlab-known-limitations"></a>

Warnmeldungen werden in diesem Plugin noch nicht unterstützt, da Transformationen in Warnungsabfragen nicht unterstützt werden und Transformationen die einzige Möglichkeit sind, aussagekräftige aggregierte Metriken aus GitLab API-Rohdaten zu erhalten.

## Hinzufügen der Datenquelle
<a name="gitlab-adding-the-data-source"></a>

1.  Öffnen Sie die Grafana-Konsole im Amazon Managed Grafana-Arbeitsbereich und stellen Sie sicher, dass Sie angemeldet sind. 

1.  Wählen Sie im Seitenmenü unter **Konfiguration** (das Zahnradsymbol) die Option **Datenquellen** aus. 

1.  Wählen Sie **Datenquelle hinzufügen** aus. 
**Anmerkung**  
 Wenn Sie den Link **Datenquellen** nicht in Ihrem Seitenmenü sehen, bedeutet dies, dass Ihr aktueller Benutzer die `Admin` Rolle nicht hat. 

1.  Wählen Sie **GitLab**aus der Liste der Datenquellen aus. 

1. Geben Sie die folgenden Informationen ein:
   + Geben Sie unter **Name** einen Namen für diese GitLab Datenquelle ein.
   + Geben Sie unter **URL** die Stamm-URL für Ihre GitLab Instanz ein, z. **https://gitlab.com/api/v4** B.
   + Geben Sie **unter Zugriffstoken** Ihr GitLab persönliches Zugriffstoken ein.

## Fragen Sie die GitLab Datenquelle ab
<a name="gitlab-query"></a>

Im GitLab Abfrage-Editor können Sie verschiedene Ressourcentypen auswählen, z. B. Commits, Issues oder Releases.

**Projekte filtern und anzeigen**

1.  Wählen Sie im Dropdownmenü **Projekte** aus. 

1.  (Optional) Filtern Sie nach den Projekten, deren Eigentümer Sie sind. 

1.  Verwenden Sie die Dropdownliste und wählen Sie **Ja** oder **Nein** aus, um die Ergebnisse zu filtern. 
**Anmerkung**  
 Das Abrufen aller Projekte im **Besitz = Nein** kann sehr lange dauern. 

**Commits filtern und anzeigen**

1.  **Wähle im Drop-down-Menü Commits aus.** 

1.  Verwenden Sie das Eingabefeld, um die Projekt-ID hinzuzufügen. 

1.  (Optional) branch/tag Verwenden Sie zum Filtern das Eingabefeld, um eine branch/tag Referenz hinzuzufügen. 

**Probleme filtern und anzeigen**

1.  Wählen Sie im Drop-down-Menü die Option **Probleme** aus. 

1.  Verwenden Sie das Eingabefeld, um die Projekt-ID hinzuzufügen. 

1.  **(Optional) Um nach Titel/Beschreibung zu filtern, verwenden Sie das Eingabefeld, um Probleme anhand ihres **Titels** und ihrer Beschreibung zu suchen.** 

**Pressemitteilungen anzeigen**

1.  Wählen Sie im Dropdownmenü die Option **Bereitstellungen** aus. 

1.  Verwenden Sie das Eingabefeld, um die Projekt-ID hinzuzufügen. 

1.  (Optional) Verwenden Sie die Eingabefelder, um nach Umgebung/Status zu filtern. Das **Statusattribut** kann einer der folgenden Werte sein:`created`,, `running` `success``failed`, oder. `canceled` 

**Beschriftungen anzeigen**

1.  Wählen Sie im Dropdownmenü die Option **Labels** aus. 

1.  Verwenden Sie das Eingabefeld, um die Projekt-ID hinzuzufügen. 

## Vorlagen und Variablen
<a name="gitlab-templates"></a>

Informationen zum Hinzufügen einer neuen GitLab Abfragevariablen finden Sie unter[Hinzufügen einer Abfragevariablen](variables-types.md#add-a-query-variable). Verwenden Sie Ihre GitLab Datenquelle als Datenquelle. Wählen Sie einen Ressourcentyp: **Veröffentlichungen**, **Projekte** oder **Labels**.

Um eine dynamische Liste von Projekten, Labels usw. zur Auswahl zu erhalten, erstellen Sie eine Variable vom Typ Abfrage. Variablen vom Typ Abfrage verwenden den GitLab Abfrage-Editor, um Projekte, Labels usw. abzufragen und zurückzugeben. Im folgenden Beispiel wird eine Project-Variable erstellt, um Ihre Abfragen zu parametrisieren

**Erstellen Sie eine Project-Variable, um Ihre Abfragen zu parametrisieren**

1.  Fügen Sie eine Variable vom Typ **Query** named hinzu. **project** 

1.  Wählen Sie Ihre GitLab Datenquelle aus und aktualisieren Sie sie **beim Laden des Dashboards**. 

1.  Wählen Sie den Ressourcentyp „**Projekte****“, „Ja“ für „****Eigentümer**“, **„Name**“ für **das Anzeigefeld und „****id**“ für **das Wertfeld**. 

1. Wählen Sie „**Aktualisieren**“, um die Variable zum Dashboard hinzuzufügen.

1. Fügen Sie dem Dashboard ein neues Panel hinzu und verwenden Sie **\$1project** es als Projekt-ID.

   Wenn Sie jetzt aus der Drop-down-Liste auswählen, erhalten Sie die Ergebnisse, die zu diesem Projekt gehören.

## Verwendung von Transformationen von Grafana zur Beantwortung häufig gestellter Fragen
<a name="gitlab-transformations"></a>

Da Sie nun grundlegende GitLab Abfragen durchführen können, um Commits, Probleme usw. zu finden, können Sie Transformationen verwenden, um Datensätze zu visualisieren, zu aggregieren, zu gruppieren und zu verbinden, zusammen mit vielen anderen Arten von Transformationen, um einfache Ergebnisse in Antworten auf komplexe Fragen umzuwandeln. Im Folgenden finden Sie einige häufig gestellte Fragen und wie Sie diese mithilfe von Transformationen beantworten können.

**Wie viele commits/issues/deployments pro Tag in meinem Projekt?**

1.  Fügen Sie eine Abfrage hinzu. Wählen Sie **Commits** als Ressourcentyp aus und fügen Sie die Projekt-ID hinzu. 

1.  **Fügen Sie eine neue **Gruppe nach** Transformation hinzu: Wählen Sie für **Group by** die Option **created\$1at\$1date** aus und berechnen Sie dann (Count) =id** 

1. **Wählen Sie die Grafikvisualisierung aus.**

**Wie lange dauert es durchschnittlich, Probleme in meinem Projekt zu lösen?**

1.  Fügen Sie eine Abfrage hinzu. Wählen Sie **Probleme** als Ressourcentyp aus und fügen Sie die Projekt-ID hinzu. 

1.  ****Fügen Sie ein neues **Feld aus der Berechnungstransformation hinzufügen hinzu**: Wählen Sie für **Modus** die Option **Binäre Operation, für **Operation**** die Option **closed\$1at = created\$1at und für Alias die Option resolution\$1time** aus.**** 

1.  ******Fügen Sie ein neues **Feld aus der Berechnungstransformation hinzufügen hinzu**: Wählen Sie für **Modus** die Option **Binäre Operation, für Operation** die Option resolution\$1time/86400000 und für Alias die Option **resolution\$1time** aus.****** 

   **Wählen **Sie** für Alle Felder ersetzen die Option True aus.**

1. Wählen Sie die **Statistik-Visualisierung** aus.
   + Zeigen = Berechnen
   + Berechnung = Mittelwert
   + Felder = **resolution\$1time**