重要:这个文档是关于一个旧版本。有关只释放指出,许多特性和功能的更新或替换。请查看当前版本。

设置图像渲染

Grafana支持自动渲染面板为PNG图像。这允许Grafana自动生成的图片你的面板包含在提醒通知,PDF导出,报告。PDF导出和报告只提供Grafana企业。

注意:不支持图像渲染的仪表板。

当一个图像被呈现,PNG图像暂时写入到文件系统中。图像呈现时,PNG图像是暂时写到png在Grafana文件夹数据文件夹中。

后台作业运行每10分钟和删除临时图像。您可以配置图像应该存储多久才能被配置删除temp_data_lifetime设置。

你也可以呈现一个PNG通过单击下拉箭头旁边一个面板标题,然后点击分享>渲染的图像直接联系。

报警和渲染限制

警报通知可以包括图片,但呈现许多图像同时渲染器可以超载服务器正在运行。说明如何配置,请参阅concurrent_render_limit。

安装Grafana图像渲染器插件

注意:从Grafana或,所有PhantomJS支持被移除。请使用Grafana图像渲染器渲染插件或远程服务。

安装插件,请参考Grafana图像渲染器安装说明。

配置

Grafana图像渲染器插件的配置选项,用于插件或远程渲染模式。

在插件模式中,您可以指定他们直接Grafana配置文件。

在远程渲染模式下,您可以指定它们. json配置文件或者,对于其中一些,您可以覆盖默认的配置使用环境变量。

配置文件

您可以更新您的设置通过使用一个配置文件,看看default.json为缺省值。请注意任何配置环境变量优先于配置文件设置。

你可以卷挂载您的自定义配置文件启动码头工人容器时:

码头工人运行- d - name =渲染器网络主机- v = /一些/道路/ json: / usr / src / app / config。json grafana / grafana-image-renderer:最新

你可以看到一个docker-compose示例使用一个自定义配置文件在这里。

呈现模式

您可以指导如何无头浏览器配置呈现模式创建的实例。默认是默认的,其他受支持的值集群和可重用的。

默认的

默认模式将在每个请求创建一个新的浏览器实例。处理多个并发请求时,这种模式增加了内存的使用,因为它将推出多个浏览器在同一时间。如果你想设置一个最大数量的浏览器打开,你将需要使用集群模式。

注意:当使用默认的模式,建议不要删除默认铬国旗——disable-gpu。当收到大量的并发请求,而不是使用这个标志可以导致操纵木偶的人newPage功能冻结,导致请求超时和离开浏览器打开。

RENDERING_MODE =违约

{“渲染”:{“模式”:“默认”}}

集群

与集群模式中,您可以配置多少浏览器实例或隐身页面可以并发执行。默认是浏览器和将确保最大程度的浏览器实例可以并发执行。模式上下文将确保最大程度的隐身页面可以并发执行。您还可以配置允许的最大并发数,默认5呈现请求的最大持续时间,每违约30.秒。

使用集群的隐身页面性能和消耗更少的CPU和内存超过一个集群的浏览器。然而,如果一个页面可以降低整个浏览器崩溃(使所有呈现请求同时发生失败)。同时,每个页面不保证完全干净(饼干和存储可能被击穿在这里)。

浏览器RENDERING_CLUSTERING_MAX_CONCURRENCY RENDERING_MODE =集群RENDERING_CLUSTERING_MODE = = 5 RENDERING_CLUSTERING_TIMEOUT = 30

{“渲染”:{“模式”:“集群”,“集群”:{“模式”:“浏览器”、“maxConcurrency”: 5“超时”:30}}}

集群模式contextPerRenderKey(实验)

注意:这个特性在图像渲染器v3.4.0和后来的版本可用。

在contextPerRenderKey模式下,插件将重用相同的浏览器环境所有呈现请求共享相同的renderKey身份验证cookie和目标域在很短的时间内窗口。每一个新的请求将打开一个新页面内现有的上下文。上下文后自动关闭5 s活动。

在的情况下contextPerRenderKey模式下,clustering.max_concurrency选择是指开放背景下的数量,而不是打开的页面的数量。没有办法限制打开的页面的数量在一个上下文。

contextPerRenderKey旨在改善的性能仪表板预览履带。

{“渲染”:{“模式”:“集群”,“集群”:{“模式”:“contextPerRenderKey”、“maxConcurrency”: 5“超时”:30}}}

可重用(实验)

当使用渲染模式可重用的,一个浏览器实例将创建和重用。一个新的隐身页面将为每个请求被打开。这种模式是实验以来,如果浏览器实例崩溃了,它不会自动重新启动。使用可以达到类似的行为集群高的模式maxConcurrency设置。

RENDERING_MODE =可重用

{“渲染”:{“模式”:“重用”}}

优化性能,图像渲染器的CPU和内存使用

不同模式的性能和资源消耗大量并发请求的数量取决于你的服务处理。了解有多少并发请求服务处理,监控你的形象渲染器服务。

没有并发请求,不同的模式显示性能和CPU /内存使用非常相似。

处理并发请求时,我们看到了以下趋势:

• 以提高性能和减少CPU和内存消耗,使用集群模式RENDERING_CLUSTERING_MODE设置为上下文。这对隐身页面而不是浏览器。
• 如果你使用集群模式与maxConcurrency设置低于你的平均数量的并发请求,性能将会下降,呈现请求需要等待其他完成之前获得一个隐身页面/浏览器。

