

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# K 线图
<a name="v10-panels-candlestick"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
有关支持 Grafana 版本 12.x 的 Grafana 工作空间，请参阅。[在 Grafana 版本 12 中工作](using-grafana-v12.md)  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

通过 K 线图可视化，您可以可视化包含多个一致维度的数据（侧重于价格走势）。Kandlestick 面板包括 Open-High-Low-Close (OHLC) 模式，并支持基于时间序列数据的其他维度。

![显示 Grafana 中 K 线图可视化示例的图像。](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


K 线图可视化建立在 [时间序列](v10-panels-time-series.md) 的基础之上，包含许多常用的配置设置。

## Mode
<a name="v10-panels-candlestick-mode"></a>

您可以使用模式选项切换用于可视化的维度。
+ **K 线图**：将面板维度限制为 K 线图可视化使用的开盘、高点、低点和收盘维度。
+ **成交量**：将面板维度限制为成交量维度。
+ **二者**：是 K 线图面板的默认行为。包括 K 线图和成交量可视化。

## 蜡烛样式
<a name="v10-panels-candlestick-style"></a>
+ **K 线图**：默认的显示样式，可在开盘和收盘维度之间创建蜡烛样式的可视化效果。
+ **OHLC 条形图**：显示四个核心维度的开盘值、高点值、低点值和收盘值。

## 颜色策略
<a name="v10-panels-candlestick-color"></a>
+ **开盘以来**：默认行为。如果期间内价格变动为正值，该模式将使用*上涨*颜色。换句话说，如果收盘时的值大于或等于开盘时的值，则使用*上涨*颜色。
+ **上次收盘以来**：另一种显示方法，蜡烛的颜色取决于期间内的价格走势或价值变化。换句话说，如果开盘值大于收盘值，则使用*上涨*颜色。如果开盘值小于收盘值，则使用*下跌*颜色。*该选项还会触发空心 K 线图可视化模式*。空心表示周期内的变动为正值（收盘时的值高于开盘时的值），实心表示周期内的变动为负值（收盘时的值低于开盘时的值）。要了解更多信息，请参阅[差异说明](https://thetradingbible.com/how-to-read-hollow-candlesticks)。

## 上涨和下跌颜色
<a name="v10-panels-candlestick-updown"></a>

**上涨颜色**和**下跌颜色**选项用于选择价格上涨或下跌时使用的颜色。上述*颜色策略*将决定是使用周期内还是周期间的价格变动来选择 K 线图或 OHLC 条形图的颜色。

## 开盘、高点、低点、收盘
<a name="v10-panels-candlestick-ohlc"></a>

K 线图面板会尝试将字段映射到相应的维度。
+ **开盘**对应给定周期的起始值。
+ **高点**对应给定周期的最高值。
+ **低点**对应给定周期的最低值。
+ **收盘**对应给定周期的最终（结束）值。
+ **成交量**对应给定周期内的样本数（例如交易次数）

**注意**  
K 线图例不显示这些值。

要正确映射这些维度，数据中的查询结果表必须*至少*包含以下列。
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

如果由于某种原因（例如，因为列名称不同），您的数据无法映射到这些维度，您可以使用面板编辑器中 **K 线图**选项下的**开盘值**、**高点值**、**低点值**和**收盘值**字段手动映射。

## 其他字段
<a name="v10-panels-candlestick-other"></a>

**其他字段**

K 线面板基于时间序列可视化。除了开盘值、高点值、低点值、收盘值和交易量之外，还可以可视化其他数据维度。**Include** 和 **Ignore** 选项允许面板使用 [时间序列](v10-panels-time-series.md) 中可用的相同样式和配置来可视化其他包含的数据，如简单移动平均线、布林线等。