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

複雑なプロジェクト（ウェブサイトなど）に取り組む場合、他の人と協力して構築やメンテナーを行うことが多いでしょう。チーム内での共同作業やコミュニケーションの方法はプロジェクトの成否を左右するため、チームメンバーが共通の目標に従って達成できるようなプロセスが必要です。アナリティクスのメトリクスは、チームの状況を把握し、より良い協力関係を築くためにプロセスを調整する必要があるかどうかを理解するのに役立ちます。GitLabはインスタンス、グループ、プロジェクトレベルで異なるタイプのアナリティクスインサイトを提供します。もしこのリストが長く感じられ、何から始めたらいいのかわからないのであれば、このチュートリアルをご覧ください。

サンプルのウェブサイトプロジェクトをセットアップし、他のGitLabユーザーと協力し、プロジェクトレベルのアナリティクスレポートを使ってプロジェクトの開発を評価する方法を学びましょう。

前提条件

  • プロジェクトを作成するグループのオーナーロールを持っている必要があります。

これから行うことの概要です：

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

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

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

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

プロジェクトを作成します：

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

これで、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. Analyze > Value Stream Analyticsを選択します。
  2. Create new Value Stream を選択します。
  3. バリューストリームの名前を入力します（例：My website value stream ）。
  4. デフォルトのテンプレートから作成］を選択します。
  5. カスタムステージを追加するには、Add another stageを選択します。
    • ステージの名前を入力します（例：Labeled MRs merged ）。
    • 開始イベント］ドロップダウンリストで、［マージリクエストラベルが追加されました］を選択し、次に［feature request ］ラベルを選択します。
    • 停止イベントドロップダウンリストから、マージリクエストがマージされましたを選択します。
  6. 値のストリームを作成] を選択します。

バリュー・ストリームを作成すると、データの収集と読み込みが始まります。このプロセスにはしばらく時間がかかる場合があります。準備が整うと、ダッシュボードが [Analyze] > [Value Stream Analytics] に表示されます。

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

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

バリューストリームアナリティクスは開発プロセス全体の概要を示しますが、インサイトはプロジェクトのイシューの作成とクローズ、マージリクエストの平均マージ時間など、より詳細なビューを提供します。このデータ可視化は、一目で問題をトリアージするのに役立ちます。

インサイトでは、必要な数だけさまざまなチャートのレポートを作成できます。たとえば、深刻度別のバグの積み上げ棒グラフや、月間にオープンされたイシューの折れ線グラフなどです。

インサイトレポートを作成するには、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. 変更をコミット を選択します。

これで、~bug というラベルが作成されたイシューの数を過去 12 か月ごとに表示するインサイト棒グラフができました。あなたと、少なくとも開発者ロールを持つプロジェクト・メンバーは、[分析] > [インサイト] でインサイト・レポートを表示できます。

マージリクエストとイシューの分析を見る

インサイトレポートに加えて、プロジェクトのマージリクエストとイシューに関する詳細な分析結果を得ることができます。マージリクエスト分析および課題分析では、担当者、マージリクエストのスループット、課題のステータスなどのメトリクスを図表で表示します。

マージリクエスト分析および課題分析を表示するには、My website プロジェクトで [分析] > [マージリクエスト分析] または [分析] > [課題分析] を選択します。

以上です！これでアナリティクスを活用したウェブサイトプロジェクトが完成し、チームと効率的にコラボレーションできるようになりました。