仪表板 Insights

Insights 是 Directus 中的一个模块,它允许快速、无代码地构建分析仪表板。 无论您的用例如何(无论是商业智能、用户进度跟踪、网络流量转换,还是其他!) 您只需单击几下即可设置关键数据指标。

它如何工作

首先,创建一个仪表板,然后用面板填充仪表板。

  1. 单击页眉中的“创建仪表板”操作按钮add
  2. 填写仪表盘名称、图标和注释。
  3. 点击“保存”。
  4. 单击页眉中的编辑图标。
  5. 点击页眉中的“创建面板”add
  6. 选择面板类型。 了解有关面板类型的更多信息
  7. 调整面板选项以自定义分析指标。
  8. 单击抽屉标题中的check 以创建面板。
  9. 单击页眉中的check 以确认所有编辑。

仪表板概述

仪表板网格区域

每个 Directus 仪表板都提供了一个拖放式画布,您可以在其中创建和排列不同的面板以轻松构建自定义分析。随着您添加越来越多的面板,仪表板区域会自动扩展。理论上,仪表板区域可以无限扩大……但在实践中,用户可能只想构建与他们将在其上查看的屏幕一样大的仪表板。您可以根据需要创建任意数量的仪表板。此外,仪表板的查看、编辑和创建权限是由用户角色完全可配置

自动刷新
Sidebar 中的 Auto Refresh 菜单可让您选择刷新仪表板数据的时间间隔。

创建、编辑和删除仪表板

如何在 Directus Insights 中添加、编辑和删除仪表板

  1. 单击页眉中的 add 图标以创建新的仪表板。
  2. 单击项目选项以编辑或删除仪表板。

面板概述

Directus 仪表板面板

面板是我们添加到 Insights 仪表板上以创建、保存和显示数据分析的构建块。面板有五种类型,每一种都提供一些独特的分析工具。

  1. 标签 - 显示简单的标题文本以描述其他面板组。实际上并不提供数据分析。
  2. List – 集合中可排序、可过滤的项目列表。
  3. Metric – 可排序、可过滤的单数指标,例如总和、平均值、最小值和最大值,或第一个和最后一个。
  4. 时间序列 – 显示指标如何随时间变化的图表。提供相同的排序、过滤和聚合在列表和指标面板中看到的功能。
  5. 全局变量 - 设置一个可在其他面板全局访问的变量。

面板标题选项

面板标题选项

所有 4 种面板类型都允许您设置自定义文本,以提供有关面板所代表内容的快速清晰的上下文。对于所有四种面板类型,面板标题选项完全相同。标题也是完全可选的,可以隐藏。

  • Visible - 确定标题是否可见。
  • 名称 - 在标题区域设置名称。
  • Icon - 按名称设置一个小图标。
  • 颜色 - 设置图标的颜色。
  • 注意 - 设置图标的简短描述。

标签

标签面板选项

顾名思义,此面板仅允许您为一组其他面板添加标签。标签不提供分析。标签只是帮助直观地对其他面板进行分组(确实提供分析)并为您的仪表板提供上下文。

  • Label - 设置标签文本。
  • 颜色 - 设置标签文本颜色。

列表

列表面板选项

列表面板显示集合中的一些项目,作为列表! 这些显示的项目也可以按其他条件过滤。因此,例如,您可以展示您最畅销的 5 个产品、3 个表现最差的销售地区、10 名 GPA 最高的学生 _也参加校内运动,或者创建任何其他类型的排名和/或过滤列表,这些列表可以从您的数据集。

  • Collection - 选择要排名的集合。
  • 限制 - 限制将出现在仪表板中的项目数量。
  • 排序字段 - 设置您希望排序结果的集合字段。
  • 排序方向 - 设置项目以升序或降序显示。
  • 显示模板 - 定义列表项的表示方式。允许使用字段项值以及自定义文本。
  • 过滤器 - 将过滤器设置为仅考虑和排名符合某些条件的项目。

指标

指标面板选项

