正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

チュートリアル: アナリティクスを利用したウェブサイトプロジェクトをセットアップする

  • プラン: Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

複雑なプロジェクト（ウェブサイトなど）に取り組む場合、他の人と協力してビルドおよびメンテナンスを行うことが多いでしょう。チームでのコントリビュートやコミュニケーションの方法は、プロジェクトを成功させることも失敗させることもあります。そのため、チームメンバーが共通の目標を共有し、達成できるようにするプロセスが必要です。アナリティクスのメトリクスは、チームの状況を理解し、より良く協力できるようにプロセスを調整する必要があるかどうかを判断するのに役立ちます。GitLabは、インスタンス、グループ、およびプロジェクトレベルでさまざまな種類のanalyticsインサイトを提供します。このリストが長く、どこから始めればよいかわからない場合は、このチュートリアルが最適です。

このチュートリアルでは、ウェブサイトプロジェクトの例をセットアップし、他のGitLabユーザーとコントリビュートし、プロジェクトレベルのアナリティクスレポートを使用してプロジェクトのビルドを評価する方法を学びます。

これから次の手順を実行します:

  1. テンプレートからプロジェクトを作成します。
  2. プロジェクトにユーザーを招待します。
  3. プロジェクトラベルを作成します。
  4. カスタムステージでバリューストリームを作成します。
  5. インサイトレポートを作成します。
  6. マージリクエストとイシュー分析を表示します。

はじめる前

  • プロジェクトを作成するグループのオーナーロールが必要です。

テンプレートからプロジェクトを作成

まず、グループにプロジェクトを作成する必要があります。

GitLabにはプロジェクトテンプレートが用意されており、さまざまなユースケースに必要なすべてのファイルを使用してプロジェクトを簡単にセットアップできます。ここでは、Hugoウェブサイトのプロジェクトを作成します。

プロジェクトを作成するには、プロジェクトを作成する:

  1. 左側のサイドバーの上部で、新規作成（ plus ）を選択し、新規プロジェクト/リポジトリを選択します。
  2. テンプレートから作成を選択します。
  3. Pages/Hugoテンプレートを選択します。
  4. プロジェクト名テキストボックスに、名前（たとえば、My website）を入力します。
  5. プロジェクトのURLドロップダウンリストから、プロジェクトを作成するグループを選択します。
  6. プロジェクトslugテキストボックスに、プロジェクトのslugを入力します（たとえば、my-website）。
  7. オプション。プロジェクトの説明テキストボックスに、プロジェクトのプロジェクトの説明を入力します。たとえば、「Hugoでビルドされたウェブサイトのアナリティクスを利用したプロジェクト」などです。この説明はいつでも追加または編集できます。
  8. 表示レベルで、プロジェクトに必要なレベルを選択します。グループにプロジェクトを作成する場合、プロジェクトの表示レベル設定は、親グループの表示レベルと同じか、それよりも制限的である必要があります。
  9. プロジェクトを作成を選択します。

これで、Hugoウェブサイトに必要なすべてのファイルを含むプロジェクトが作成されました。

プロジェクトにユーザーを招待

ウェブサイトのような大規模なプロジェクトに取り組む場合、デベロッパーやデザイナーなど、他の人とコントリビュートする必要があるでしょう。すべてのファイル、イシュー、レポートにアクセスできるように、プロジェクトに招待する必要があります。

My websiteプロジェクトにユーザーを招待するには:

  1. プロジェクトで、管理 > メンバーを選択します。
  2. メンバーを招待を選択します。
  3. ユーザーのユーザー名を入力します。
  4. ロールドロップダウンリストから、少なくともデベロッパーロールを選択します。ユーザーがアナリティクスを表示し、イシューとマージリクエストにコントリビュートするには、少なくともデベロッパーロールが必要です。
  5. オプション。アクセス有効期限ピッカーで、日付を選択します。招待されたメンバーが限られた時間のみプロジェクトにコントリビュートすることが予想される場合は、この手順をお勧めします。
  6. 招待を選択します。

招待されたユーザーは、プロジェクトのメンバーになっているはずです。プロジェクトのメンバーの表示、フィルター、および検索ができます。

プロジェクトラベルを作成

