最后的润色
manifest 文件的提示
配置选项的描述应尽可能简短。
请记住只保留有关配置选项的有意义的信息。
- 好的候选者:对产品配置的引用、接受的字符串值、解释。
- 不好的候选者:从 A、B、C、D,… X、Y、Z 数据集中收集指标。
描述应该是人类可读的。
尝试重新措辞诸如:收集 foo_Bar3 指标,变成收集 Foo Bar 指标。
描述应该易于理解。
简化句子,如果不需要,不要提供关于输入的信息。
- 不好的候选者:收集应用程序日志(日志输入)
- 好的候选者:收集应用程序日志,收集应用程序的标准日志
集成图标显示在 Kibana 中的不同位置,因此最好定义自定义图标,使 UI 更易于导航。
Kibana 集成管理器显示与集成相关的屏幕截图。屏幕截图包括可视化指标和日志数据的 Kibana 仪表板。
README 模板用于呈现最终的 README 文件,包括导出的字段。 该模板应放置在 package/<integration-name>/_dev/build/docs/README.md
中。 如果目录不存在,请创建它。
要了解如何使用模板函数,例如 {{fields "data-stream-name"}},请查看 MySQL 文档模板。 如果在指标和日志中使用相同的数据流名称,请在模板中添加 -metrics 和 -logs。 例如,ELB 是日志的数据流,也是指标的数据流。 在 README.md 模板中,{{fields "elb_logs"}} 和 {{fields "elb_metrics"}} 用于分隔它们。
变量属性自定义 Kibana UI 中配置选项的可视化。 确保它们已在所有 manifest 文件中定义。
vars:
- name: paths
required: true
show_user: true
title: Access log paths
description: Paths to the apache access log file.
type: text
multi: true
hide_in_deployment_modes:
- agentless
default:
- /var/log/httpd/access.log*
- 选项是必需的
- 不要隐藏配置选项(折叠菜单)
- 人类可读的变量名
- 变量描述(可能包含一些细节)
- 字段类型(根据参考:text、password、bool、integer)
- 该字段有多个值
- 在无代理模式下隐藏变量(有关更多信息,请参阅
hide_in_deployment_modes
)