直方图¶

直方图，又称质量分布图，用于表示数据的分布情况，是一种常见的统计图表，一般用横轴表示数据区间，纵轴表示分布情况，图表形状类似柱状图，柱子越高，则落在该区间的数量越大。

应用场景¶

观测云的直方图用于显示某个指标数据在一段时间内的数据分布走向。可用于以下场景：

查看应用性能指标数据在一定时间范围内的分布情况，如在最近 15 分钟内“请求数”的分布情况；
查看用户访问指标数据在一定时间范围内的分布情况，如在最近 15 分钟内“错误数”的分布情况；
其他日志类数据中 number 类型数据的分布情况。

图表查询¶

图表查询支持简单查询、表达式查询和 PromQL 查询；默认添加简单查询。

更多图表查询条件详细说明，可参考图表查询。

注意：直方图仅支持日志类数据，可用于表示 ES 存储 number 类型数据的分布情况，包括"日志"、"基础对象"、"自定义对象"、"事件"、"应用性能"、"用户访问"、"安全巡检"、"网络"、"profile"的数据查询；若工作空间为 SLS 存储，则数据查询报错。

更多存储说明，可参考数据存储策略。

图表链接¶

链接可以帮助您实现从当前图表跳转至目标页面；可添加平台内部链接和外部链接；还可通过模板变量修改链接中对应的变量值将数据信息传送过去，完成数据联动。

更多相关设置说明，可参考图表链接。

事件关联¶

通过添加筛选字段匹配与选定字段相关的异常事件，从而达到时序数据与事件关联显示的目的。这个功能可以帮助用户在查看趋势的同时，感知数据波动期间是否有相关事件产生，以帮助用户从另一个视角定位问题。

更多相关设置说明，可参考事件关联。

常用配置¶

选项	说明
标题	为图表设置标题名称，设置完成后，在图表的左上方显示，支持隐藏。
描述	为图表添加描述信息，设置后图表标题后方会出现【i】的提示，不设置则不显示。
单位	默认单位显示：若查询的数据为指标数据，且您在指标管理中为指标设置了单位，则默认按照指标的单位进行进位显示；若您在指标管理内无相关单位配置，则按照千分位逗号间隔的数值进位方式显示。配置单位后：优先使用您自定义配置的单位进行进位显示，指标类数据支持针对数值提供两种选项：科学计数说明默认进位：单位为万、百万，如10000 展示为 1 万，1000000 展示为 1 百万。保留两位小数点；短级差制：单位为 K, M, B。即以 thousand、million、billion、trillion 等依次表示中文语境下的千、百万、十亿、万亿等。如 1000 为 1 k，10000 为 10 k，1000000 为 1 million；保留两位小数点。
颜色	设置图表数据的显示颜色，支持自定义手动输入预设颜色，输入格式为：聚合函数(指标){"标签": "标签值"}，如 `last(usage_idle){"host": "guance_01"}`。
图例	可选择底部、右侧、隐藏图例（点击图例中的指标行，可隐藏/显示对应指标）；图例值包含 min、max、p50、p75、p90、p99。
数据格式	您可以选择【小数位数】以及【千分位分隔符】。千位分隔符默认开启，关闭后将显示原始值，无分隔符。更多详情，可参考数据千分位格式。
百分位数	查询数据时默认在直方图的分布位置显示 p50 、 p75、p90、p99 ，以竖线定位，帮助更直观的查看数据分布情况。

高级配置¶

选项	说明
锁定时间	支持锁定图表查询数据的时间范围，不受全局时间组件的限制。设置成功后的图表右上角会出现用户设定的时间，如【xx分钟】、【xx小时】、【xx天】。如锁定时间间隔30分钟，那么当调节时间组件无论查询什么时间范围视图，仍只会显示最近 30 分钟数据。
时间分片	开启时间分片后，会先对原始数据按照一定的时间间隔进行分段聚合，再对聚合后数据集进行第二次聚合得到结果值，默认关闭。若时间分片关闭，无时间间隔选项；若时间分片开启，时间间隔选项如下：原始间隔：根据时间组件的时间范围默认查询显示数据；自动对齐：开启后，将按选择的时间范围和聚合时间间隔动态的调整查询，根据计算的时间间隔就近向上取整。（例如：自动聚合算法计算出时间间隔是 50 秒，那么实际将按照 1 分钟的时间间隔发起查询）系统预设了多种时间间隔：1毫秒、10毫秒、50毫秒、100毫秒、500毫秒、1秒、5秒、15秒、30秒、1分钟、5分钟，10分钟、30分钟、1小时，6小时，12小时、1天、1周、1月；自定义时间间隔：当选择【锁定时间】时，根据锁定时间的长短，自动匹配不同的可选时间间隔查询显示数据。（例如：时间间隔选择 1 分钟，那么实际将按照 1 分钟的时间间隔发起查询）更多详情，可参考时间分片说明。
字段映射	配合视图变量的对象映射功能，默认为关闭，若在视图变量已配置对象映射：开启字段映射时，图表显示查询的分组字段和对应的映射字段，未指定映射的分组字段不显示；关闭字段映射时，图表正常显示，不显示映射的字段。
空间授权	被授权的工作空间列表，选择后即可通过图表查询并展示该工作空间数据。