ラベルは、イシュー、マージリクエスト、およびエピックを整理および追跡するのに役立ちます。プロジェクトとグループに必要な数のラベルを作成できます。たとえば、このようなウェブサイトプロジェクトでは、feature requestとbugラベルが役立つ場合があります。

My websiteプロジェクトでプロジェクトラベルを作成するには:

  1. 管理>ラベルを選択します。
  2. 新しいラベルを選択します。
  3. タイトルフィールドにfeature requestと入力します。
  4. オプション。説明フィールドに、このラベルの使用方法と時期に関する追加情報を入力します。
  5. オプション。使用可能な色から選択するか、背景色フィールドに特定の色を表す16進数のカラー値を入力して、色を選択します。
  6. ラベルを作成を作成を選択します。

これでラベルがラベルリストに表示され、それを使用してカスタムステージでバリューストリームを作成できます。

カスタムステージでバリューストリームを作成

共同作業者がいるプロジェクトができたので、アクティビティーの追跡と視覚化を開始できます。バリューストリーム分析は、アイデアから本番環境までの時間を測定し、開発プロセスの非効率性を特定するのに役立ちます。アナリティクス機能のクリックスルーデモについては、バリューストリーム管理製品ツアーをご覧ください。

開始するには、My websiteプロジェクトでバリューストリームを作成します:

  1. 分析 > バリューストリーム分析を選択します。
  2. New Value Stream（新しいバリューストリーム）を選択します。
  3. バリューストリームの名前を入力します（たとえば、My website value stream）。
  4. デフォルトテンプレートから作成を選択します。
  5. カスタムステージを追加するには、ステージを追加するを選択します。
    • ステージの名前を入力します（たとえば、Labeled MRs merged）。
    • 開始イベントドロップダウンリストから、マージリクエストのラベルが追加されたを選択し、feature requestラベルを選択します。
    • Stop event（停止イベント）ドロップダウンリストから、マージリクエストがマージされたを選択します。
  6. Create value stream（バリューストリームを作成）を選択します。

バリューストリームを作成すると、データの収集とロードが開始されます。この処理にはしばらく時間がかかる場合があります。準備ができると、ダッシュボードが分析 > バリューストリーム分析に表示されます。

それまでの間、プロジェクトのインサイトレポートの作成を開始できます。

インサイトレポートを作成

バリューストリーム分析は開発プロセス全体の概要を示しますが、インサイトはプロジェクトのイシューの作成とクローズ、およびマージリクエストの平均マージ時間のより詳細なビューを提供します。このデータの視覚化は、イシューのトリアージをひとめで判断するのに役立ちます。

必要に応じて、さまざまなチャートを含むインサイトレポートを多数作成できます。たとえば、重大度別のバグの積み上げ棒チャートや、1か月間にオープンされたイシューの折れ線チャートなどです。

My websiteプロジェクトでインサイトレポートを作成するには:

  1. ファイルリストの上にあるプラスアイコンを選択し、新しいファイルを選択します。

  2. ファイル名テキストボックスに、.gitlab/insights.ymlと入力します。

  3. 大きなテキストボックスに、次のコードを入力します:

    bugsCharts:
   title: "Charts for bugs"
   charts:
      - title: "Monthly bugs created"
         description: "Open bugs created per month"
         type: bar
         query:
         data_source: issuables
         params:
            issuable_type: issue
            issuable_state: opened
            filter_labels:
               - bug
            group_by: month
            period_limit: 12

  4. 変更をコミットするを選択します。

これで、過去12か月間に毎月作成された~bugラベルの付いたイシューの数を表示するインサイトの棒チャートが作成されました。あなたと、少なくともデベロッパーロールを持つプロジェクトメンバーは、分析 > インサイトでレポートを表示できます。

マージリクエストとイシュー分析を表示

インサイトレポートに加えて、プロジェクトのマージリクエストとイシューの詳細なアナリティクスを取得できます。マージリクエスト分析とイシュー分析には、割り当て先、マージリクエストスループット、イシューステータスなどのメトリクスを含むチャートと表が表示されます。

マージリクエストとイシュー分析を表示するには、My websiteプロジェクトで、分析 > マージリクエスト分析または分析 > イシュー分析を選択します。

以上です。これで、チームと効率的にコントリビュートできる、アナリティクスを利用したウェブサイトプロジェクトができました。