指标面板允许您将字段中的所有项目汇总为单个值。

  • Collection - 选择集合。
  • Field - 选择要在其上运行聚合函数的字段。
  • 聚合函数 - 选择要执行的聚合类型。
  • 排序字段 - 设置您希望对结果进行排序的集合字段。
  • 过滤器 - 将过滤器设置为仅对满足某些条件的项目运行指标。

更多关于聚合函数

一般来说,聚合函数采用一系列值并返回一个值。

  • Count - 计算字段中的项目数。
  • Count (Distinct) – 计算字段中 unique 项的数量。
  • Average – 字段中所有项目的平均值。
  • Average (Distinct) – 字段中所有 unique 项的平均值。
  • Sum – 对字段中所有项目的值求和。
  • Sum (Distinct) – 对字段中所有 unique 项的值求和。
  • Minimum – 选择字段中价值最低的项目。
  • Maximum – 选择字段中价值最高的项目。
  • First – 从字段中的所有项目中选择第一个项目。
  • Last – 从字段中的所有项目中选择最后一个项目。

第一个、最后一个、最小值和最大值
First、Last、Minimum 和 Maximum 不是纯粹数学意义上的聚合。 但是,它们被放置在此面板选项中,因为它们返回一个项目。

为什么有些字段是灰色的?
某些字段不能与某些聚合函数一起使用。 例如,您不能对存储文本的字段使用平均函数,因为无法对文本进行平均。 当面板选项之间存在冲突时,“字段下拉列表”中的字段将灰显且不可选择。

样式和格式选项

  • 缩写值 – 用字母 _ 缩写大数字(例如 2,000 = 2K)_。
  • 小数 - 更改显示的小数位数。
  • 前缀 - 在聚合指标之前添加文本。
  • 后缀 - 在聚合指标之后添加文本。
  • 条件样式 - 如果是 >>=<<===!=,则将显示的数字的颜色更改为某个定义的值。

时间序列

时间序列面板选项

时间序列面板允许您构建图表并查看数据如何随时间变化。

  • Collection - 选择要分析的集合。
  • 颜色 - 设置图形曲线的颜色。
  • Group Aggregation – 选择要执行的聚合类型。 了解更多
  • 组精度 - 设置按_(天、周、月等)_聚合的时间间隔。
  • 日期字段 - 选择沿 x 轴使用的日期时间字段。
  • 日期范围 - 设置应显示数据的时间范围,可以自定义。
  • 值字段 - 设置您希望聚合的字段。
  • Value Decimals - 更改 y 轴上显示的小数位数。
  • Min Value – 设置在 y 轴上显示的最小值。
  • Max Value – 设置 y 轴上显示的最大值。
  • 曲线类型 - 将曲线设置为平滑、直线或阶梯线。
  • 填充类型 - 将曲线下的填充类型设置为渐变、纯色或无。
  • 过滤器 - 允许根据逻辑条件过滤考虑进行分析的项目。
  • 显示 X 轴 - 沿 X 轴切换时间显示。
  • 显示 Y 轴 - 切换沿 Y 轴显示数值。

仅面向时间的指标
为了使用此面板,您的集合将需要一个日期时间字段。

自定义日期范围
请注意,“过去”没有作为自定义范围的前缀,因为它位于默认范围内。 选择 **“其他”**时,只需输入“3 年”、“1 个月”、“2 周”、“5 天”等即可。

全局变量

全局变量

  • 变量键 - 设置您的变量。使用此键可访问其他 Insights 面板中的变量。
  • Type - 设置变量的数据类型。
  • 默认值 - 为全局变量设置默认值。
  • Interface - 选择要使用的接口。
  • Options - 设置界面选项。

此面板允许您创建一个可在其他面板中全局访问的变量。您可以使用它来执行诸如创建字符串或数字以作为其他洞察面板标题的前缀或将其作为值传递到过滤器以查询结果的操作。

要创建和分配全局变量,请按照 工作原理 中的步骤,选择全局变量面板。用双胡子语法包装变量键,以在其他洞察面板中访问和分配它:

{{ your_variable_key }}

您会注意到全局变量面板是仪表板中的一个界面,允许您修改此变量的值。如果您更改其值,所有引用该变量的面板将自动更新。

