翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# GitLab データソースへの接続
<a name="gitlab-AMG-datasource"></a>

GitLab データソースを使用すると、上位の寄与者、1 日あたりのコミット数、1 日あたりのデプロイ数など、GitLab の詳細な統計を追跡できます。プロジェクトなどのテンプレート変数を使用すると、ダッシュボードのフィルターを設定することもできます。GitLab API のデータは他のソースのデータと組み合わせることができます。

**注記**  
このデータソースは、Grafana Enterprise 専用です。詳細については、「[Enterprise プラグインへのアクセス許可の管理](upgrade-to-enterprise-plugins.md)」を参照してください。  
さらに、バージョン 9 以降をサポートするワークスペースでは、このデータソースに適切なプラグインをインストール必要がある可能性があります。詳細については、「[プラグインを使用したワークスペースの拡張](grafana-plugins.md)」を参照してください。

## 既知の制限事項
<a name="gitlab-known-limitations"></a>

GitLab API の未加工データから意味のある集計メトリクスを取得する唯一の方法は変換ですが、アラートクエリでは変換がサポートされていないため、このプラグインではアラートがまだサポートされていません。

## データソースの追加
<a name="gitlab-adding-the-data-source"></a>

1.  Amazon Managed Grafana ワークスペースで Grafana コンソールを開いて、ログインしていることを確認します。

1.  [**設定**] (歯車アイコン) のサイドメニューで、[**データソース**] を選択します。

1.  **[データソースの追加]** を選択します。
**注記**  
 サイドメニューに **[データソース]** リンクが表示されていない場合は、現在のユーザーに `Admin` ロールが付与されていないことを意味します。

1.  データソースのリストから **[GitLab]** を選択します。

1. 次の情報を入力します。
   + **[名前]** に、この GitLab データソースの名前を入力します。
   + **[URL]** に、**https://gitlab.com/api/v4** などの GitLab インスタンスのルート URL を入力します。
   + **[アクセストークン]** に、GitLab パーソナルアクセストークンを入力します。

## GitLab データソースのクエリ
<a name="gitlab-query"></a>

GitLab クエリエディタから、コミット、問題点、リリースなどの、さまざまなリソースタイプを選択できます。

**プロジェクトのフィルタリングおよび表示**

1.  ドロップダウンリストから、**[プロジェクト]** を選択します。

1.  (オプション) 所有するプロジェクトでフィルタリングします。

1.  ドロップダウンを使用して、**[あり]** または **[いいえ]** を選択して結果をフィルタリングします。
**注記**  
 すべてのプロジェクトの取得 **[所有 = いいえ]** には時間がかかる場合があります。

**コミットのフィルタリングおよび表示**

1.  ドロップダウンメニューから、**[コミット]** を選択します。

1.  入力フィールドを使用してプロジェクト ID を追加します。

1.  (オプション) ブランチ/タグでフィルタリングするには、入力フィールドを使用してブランチ/タグのリファレンスを追加します。

**問題点のフィルタリングおよび表示**

1.  ドロップダウンメニューから、**[問題点]** を選択します。

1.  入力フィールドを使用してプロジェクト ID を追加します。

1.  (オプション) タイトル/説明でフィルタリングするには、入力フィールドを使用して、**[タイトル]** と **[説明]** に基づいて問題を検索します。

**リリースの表示**

1.  ドロップダウンメニューから **[デプロイ]** を選択します。

1.  入力フィールドを使用してプロジェクト ID を追加します。

1.  (オプション) 環境/ステータスでフィルタリングするには、入力フィールドを使用します。**[ステータス]** は、`created`、`running`、`success`、`failed`、`canceled` のいずれかの値になります。

**ラベルの表示**

1.  ドロップダウンメニューから、**[ラベル]** を選択します。

1.  入力フィールドを使用してプロジェクト ID を追加します。

## テンプレートおよび変数
<a name="gitlab-templates"></a>

新しい GitLab クエリ変数を追加するには、「[クエリ変数の追加](variables-types.md#add-a-query-variable)」を参照してください。ご使用の GitLab データソースをデータソースとして使用します。リソースタイプを **[リリース]**、**[プロジェクト]**、または **[ラベル]** から選択します。

プロジェクト、ラベルなどの動的リストを選択して取得するには、クエリタイプ変数を作成します。クエリタイプの変数は GitLab クエリエディタを使用して、プロジェクト、ラベルなどをクエリして返します。次の例では、ご使用のクエリをパラメータ化するプロジェクト変数を作成します。

**クエリをパラメータ化するプロジェクト変数の作成**

1.  **project** という名前の **[クエリ]** タイプの変数を追加します。

1.  GitLab データソースを選択して **[ダッシュボード上のロード]** を更新します。

1.  **[プロジェクト]** リソースタイプを選択し、**[所有]** に **[あり]**、**[表示フィールド]** に **[名前]**、**[値フィールド]** に **[ID]** を選択します。

1. **[更新]** を選択してダッシュボードに変数を追加します。

1. ダッシュボードに新しいパネルを追加して、**\$1project** をプロジェクト ID として使用します。

   ドロップダウンから選択すると、そのプロジェクトに属する結果を得られるようになりました。

## Grafana からの変換を使用して一般的な質問に答える
<a name="gitlab-transformations"></a>

これで、基本的な GitLab クエリを実行してコミットや問題点などを検索できるようになりました。変換を使用してデータセットを視覚化、集計、グループ化、結合したり、他のタイプの変換を使用して単純な結果を複雑な質問に対する回答に変換したりできます。以下は、いくつかの一般的な質問と、変換を使用して回答する方法です。

**プロジェクトでのコミット/問題点/デプロイは 1 日に何回ですか?**

1.  クエリを追加します。リソースタイプの **[コミット]** を選択してプロジェクト ID を追加します。

1.  新しい **[グループ化の条件]** 変換を追加: **[グループ化の条件]** では、**[create\$1at\$1date]** を選択してから **[(Count)=id]** を計算します。

1. **[グラフ]** の視覚化を選択します。

**プロジェクトで問題点を終了するまでの平均時間はどのくらいですか?**

1.  クエリを追加します。リソースタイプの **[問題点]** を選択してプロジェクト ID を追加します。

1.  新しい **[計算変換からフィールドを追加]** 変換を追加: **[モード]** で **[バイナリオペレーション]** を選択し、**[オペレーション]** で **[closed\$1at = created\$1at]** を選択し、**[エイリアス]** で **[resolution\$1time]** を選択します。

1.  新しい **[計算変換からフィールドを追加]** 変換を追加: **[モード]** で **[バイナリオペレーション]** を選択し、**[オペレーション]** で **[resolution\$1time / 86400000]** を選択し、**[エイリアス]** で **[resolution\$1time]** を選択します。

   **[すべてのフィールド を置き換え]** で **[真]** を選択します。

1. **[統計]** 視覚化を選択します。
   + 表示 = 計算
   + 計算 = 平均
   + フィールド = **[resolution\$1time]**