> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 图表

> 分析时间序列数据，创建计算，设置阈值，监控警报，评估数据质量，并可视化活动。

<a id="create-a-chart" />

## 创建图表

<Steps>
  <Step title="导航到图表">
    导航到 **Flows** > **图表**。
  </Step>

  <Step title="创建一个新图表">
    选择 **+ 新图表** 开始一个新图表。要在现有图表的基础上构建，请选择图表右侧的 ⋮ > **复制**。

    <Frame>
      <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/charts_toolbars_v1.svg" alt="图表工具栏" />
    </Frame>

    ➀ **工具栏** — 将鼠标悬停在每个工具上以查看描述。使用 **滑块** 查看或比较时间序列值。
    ➁ **打开...** — 下载、复制、删除或 **在 **画布** 中打开图表**。
    ➂ **添加数据** — 添加一个 **时间序列**，或导入或创建一个 **计算**。
    ➃ **代理** — 打开一个 **AI 代理** 以与图表进行交互。
    ➄ **侧边栏** — 设置 **警报**、**监控**、**阈值** 或数据 **分析**。添加 **事件** 和 **活动**。
  </Step>
</Steps>

<a id="use-an-agent-to-find-and-analyze-data" />

### 使用代理查找和分析数据

<Frame>
  <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/charts_agent_v4.svg" alt="图表中的地图" width="60%" />
</Frame>

➀ **新会话** — 开始与代理的新对话。

➁ **选择位置** — 查看您当前的位置。选择位置以选择代理可以访问的数据。

➂ **选择代理** — 选择您想要开始对话的代理。

