debian-mirror-gitlab/doc/development/fe_guide/customizable_dashboards.md
2023-04-23 21:23:45 +05:30

3.4 KiB

stage group info
Analytics Product Analytics To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments

Customizable dashboards

Introduced in GitLab 15.5 as an Alpha feature.

Customizable dashboards provide a dashboard structure that allows users to create their own dashboards and commit the structure to a repository.

This feature is available for Premium and Ultimate subscriptions.

Usage

To use customizable dashboards:

  1. Create your dashboard component.
  2. Render an instance of CustomizableDashboard.
  3. Pass a list of panels to render.

For example, a customizable dashboard for users over time:

<script>
import CustomizableDashboard from 'ee/vue_shared/components/customizable_dashboard/customizable_dashboard.vue';
import { s__ } from '~/locale';

export default {
  name: 'AnalyticsDashboard',
  components: {
    CustomizableDashboard,
  },
  data() {
    return {
      panels: [
        {
          component: 'CubeLineChart', // The name of the panel component.
          title: s__('ProductAnalytics|Users / Time'), // The title shown on the panel component.
          // Gridstack settings based upon https://github.com/gridstack/gridstack.js/tree/master/doc#item-options.
          // All values are grid row/column numbers up to 12.
          // We use the default 12 column grid https://github.com/gridstack/gridstack.js#change-grid-columns.
          gridAttributes: {
            height: 4,
            width: 6,
            minHeight: 4,
            minWidth: 6,
            xPos: 0,
            yPos: 0,
          },
          // Options that are used to set bespoke values for each panel.
          // Available customizations are determined by the panel itself.
          customizations: {},
          // Chart options defined by the charting library being used by the panel.
          chartOptions: {
            xAxis: { name: __('Time'), type: 'time' },
            yAxis: { name: __('Counts') },
          },
          // The data for the panel.
          // This could be imported or in this case, a query passed to be used by the panels API.
          // Each panel type determines how it handles this property.
          data: {
            query: {
              users: {
                measures: ['TrackedEvents.count'],
                dimensions: ['TrackedEvents.eventType'],
              },
            },
          },
        },
      ]
    };
  },
};
</script>

<template>
  <h1>{{ s__('ProductAnalytics|Analytics dashboard') }}</h1>
  <customizable-dashboard :panels="panels" />
</template>

The panels data can be retrieved from a file or API request, or imported through HTML data attributes.

For each panel, a component is defined. Each component is a component declaration and should be included in vue_shared/components/customizable_dashboard/panels_base.vue as a dynamic import, to keep the memory usage down until it is used.

For example:

components: {
  CubeLineChart: () => import('ee/product_analytics/dashboards/components/panels/cube_line_chart.vue')
}