必须是有效的数据类型
您的变量的数据类型需要与您使用它的任何位置有效匹配。例如,不要在需要日期时间数据的地方应用字符串或 JSON 变量。

Bar Chart

Dashboard edit page with a bar chart options panel visible.

Availability
The Bar Chart Panel is only available in Directus Cloud and Enterprise Self-Hosted projects.

The Bar Chart Panel allows you to build vertical and horizontal bar charts from data held in collections.

  • Collection – 选择要分析的集合。
  • Horizontal – 如果启用,条形图将是水平的(从 y 轴开始)。
  • X-Axis – 字段显示在 x 轴上。
  • Y-Axis – y 轴上显示的字段。
  • Value Decimals – 更改两个轴上显示的小数位数。
  • Color – 设置条形图的默认颜色。
  • Filter – 允许根据逻辑条件过滤考虑进行分析的项目。
  • Conditional Styles – 如果条的值是>>=<<===!=,则改变条的颜色value.

Line Chart

Dashboard edit page with a line chart options panel visible.

可用性
折线图面板仅在 Directus Cloud 和企业自托管项目中可用。

The Line Chart Panel allows you to build line charts from data held in collections, and are often used for time-series data.

  • Collection – 选择要分析的集合。
  • X-Axis – 字段显示在 x 轴上。
  • Y-Axis – y 轴上显示的字段。
  • Group Aggregation – 选择要执行的聚合类型。 如果您只能选择要显示在 x 轴上的字段。
  • Function – 选择要执行的聚合类型。
  • Filter – 允许根据逻辑条件过滤考虑进行分析的项目。
  • Value Decimals – 更改两个轴上显示的小数位数。
  • Color – 设置线条的默认颜色。
  • Show Axis Labels – 选择是否显示轴标签以及在哪个轴标签上显示。
  • Show Tooltip Marker – 如果启用,则在数据点悬停时显示数据。
  • Curve Type – 选择曲线的样式 - 平滑、笔直或阶梯状。
  • Conditional Styles – 如果线的值为>>=<<===!=,则更改线的颜色 value.

Meter

Dashboard edit page with a meter options panel visible.

可用性
仪表面板仅在 Directus 云和企业自托管项目中可用。

仪表面板采用最大值并允许您显示给定第二个值的完成百分比。

  • Collection – 选择要分析的集合。
  • Field – 选择要在其上运行聚合函数的字段。
  • Function – 选择要执行的聚合类型。
  • Maximum – 设置最大值(仪表的 100%)。
  • Filter – 允许根据逻辑条件过滤考虑进行分析的项目。
  • Size – 将刻度盘设置为整圈或半圈。
  • Stroke Width – 设置仪表刻度线的粗细。
  • Color – 设置表盘的默认颜色。
  • Rounded Stroke – 如果启用,将帽样式更改为圆形。
  • Conditional Styles – 如果仪表的值为“>”、“>=”、“<”、“<=”、“==”或“!=”,则将仪表的颜色更改为某个定义的值。

Pie or Donut Chart

Dashboard edit page with a pie or donut options panel visible.

可用性
饼图和圆环图面板仅在 Directus Cloud 和企业自托管项目中可用。

饼图和圆环图允许您根据数据创建分段图表。

  • Collection – 选择要分析的集合。
  • Field – 选择要在其上运行聚合函数的字段。
  • Function – 选择要执行的聚合类型。
  • Donut – 如果启用,则会从图表中心切出一个圆圈。
  • Show Labels – 如果启用,百分比值将显示在每个段中。
  • Show Legend – 选择是否显示图例以及显示图例的位置 - 无、右侧或底部。
  • Filter – 允许根据逻辑条件过滤考虑进行分析的项目。
  • Value Decimals – 更改图表段中显示的小数位数。
  • Color – 设置第一段的默认底色。 其他段将是此默认值的变体。
  • Conditional Styles – 如果段的值为“>”、“>=”、“<”、“<=”、“==”或“!=”,则将段的颜色更改为某个定义的值。