Trino Grafana 数据源插件

Trino 数据源允许在 Grafana 中查询和可视化 Trino 数据。

快速入门

将此插件放入 Grafana 的 plugins 目录。如需在未安装 Grafana 的情况下在本地运行，请使用 Docker 容器运行

docker run -d -p 3000:3000 \
  -v "$(pwd):/var/lib/grafana/plugins/trino" \
  -e "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=trino-datasource" \
  --name=grafana \
  grafana/grafana-oss

功能

• 身份验证
  • HTTP 基本认证
  • TLS 客户端认证
  • 访问令牌 (JWT)
  • OAuth
• 仅限原始 SQL 编辑器，尚无查询构建器
• 宏

支持宏

插件支持以下宏

• $timeFrom($column) - 替换为当前选定“时间范围”的下边界时间戳。
• $timeTo($column) - 替换为当前选定“时间范围”的上边界时间戳。
• $timeGroup($column, $interval) - 替换为一个表达式，该表达式将列的值舍入到选定的“按时间间隔分组”值。
• $dateFilter($column) - 替换为当前选定“时间范围”的日期范围条件，应用于作为 $column 参数传递的列。在查询或查询变量中使用，例如 ...WHERE $dateFilter($column)... 或 ...WHERE $dateFilter(created_at)....。
• $timeFilter($column) - 替换为当前选定“时间范围”的时间戳范围条件，应用于作为 $column 参数传递的列。
• $unixEpochFilter($column) - 替换为当前选定“时间范围”的范围条件，应用于作为 $column 参数传递的列。
• $parseTime - 使用默认或指定格式解析时间戳字符串。

在原始编辑器中输入宏名称即可查看宏描述

模板化

在查询中使用变量

只有当模板变量是多值变量时，其值才会被引用。

如果变量是多值变量，则使用 IN 比较运算符而不是 = 来匹配多个值。

使用名为 hostname 的模板变量示例

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

禁用多值变量的引用

Grafana 会自动为多值变量创建带引号的逗号分隔字符串。例如：如果选择了 server01 和 server02，则会格式化为：'server01', 'server02'。要禁用引用，请对变量使用 csv 格式化选项

${servers:csv}

在《变量》文档中阅读更多关于变量格式化选项的信息。

贡献

如果您对改进有任何想法或发现错误，请随时提交 issue 或 pull request。我们将感谢社区的任何帮助。

开发

请参阅DEVELOPMENT.md 获取开发说明。

许可

Apache 2.0 许可证，详情请参阅LICENSE。