<Info>
  要与代理互动，您需要这些 [能力](/cdf/access/guides/capabilities#atlas-ai)。

  了解更多关于[Atlas AI](/cdf/atlas_ai/concepts/index)的信息。
</Info>

<a id="add-a-time-series" />

### 添加时间序列

要将时间序列添加到您的图表中：

<Steps>
  <Step title="打开添加时间序列">
    选择**添加数据**> **添加时间序列**。
  </Step>

  <Step title="选择并添加时间序列">
    查找并选择时间序列 > **添加**。
    针对每个时间序列和计算，探索设置单位和微调数据显示的各种方式。例如，尝试调整图形线条的粗细和颜色。点击<Icon icon="info" />以获取更多详细信息。
  </Step>
</Steps>

<a id="add-a-calculation" />

### 添加计算

要添加计算：

<Steps>
  <Step title="创建一个计算">
    选择**添加数据**> **创建计算**。
  </Step>

  <Step title="添加输入源">
    选择**添加节点**或右键单击图表下方的面板以添加输入源。

    <Frame>
      <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/calculation.png" alt="图表计算" />
    </Frame>
  </Step>

  <Step title="添加常量或函数">
    右键单击面板以添加**常量**或**函数**到计算中。选择<Icon icon="info" />以查看函数详细信息，或将鼠标悬停在参数上以获取更多信息。
  </Step>

  <Step title="配置输出">
    按顺序连接计算，并包括最终的**输出**节点以在图表上显示结果。

    <Info>
      将一个计算作为另一个的输入，以查看每一步的输出。
    </Info>
  </Step>
</Steps>

<a id="schedule-a-calculation" />

### 安排计算

安排计算并将结果保存为时间序列。您还可以[监控](#monitor-time-series)计算。

<Steps>
  <Step title="保存并安排">
    [添加计算](#add-a-calculation)并选择**保存和安排**。
  </Step>

  <Step title="指定凭据">
    指定计划的登录凭据，然后点击**下一步**。如果您不知道凭据，请联系您的CDF管理员。
    给计划命名并指定必要的设置。
    选择开始计划。
  </Step>
</Steps>

<a id="trend-data" />

### 归纳数据趋势

要堆叠、叠加和比较时间序列的趋势，点击并拖动或悬停并滚动以调整和移动每个图表轴。
使用工具栏上的滑块查看或比较特定时间的时间序列值。

<a id="view-and-assess-data-quality" />

### 查看和评估数据质量

如果时间序列的数据质量不确定，则图表线会被阴影覆盖；如果质量较差，则会有间隙。
使用数据分析来评估时间序列的质量以及它是否适合您的目的。数据分析使用 [Industrial Data Science Library (InDSL)](https://indsl.docs.cognite.com/) 来定义间隙，如果时间间隔偏离四分位数范围的 1.5 倍以上。
在图表中，选择数据分析。在源下拉列表中选择您要评估的时间序列。
在箱线图和时间间隔或密度的直方图之间切换。

<a id="set-thresholds-for-historical-data" />

### 选择历史数据的阈值

要为历史数据设置阈值：
在图表的右上角，选择阈值图标。
在面板中，为时间序列和计算设置阈值。

<a id="add-events" />

### 添加事件

您可以添加事件，例如故障关闭，以帮助分析时间序列。
向图表中添加事件：
从侧边栏选择事件。
添加或选择过滤器以指定要添加的事件。

<a id="add-activities" />

### 添加活动

Cognite Data Fusion (CDF) 中的活动代表在您的工业环境中发生的一段时间内的任务、事件或操作。它们提供了一种结构化的方式来跟踪工作、维护、检查和其他基于时间的活动，将计划和执行的工作与您的物理资产和运营数据连接起来。
打开 **活动** 以在图表中可视化和上下文化这些操作事件的时间序列数据。活动在图表中以垂直条形的形式出现，提供视觉参考，帮助您将时间序列行为与相关的操作活动（如维护工作、检查或生产事件）关联起来。

#### 前提条件

在您将活动添加到图表之前，请确保：

* 相关数据被建模为 [活动或扩展活动在您的 CDF 项目中](/cdf/dm/dm_reference/dm_core_data_model#cogniteactivity)。
* 您拥有时间序列 `读取` 访问权限，以查看图表和相关数据。
  要将活动添加到图表：

<Steps>
  <Step title="添加时间序列">
    选择 **+ 添加数据** > **添加时间序列**。搜索并选择您想要可视化的时间序列。
  </Step>

  <Step title="选择活动">
    在类别下拉菜单中，选择 **活动**，然后选择您想要可视化的活动。一旦选择，**活动** 层将自动开启。

    <Note>
      **资产** 过滤器会根据图表中资产所属的时间序列自动应用。您可以根据自己的偏好清除或添加过滤器。
    </Note>
  </Step>
</Steps>

活动在 **活动** 层上以垂直蓝条的形式出现。这些条形帮助您在选定的时间范围内将时间序列与相关活动进行可视化关联。这些条形具有不同的透明度，以区分重叠的活动。

要处理活动：

<Steps>
  <Step title="查看活动详情">
    点击活动条以查看详细信息，例如开始和结束时间、描述以及与活动相关的资产。点击 **查看详细信息** 以查看活动的完整信息。
  </Step>

  <Step title="固定一个活动">
    点击图钉图标 <Icon icon="pin" /> 以在与其他活动进行比较时保持活动高亮显示。
  </Step>
</Steps>

<a id="monitor-time-series" />

## 监测时间序列

时间序列监控作业会发送 [您设置的阈值](/cdf/configure/charts_monitoring) 任何违规的电子邮件。如果在 *最小持续时间* 内发生多次违规，您只会收到该期间的一封电子邮件。

我们建议您设置至少 5 分钟的持续时间，以限制您收到的电子邮件警报数量。预期的最小数据点频率为 1 分钟。如果数据点的频率较低，警报可能不会按预期触发。

<a id="create-monitoring-jobs" />

### 创建监控作业

<Steps>
  <Step title="打开监控">
    从侧边栏选择 **监控** > **创建**。
  </Step>

  <Step title="命名工作">
    给监控作业一个 **名称**。
  </Step>

  <Step title="选择来源">
    在 **源** 下拉菜单中选择您想要监控的时间序列或计算。
  </Step>

  <Step title="设置阈值和持续时间">
    指定警报的 **阈值** 和 **最小持续时间**。
  </Step>

  <Step title="指定存储文件夹">
    指定存储警报的文件夹。
  </Step>

  <Step title="选择接收者">
    选择将接收电子邮件警报的用户。
  </Step>

  <Step title="可选。配置高级选项">
    打开 **高级选项** 并指定监控作业的登录凭据。
  </Step>

  <Step title="开始监测">
    选择 **开始监控**。
  </Step>
</Steps>

<a id="subscribe-to-alerts" />

### 订阅警报

要 **订阅** 警报：

<Steps>
  <Step title="打开监控">
    从侧边栏选择 **监控**。
  </Step>

  <Step title="订阅警报">
    找到您想要订阅的警报并选择 <Icon icon="bell" />。
  </Step>
</Steps>

<a id="resolve-alerts" />

### 解决警报

要**解决**您已调查的警报：

<Steps>
  <Step title="打开警报历史">
    选择警报 > **历史**。
  </Step>

  <Step title="标记为已解决">
    选择 **活动** > **标记为已解决**。
  </Step>
</Steps>

<a id="data-aggregation" />

## 数据聚合

如果图表包含超过100,000个数据点，图表会对数据点进行汇总，以便更容易查看数据。聚合的数据被阴影处理，并显示聚合数据范围的最小值和最大值。放大以查看单个数据点。