为了实现更好的性能,监视你的服务正在运行的机器。如果你没有足够的CPU和/或内存,每个渲染步骤将会比平时慢,增加每个呈现请求的持续时间。

其他可用的设置

注意:请注意,并不是所有的设置都可以使用环境变量。如果没有使用环境变量的例子,这意味着你需要更新配置文件。

HTTP主机

改变听主持人的HTTP服务器。默认设置,将使用本地主机。

HTTP_HOST = localhost

{“服务”:{“主机”:“localhost”}}

HTTP端口

改变HTTP服务器的监听端口。默认是8081年。设置0会自动分配一个端口不能使用。

HTTP_PORT = 0

{“服务”:{“端口”:0}}

使普罗米修斯指标

您可以启用普罗米修斯度量端点/指标使用环境变量ENABLE_METRICS。节点。js和呈现请求持续时间指标包括,明白了输出示例获取详细信息。

默认是假。

ENABLE_METRICS = true

{"服务":{“指标”:{“启用”:真的,“collectDefaultMetrics”:真的,“requestDurationBuckets”: (1、5、7、9、11、13、15、20、30)}}}

日志级别

修改日志级别。默认是信息并与水平将包括日志消息错误,警告和信息。

LOG_LEVEL =调试

{"服务":{“日志记录”:{“级别”:“调试”,“控制台”:{“json”:假的,“彩色化”:真正}}}}

详细的日志

指导无头浏览器实例是否呈现图像时捕获和记录详细信息。默认是假和只会捕获和记录错误消息。当启用(真正的)调试消息捕获和记录。

注意,您需要修改日志级别调试见上图,详细信息包含在日志中。

RENDERING_VERBOSE_LOGGING = true

{“渲染”:{“verboseLogging”:真}}

捕获浏览器输出

指导无头浏览器实例是否调试和错误消息输出到运行远程渲染服务的过程。默认是假。这可用于启用(真正的当故障排除)。

RENDERING_DUMPIO = true

{“渲染”:{“dumpio”:真}}

定制的Chrome /铬

如果你已经有铬或铬安装在你的系统,那么您可以使用这个代替铬的预包装的版本。

注意:请注意,这是不可取的,因为您可能会遇到问题,如果安装版本的Chrome /铬与不兼容Grafana图像渲染器插件。

您需要确保Chrome /铬可执行可Grafana /图像渲染服务过程。

CHROME_BIN = " / usr / bin / chromium浏览器”

{“渲染”:{“chromeBin”:“/ usr / bin / chromium浏览器"}}

启动浏览器的附加参数

附加参数传递到无头浏览器实例。默认值是————disable-gpu no-sandbox。可以找到铬标记的列表在这里和标记的列表作为违约操纵木偶的人可以找到在那里。多个参数用逗号字符分开。

RENDERING_ARGS =——no-sandbox disable-setuid-sandbox,——————disable-gpu disable-accelerated-2d-canvas disable-dev-shm-usage——窗口大小= 1280 x758

{“渲染”:{“参数”:[”——no-sandbox”、”——disable-setuid-sandbox“、”——disable-dev-shm-usage”,“——disable-accelerated-2d-canvas”,“——disable-gpu”,“——窗口大小= 1280 x758”]}}

忽略HTTPS错误

指导无头浏览器实例是否忽略HTTPS错误在导航。默认HTTPS的错误不被忽视。由于安全风险并不是建议忽略HTTPS错误。

IGNORE_HTTPS_ERRORS = true

{“渲染”:{“ignoresHttpsErrors”:真}}

默认时区

指导无头浏览器实例时使用默认时区不是由Grafana, .e.g。当渲染面板警报的形象。看到ICU的metaZones.txt一个支持时区id列表。回退到TZ如果没有设置环境变量。

BROWSER_TZ =欧洲/斯德哥尔摩

{“渲染”:{“时区”:“欧洲/斯德哥尔摩"}}

默认的语言

指导无头浏览器实例时使用一个默认的语言没有提供Grafana,例如当渲染面板警报的形象。指HTTP头接收语言理解如何格式化这个值。

{“渲染”:{“acceptLanguage”:“fr-CH fr; q = 0.9, en; q = 0.8, de; q = 0.7 *; q = 0.5 "}}

视窗的宽度

没有指定默认窗口宽度时宽度呈现请求。默认是1000年。

{“渲染”:{“宽度”:1000}}

窗口的高度

没有指定默认窗口高度时高度呈现请求。默认是500年。

{“渲染”:{“高度”:500}}

视窗最大宽度

限制的最大窗口宽度,可以请求。默认是3000年。

{“渲染”:{“maxWidth”: 1000}}

视窗最大高度

限制最大窗口高度,可以请求。默认是3000年。

{“渲染”:{“maxHeight”: 500}}

设备比例因子

指定默认设备比例因子呈现图像。2足够的监控决议,bob彩票中奖计划4对印刷材料会更好。设定一个更高的价值影响性能和内存。默认是1。这可以覆盖在呈现请求。

{“渲染”:{“deviceScaleFactor”: 2}}

最大设备比例因子

限制最大设备比例因子,可以要求。默认是4。

{“渲染”:{“maxDeviceScaleFactor”: 4}}